template-skill

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:

1. [First action or capability]
2. [Second action or capability]
3. [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

# Example .env configuration
SKILL_API_KEY=your_api_key_here
SKILL_CONFIG_OPTION=value
SKILL_ENDPOINT=https://api.example.com

Setup Instructions

1. Copy .env.template to .env in this skill directory
2. Add your API credentials to .env
3. [Additional setup steps if needed]
4. 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:

1. Copy PROFILE.md.template to PROFILE.md
2. Fill in your information (name, role, voice characteristics, expertise)
3. 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
  • [Feature 1]
  • [Feature 2]

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]