Skill Name
Note: This document is mainly for agents and LLMs to follow when [condition for skill usage]. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows.
Abstract
Brief summary of what this skill provides and how it's organized. Explain that each rule includes one-line summaries with links to detailed examples in the references/ folder.
Token efficiency principle: This guide maximizes knowledge delta by providing only expert-level insights Claude doesn't already know. All rules assume Claude understands standard concepts, libraries, and patterns. Focus is on non-obvious decisions, trade-offs, and edge cases.
How to Use This Guide
- Start here: Scan the rule summaries to identify relevant guidance
- Load references as needed: Click through to detailed examples only when implementing
- Progressive loading: Each reference file is self-contained with ❌/✅ examples
This structure minimizes context usage while providing complete implementation guidance when needed.
Quick Reference
<!-- Add all rule sections here with brief summaries. This TOC is critical for agents to quickly find relevant rules without loading all references. Each entry should be 5-10 words max. -->- 1.1 Rule Name - Brief description (5-10 words)
- 1.2 Rule Name - Brief description (5-10 words)
- 1.3 Rule Name - Brief description (5-10 words)
1. General
<!-- For simple skills: 3-5 rules may be sufficient For complex skills: Consider grouping into multiple sections: ## 1. General ## 2. Specific Domain Area ## 3. Advanced Patterns -->1.1 Rule Name
One-line summary of this rule (what it optimizes or prevents). View detailed examples
1.2 Rule Name
One-line summary of this rule (what it optimizes or prevents). View detailed examples
1.3 Rule Name
One-line summary of this rule (what it optimizes or prevents). View detailed examples
<!-- ADVANCED PATTERNS (uncomment if needed): ### 1.4 Cross-Referencing Other Skills When your skill depends on another skill, reference it explicitly: [View detailed examples](references/cross-references.md) Example inline guidance (for rules that don't need full reference file): ### 1.5 Short Rule Without Reference File Brief rule that fits in 2-3 sentences. For rules that need ❌/✅ examples or detailed explanation, create a reference file instead. Only inline rules that are self-explanatory. **❌ Incorrect: [description of why]** ``` Brief example of anti-pattern ``` **✅ Correct: [description of why]** ``` Brief example of correct pattern ``` TOKEN EFFICIENCY TIP: - If a rule has 3+ examples, move to reference file - If explanation is >5 lines, move to reference file - Inline only simple, obvious rules -->