Skip to content

SKILL_TEMPLATE.md

Latest commit

 

History

History
145 lines (91 loc) · 2.76 KB

SKILL_TEMPLATE.md

File metadata and controls

145 lines (91 loc) · 2.76 KB
name skill-name-here
description Short description of what this skill does (<=200 chars)
type component | interactive | workflow
domain discovery | strategy | planning | specification | execution | launch | growth | analytics | communication | leadership
difficulty beginner | intermediate | advanced
estimated_time 10-30 min
prerequisites
outputs
artifact-name
triggers
phrase that should activate this skill
another trigger phrase

Purpose

[1-3 sentences: What this skill does, when to use it, and what outcome it produces.]

[Optional: What this skill is NOT — clarify scope boundaries.]

Key Concepts

[Core Framework Name]

[Describe the framework, model, or method. Include visual diagrams where helpful.]

Why This Works

  • [Reason 1]
  • [Reason 2]
  • [Reason 3]

Anti-Patterns (What This Is NOT)

  • Not [X]: [Why this doesn't apply]
  • Not [Y]: [Why this doesn't apply]

When to Use This

  • [Scenario 1]
  • [Scenario 2]
  • [Scenario 3]

When NOT to Use This

  • [Scenario 1 — and what to use instead]
  • [Scenario 2 — and what to use instead]

Application

Step 1: [Action Name]

[Instructions with quality checks built in.]

[Template or format to fill in]

Quality check:

  • [Verification question 1]
  • [Verification question 2]

Step 2: [Action Name]

[Continue with remaining steps...]

Examples

✅ Good Example

[Complete good example with annotations]

Why this works: [Explain what makes it good]

❌ Bad Example

[Complete bad example with annotations]

Why this fails: [Explain what's wrong and how to fix it]

Quality Rubric

Score each dimension 0-2 (0 = missing, 1 = partial, 2 = excellent). Target: 8+ out of 10.

Dimension 0 (Missing) 1 (Partial) 2 (Excellent)
[Dimension 1] [Bad] [OK] [Great]
[Dimension 2] [Bad] [OK] [Great]
[Dimension 3] [Bad] [OK] [Great]
[Dimension 4] [Bad] [OK] [Great]
[Dimension 5] [Bad] [OK] [Great]

If score < 8: Revise the weakest dimension before finalizing.

Common Pitfalls

Pitfall 1: [Name]

Symptom: [What you'll see when this happens]

Consequence: [Why it's bad]

Fix: [How to avoid or correct it]

Pitfall 2: [Name]

Symptom: [What you'll see]

Consequence: [Why it's bad]

Fix: [How to avoid or correct it]

References

Related Skills

  • skills/<domain>/<skill>/SKILL.md — [How it relates]

External Frameworks

  • [Framework Name] — [Brief description and source]

Skill type: [component | interactive | workflow] Domain: [domain name] Prerequisites: [list or "None"]