Examples of bad descriptions:
# Too vague description: Helps with projects. # Missing triggers description: Creates sophisticated multi-page documentation systems. # Too technical, no user triggers description: Implements the Project entity model with hierarchical relationships.
Writing the main instructions
After the frontmatter, write the actual instructions in Markdown.
Recommended structure:
Adapt this template for your skill. Replace bracketed sections with your specific content.
--- name: your-skill description: [...] --- # Your Skill Name ## Instructions ### Step 1: [First Major Step] Clear explanation of what happens.
Example: ```bash python scripts/fetch_data.py --project-id PROJECT_ID Expected output: [describe what success looks like]
(Add more steps as needed)
Examples
Example 1: [common scenario]
User says: "Set up a new marketing campaign"
Actions:
- 1. Fetch existing campaigns via MCP
- 2. Create new campaign with provided parameters
Result: Campaign created with confirmation link
(Add more examples as needed)
Troubleshooting
Error: [Common error message]
Cause: [Why it happens]
Solution: [How to fix]
(Add more error cases as needed)