SKILL.md
{{SKILL_TITLE}}
{{ONELINEDESCRIPTION}}
⚠️ BEFORE YOU START
This skill prevents {{ERRORCOUNT}} common errors and saves ~{{TOKENSAVINGS}}% tokens.
| Metric | Without Skill | With Skill |
|---|---|---|
| Setup Time | {{MANUAL_TIME}} | {{SKILL_TIME}} |
| Common Errors | {{ERROR_COUNT}} | 0 |
| Token Usage | {{MANUAL_TOKENS}} | {{SKILL_TOKENS}} |
Known Issues This Skill Prevents
- {{PREVENTEDISSUE1}}
- {{PREVENTEDISSUE2}}
- {{PREVENTEDISSUE3}}
Quick Start
Step 1: {{FIRSTSTEPTITLE}}
{{FIRST_STEP_CODE}}
Why this matters: {{FIRSTSTEPEXPLANATION}}
Step 2: {{SECONDSTEPTITLE}}
{{SECOND_STEP_CODE}}
Why this matters: {{SECONDSTEPEXPLANATION}}
Step 3: {{THIRDSTEPTITLE}}
{{THIRD_STEP_CODE}}
Why this matters: {{THIRDSTEPEXPLANATION}}
Critical Rules
✅ Always Do
- ✅ {{DO_1}}
- ✅ {{DO_2}}
- ✅ {{DO_3}}
❌ Never Do
- ❌ {{DONT_1}}
- ❌ {{DONT_2}}
- ❌ {{DONT_3}}
Common Mistakes
❌ Wrong: ```{{LANG}} {{WRONG_CODE}}
**✅ Correct:**
```{{LANG}}
{{CORRECT_CODE}}
Why: {{EXPLANATION}}
Known Issues Prevention
| Issue | Root Cause | Solution |
|---|---|---|
| {{ISSUE_1}} | {{CAUSE_1}} | {{SOLUTION_1}} |
| {{ISSUE_2}} | {{CAUSE_2}} | {{SOLUTION_2}} |
| {{ISSUE_3}} | {{CAUSE_3}} | {{SOLUTION_3}} |
Configuration Reference
{{CONFIGFILENAME}}
```{{CONFIGFORMAT}} {{CONFIGEXAMPLE}}
**Key settings:**
- `{{SETTING_1}}`: {{SETTING_1_DESCRIPTION}}
- `{{SETTING_2}}`: {{SETTING_2_DESCRIPTION}}
## Common Patterns
### {{PATTERN_1_NAME}}
```{{PATTERN_1_LANGUAGE}}
{{PATTERN_1_CODE}}
{{PATTERN2NAME}}
```{{PATTERN2LANGUAGE}} {{PATTERN2CODE}}
## Bundled Resources
### Scripts
Located in `scripts/`:
- `{{SCRIPT_1}}` - {{SCRIPT_1_DESCRIPTION}}
### References
Located in `references/`:
- [`{{REFERENCE_1}}`](references/{{REFERENCE_1}}) - {{REFERENCE_1_DESCRIPTION}}
- [`{{REFERENCE_2}}`](references/{{REFERENCE_2}}) - {{REFERENCE_2_DESCRIPTION}}
> **Note:** For deep dives on specific topics, see the reference files above.
### Templates
Located in `assets/`:
- [`{{TEMPLATE_1}}`](assets/{{TEMPLATE_1}}) - {{TEMPLATE_1_DESCRIPTION}}
Copy these templates as starting points for your implementation.
## Dependencies
### Required
| Package | Version | Purpose |
|---------|---------|---------|
| {{PACKAGE_1}} | {{VERSION_1}} | {{PURPOSE_1}} |
### Optional
| Package | Version | Purpose |
|---------|---------|---------|
| {{OPT_PACKAGE_1}} | {{OPT_VERSION_1}} | {{OPT_PURPOSE_1}} |
## Official Documentation
- [{{DOC_1_NAME}}]({{DOC_1_URL}})
- [{{DOC_2_NAME}}]({{DOC_2_URL}})
## Troubleshooting
### {{PROBLEM_1}}
**Symptoms:** {{SYMPTOMS_1}}
**Solution:**
{{SOLUTIONCODE1}}
### {{PROBLEM_2}}
**Symptoms:** {{SYMPTOMS_2}}
**Solution:**
{{SOLUTIONCODE2}}
## Setup Checklist
Before using this skill, verify:
- [ ] {{CHECK_1}}
- [ ] {{CHECK_2}}
- [ ] {{CHECK_3}}
- [ ] {{CHECK_4}}