michsindlinger/specwright/templates/skills/generic-skill

Generic Skill Template

Skill: [SKILL_NAME] Role: [AGENT_ROLE] Created: [DATE] Version: 1.0.0

Purpose

[Clear description of what this skill enables the agent to do]

When to Activate This Skill

Trigger Conditions:

• [Condition 1]
• [Condition 2]
• [Condition 3]

Context Signals:

• "[Keyword or phrase that indicates need]"
• "[File pattern or code pattern]"
• "[User request pattern]"

Core Capabilities

1. [Capability Name]

[What this capability does]

Specific actions:

• [Action 1]
• [Action 2]
• [Action 3]

2. [Capability Name]

[What this capability does]

Specific actions:

• [Action 1]
• [Action 2]

3. [Capability Name]

[What this capability does]

Specific actions:

• [Action 1]
• [Action 2]

[TECH_STACK_SPECIFIC] Best Practices

[TECH_STACK_SPECIFIC]

Framework/Library Patterns

For [FRAMEWORK/LIBRARY_NAME]:

• Pattern 1: [Description and code example]
• Pattern 2: [Description and code example]
• Pattern 3: [Description and code example]

Common Patterns

• Error Handling: [How to handle errors in this domain]
• Testing: [How to test this functionality]
• Performance: [Performance considerations]
• Security: [Security best practices]

Anti-Patterns to Avoid

• [Anti-pattern 1] - [Why to avoid]
• [Anti-pattern 2] - [Why to avoid]

Tools Required

MCP Servers

[MCP_TOOLS]

<!-- Populated during skill creation based on: 1. User's installed MCP servers 2. User's selection for this skill Recommended for this skill (examples): - [MCP tool suggestions based on skill domain] Note: Skills work without MCP servers, but functionality may be limited -->

Specwright Workflows

[WORKFLOW_TOOLS]

<!-- Optional: Related workflows or templates -->

External Tools (Optional)

• [Tool 1] - [Purpose]
• [Tool 2] - [Purpose]

Quality Checklist

When using this skill, ensure:

• [ ] [Quality criterion 1]
• [ ] [Quality criterion 2]
• [ ] [Quality criterion 3]
• [ ] [Quality criterion 4]
• [ ] [Quality criterion 5]

Integration with Other Skills

Works Closely With

• [Related Skill 1] - [How they collaborate]
• [Related Skill 2] - [How they collaborate]

Provides Input To

• [Who benefits from this skill's output]

Receives Input From

• [What this skill depends on]

Examples

Example 1: [Scenario Name]

Scenario: [Description]

Approach:

[Code example or step-by-step approach]

Example 2: [Scenario Name]

Scenario: [Description]

Approach:

[Code example or step-by-step approach]

Skill Activation Flow

1. DETECT: [Trigger condition]
2. ANALYZE: [What to analyze]
3. PLAN: [Planning step]
4. EXECUTE: [Implementation]
5. VERIFY: [Verification]
6. DOCUMENT: [Documentation]

Success Metrics

• [Metric 1]
• [Metric 2]
• [Metric 3]

Notes

• [Important note 1]
• [Important note 2]
• [Important note 3]

---

Template Usage Instructions:

This generic template should be used when:

1. Standard skill templates don't cover the needed capability
2. Highly specialized domain knowledge required (blockchain, ML, IoT, etc.)
3. Project-specific patterns need to be captured

Customization:

• Replace all [PLACEHOLDERS] with actual content
• Fill [TECH_STACK_SPECIFIC] with relevant framework patterns
• Add domain-specific examples
• Specify relevant tools and integrations