| name | template-skill |
| description | Replace with clear description of what the skill does and when Claude should use it. Be specific about the skill's purpose, capabilities, and ideal use cases. |
| version | 1.0.0 |
| license | MIT |
[Skill Name]
[Brief introduction explaining what this skill does and why it's useful]
Supporting Resources
- PROFILE.md - User-specific customization (voice, style, brand context)
- Master Briefing - Global brand voice at
~/.superskills/master-briefing.yaml
Note: If PROFILE.md doesn't exist, copy PROFILE.md.template to PROFILE.md and customize it.
Purpose
This skill helps you [primary objective]. Use it when you need to [specific scenarios].
Instructions
When activated, this skill will:
- [First action or capability]
- [Second action or capability]
- [Third action or capability]
Key Guidelines
- [Guideline Category 1]: [Specific guidance - e.g., "Voice and Tone: Match the user's brand voice from PROFILE.md"]
- [Guideline Category 2]: [Specific guidance - e.g., "Quality Standards: Ensure accuracy, clarity, and actionability"]
- [Guideline Category 3]: [Specific guidance - e.g., "Format: Use clear structure with headings and bullet points"]
Quality Standards
- [Standard 1 - e.g., "Accurate and fact-checked information"]
- [Standard 2 - e.g., "Clear, actionable guidance"]
- [Standard 3 - e.g., "Consistent with brand voice and style"]
- [Standard 4 - e.g., "Appropriate depth and detail for audience"]
Examples
Example 1: [Use Case Name]
Input: [Example input or request]
Expected Output: [Description of expected output or behavior]
Example:
[Show concrete example of output if applicable]
Example 2: [Use Case Name]
Input: [Example input or request]
Expected Output: [Description of expected output or behavior]
Example:
[Show concrete example of output if applicable]
Example 3: [Use Case Name - Edge Case or Advanced Usage]
Input: [Example input or request]
Expected Output: [Description of expected output or behavior]
Tools & Integrations
[If this skill uses Python tools, API integrations, or external services, document them here]
Required:
- [Tool/service 1 - e.g., "OpenAI API for text generation"]
- [Tool/service 2 - e.g., "Notion API for content storage"]
Optional:
- [Tool/service 3 - e.g., "ElevenLabs for voice synthesis"]
Configuration
[If the skill requires configuration, environment variables, or API keys, document setup here]
Environment Variables
SKILL_API_KEY=your_api_key_here
SKILL_CONFIG_OPTION=value
SKILL_ENDPOINT=https://api.example.com
Setup Instructions
- Copy
.env.template to .env in this skill directory
- Add your API credentials to
.env
- [Additional setup steps if needed]
- Verify setup with:
python scripts/validate_credentials.py
User Profile Integration
This skill integrates with two levels of personalization:
1. Master Briefing (Global)
Your Master Briefing at ~/.superskills/master-briefing.yaml provides global brand voice, audience, and frameworks shared across all skills.
Create one:
superskills call profile-builder "help me create my master briefing"
2. Skill Profile (Specific)
The PROFILE.md file in this directory provides skill-specific customization that overrides Master Briefing when conflicts exist.
Setup:
- Copy
PROFILE.md.template to PROFILE.md
- Fill in your information (name, role, voice characteristics, expertise)
- The skill will automatically match your brand voice and context
Priority: PROFILE.md (highest) > Master Briefing (global) > SKILL.md (baseline)
What the skill uses from your profile:
- [Element 1 - e.g., "Voice characteristics to match your writing style"]
- [Element 2 - e.g., "Expertise areas to tailor recommendations"]
- [Element 3 - e.g., "Example hooks to understand your communication patterns"]
Tips & Best Practices
- Tip 1: [Helpful usage tip - e.g., "Be specific in your requests - include target audience, tone, and desired length"]
- Tip 2: [Common pitfall to avoid - e.g., "Don't ask for generic content - reference your PROFILE.md for personalization"]
- Tip 3: [Best practice - e.g., "Review and edit outputs - AI is a co-creator, not a replacement"]
- Tip 4: [Optimization tip - e.g., "For complex requests, break into steps and iterate"]
Common Issues & Troubleshooting
Issue: [Common Problem]
Symptom: [What the user experiences]
Solution: [How to fix it]
Issue: [Common Problem]
Symptom: [What the user experiences]
Solution: [How to fix it]
Related Skills
Skills that work well together:
- [Related Skill 1]: [When to use instead/together - e.g., "Use researcher skill first to gather information, then this skill to synthesize"]
- [Related Skill 2]: [When to use instead/together - e.g., "Pair with editor skill for quality control"]
- [Related Skill 3]: [When to use instead/together]
Limitations
[Be honest about what this skill cannot do]
- [Limitation 1 - e.g., "Cannot access real-time data without API integration"]
- [Limitation 2 - e.g., "Requires manual review for factual accuracy"]
- [Limitation 3 - e.g., "Works best for [specific use case], less effective for [other use case]"]
Version History
Current Version: 1.0.0
- v1.0.0 - [Date] - Initial release
Credits & Attribution
[If this skill is based on external work, frameworks, or methodologies, provide attribution]
- Based on: [Framework/methodology name]
- Inspired by: [Person/organization]
- License: [License type - e.g., MIT, Apache 2.0]
Support & Feedback
- Issues: Report bugs or request features at [GitHub issues link]
- Documentation: [Link to extended documentation if available]
- Community: [Link to discussions or community forum]
