your-skill-name-here

name: your-skill-name-here description: "What this skill does with action verbs. Use when [scenario 1], [scenario 2], or when user mentions [keywords]. Max 1024 chars. This IS the triggering mechanism." Triggers: keyword1, keyword2, keyword3, exact user phrase, natural language variant user-invocable: false model: haiku # Optional: haiku (cheap/fast) | sonnet (balanced) | opus (complex) | (default: inherit session) allowed-tools: [Read, Grep, Glob] # Optional: Restrict tool access for safety/efficiency

disable-model-invocation: true # Uncomment to prevent auto-activation (user-only via /command)

argument-hint: "[environment]" # Uncomment if user-invocable: true (shows usage hint)

Skill Name Here

Purpose: [One-sentence purpose] Created: [YYYY-MM-DD] ROI: [X hours/year saved]

User Parameters (For User-Invocable Skills Only)

If this skill has user-invocable: true and argument-hint: "[environment]" in frontmatter:

Deploy to $ARGUMENTS environment:

1. Validate $ARGUMENTS configuration exists
2. Run tests for $ARGUMENTS
3. Build assets for $ARGUMENTS
4. Deploy to $ARGUMENTS

Supported environments:

- development ($ARGUMENTS = "development")
- staging ($ARGUMENTS = "staging")
- production ($ARGUMENTS = "production")

Multiple arguments (use positional indexing):

Create feature $ARGUMENTS[0] in module $ARGUMENTS[1]:

User types: `/create-feature auth-system users`
→ $ARGUMENTS[0] = "auth-system"
→ $ARGUMENTS[1] = "users"

Delete this section if skill is NOT user-invocable.

Usage Scenarios

CRITICAL: Use numbered triggers - this achieves 84% activation rate (vs 20% without)

(1) When encountering "[exact error message or pattern]"

• Example: "ECONNREFUSED on port 5432"
• Example: "authentication failed for user X"
• Be SPECIFIC - include error codes, numbers, exact text

(2) When debugging [specific scenario with measurable criteria]"

• Example: "API response time > 5 seconds"
• Example: "Test coverage < 80%"
• Include thresholds and concrete values

(3) When seeing [observable pattern or metric]"

• Example: "More than 3 merge conflicts"
• Example: "Build time exceeds 2 minutes"
• Be concrete and measurable

Failed Attempts

CRITICAL: This section prevents repeating mistakes - always include it!

Example:

Quick Start (< 5 min)

Target: User should get value in under 5 minutes

Step 1: [First Action]

# Concrete command or code example
[command here]

Expected Output: [What you should see]

Step 2: [Second Action]

# Next step
[command or code here]

Validation: [How to verify it worked]

Step 3: [Third Action]

# Final step
[command or code here]

Success: [What success looks like]

Detailed Procedure (For Complex Skills)

Prerequisites

• [What must be installed/configured]
• [What knowledge is required]
• [What files/data are needed]

Implementation

Option A: [Approach Name]

WHEN_TO_USE: "[Specific conditions]"
STEPS: 1. [Detailed step 1]
  2. [Detailed step 2]
  3. [Detailed step 3]

CODE_EXAMPLE: |
  [Actual code that works]

VALIDATION: |
  [How to verify success]

Option B: [Alternative Approach] (if applicable)

WHEN_TO_USE: "[Different conditions]"
TRADE_OFFS: "[Why choose this over Option A]"

Troubleshooting

If X happens:

• Check: [What to check]
• Fix: [How to fix it]
• Prevent: [How to avoid in future]

If Y happens:

• Check: [What to check]
• Fix: [How to fix it]

Evidence

CRITICAL: Include concrete numbers and dates - this builds trust and helps with activation

Created: YYYY-MM-DD Source: [Where this pattern came from - project, research, documentation] Tests Run: [X/Y] (success rate %) Success Rate: [X%] (measured across N uses) Time Savings: [X min/hours] per use (vs alternative approach) Usage Frequency: [How often this pattern is needed] ROI: [Hours saved per year] (if applicable)

Example:

• Created: 2025-12-14
• Tests: 15/15 (100%)
• Success Rate: 95% across 20 uses
• Time Saved: 15 min per use (vs manual debugging)
• Usage: 20 times/year
• ROI: 5 hours/year saved

Integration

Works With (list related skills, tools, patterns):

• [Skill name] - [How they work together]
• [Pattern from CORE-PATTERNS.md] - [Relationship]
• [MCP tool] - [Integration point]

Requires (dependencies):

• [Skill X] must be set up first
• [Tool Y] must be installed
• [Pattern Z] must be in CORE-PATTERNS.md

Follow-Up Skills (what to use after this):

• [Next skill] - [When to use it]
• [Related skill] - [Sequential workflow]

Success Criteria

You've mastered this skill when:

• [Specific measurable criterion]
• [Another measurable outcome]
• [Third concrete success indicator]

Example:

• Can resolve connection errors in < 5 min
• Know validation commands by heart
• Have used successfully 3+ times

Notes

Additional Context:

• [Any special considerations]
• [Known limitations]
• [Future improvements planned]

Last Updated: YYYY-MM-DD Version: 1.0