minimal-skill

# Minimal Skill Example This is the simplest possible OpenCode skill structure. ## What This Demonstrates A minimal skill consists of: - A single `SKILL.md` file - YAML frontmatter with `name` and `description` - Markdown content explaining the skill No additional resources (references/, examples/, scripts/) are required. ## When to Use Minimal Structure Use this structure when: - Skill provides simple knowledge or guidance - No detailed documentation needed - No code examples or scripts required - Content fits comfortably in 1,500-2,000 words ## Example Use Cases **Good for minimal skills**: - Quick reference guides - Simple conventions or standards - Brief workflows with few steps - Pointer skills that direct to external resources **Not good for minimal skills**: - Complex multi-step workflows → Use standard structure - Detailed API documentation → Use references/ - Code examples → Use examples/ - Utility scripts → Use scripts/ ## Structure ``` minimal-skill/ └── SKILL.md ``` That's it! Just one file. ## Content Guidelines Keep the content: - **Focused** - Cover one specific topic - **Concise** - 500-1,500 words - **Actionable** - Clear steps or guidance - **Self-contained** - Everything in this file ## Benefits **Advantages**: - Simple to create and maintain - Low context cost - Easy to understand - Quick to load **Limitations**: - Can't handle complex topics - No progressive disclosure within skill - Everything loads at once - Limited to ~2,000 words ## When to Upgrade Upgrade to standard structure (add references/) when: - Content exceeds 2,000 words - Need detailed documentation - Have multiple sub-topics - Want better progressive disclosure Upgrade to complete structure (add examples/ and scripts/) when: - Need working code examples - Have utility scripts - Require automation tools ## Summary Minimal skills are perfect for simple, focused guidance that fits in one file. They're easy to create, maintain, and use. For more complex needs, consider the standard or complete skill structures demonstrated in the other examples.