2.6 KiB
2.6 KiB
name: [YOUR_SKILL_NAME]
description: [YOUR_DESCRIPTION] - Be specific about WHAT the skill does and WHEN to use it. Include trigger keywords. Example: "Test REST APIs with validation and reporting. Use when testing APIs, endpoints, HTTP services, or when users mention API testing, endpoint validation, or integration testing."
allowed-tools: Read, Grep, Glob, Bash
version: 1.0.0
[YOUR_SKILL_NAME]
[Brief overview - 1-2 sentences]
Overview
This skill provides comprehensive [CAPABILITY]:
- Feature 1: [Description]
- Feature 2: [Description]
- Feature 3: [Description]
Quick Start
Basic Example
[SIMPLE_EXAMPLE]
Key Concepts
- Concept 1: [Explanation]
- Concept 2: [Explanation]
- Concept 3: [Explanation]
Core Workflows
Workflow 1: [Name]
- [Step 1 description]
- [Step 2 description]
- [Step 3 description]
[EXAMPLE_CODE]
Workflow 2: [Name]
- [Step 1 description]
- [Step 2 description]
- [Step 3 description]
[EXAMPLE_CODE]
Advanced Usage
For advanced patterns and detailed API reference, see:
- REFERENCE.md - Complete API documentation
- EXAMPLES.md - Real-world use cases
Tool Restrictions
This skill restricts tool usage to: Read, Grep, Glob, Bash
Why these restrictions?
- Read/Grep/Glob: [Explanation]
- Bash: [Explanation]
- No Write/Edit: [Explanation]
Best Practices
-
Practice 1
- What: [Description]
- Why: [Reasoning]
- How: [Implementation tip]
-
Practice 2
- What: [Description]
- Why: [Reasoning]
- How: [Implementation tip]
Common Patterns
Pattern 1: [Name]
[CODE_EXAMPLE]
Use when: [Scenario description]
Pattern 2: [Name]
[CODE_EXAMPLE]
Use when: [Scenario description]
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| [Problem 1] | [Cause] | [Fix] |
| [Problem 2] | [Cause] | [Fix] |
| [Problem 3] | [Cause] | [Fix] |
Requirements
Dependencies:
Installation:
[INSTALL_COMMANDS]
Environment:
Progressive Disclosure
This SKILL.md provides the essentials. For deeper information:
- Complete API documentation
- Configuration options
- Advanced patterns
- Performance tuning
- Real-world use cases
- Integration examples
- Best practice implementations
- Common scenarios
Version History
- 1.0.0: Initial release
- [Feature 1]
- [Feature 2]
- [Feature 3]