$npx -y skills add amtiYo/agents --skill skill-guideExplain how to create, organize, and maintain skills in .agents/skills when the user asks about skills.
| 1 | When asked about skills: |
| 2 | |
| 3 | 1. Explain required structure: |
| 4 | - One directory per skill under `.agents/skills`. |
| 5 | - A required `SKILL.md` file with YAML frontmatter. |
| 6 | |
| 7 | 2. Explain required frontmatter: |
| 8 | - `name`: short unique identifier. |
| 9 | - `description`: explicit trigger guidance for when the skill should be used. |
| 10 | |
| 11 | 3. Provide a minimal starter template and ask for: |
| 12 | - the task scope, |
| 13 | - expected input/output, |
| 14 | - success criteria. |
| 15 | |
| 16 | 4. Recommend progressive disclosure: |
| 17 | - keep `SKILL.md` concise, |
| 18 | - put large references/examples in separate files. |
| 19 | |
| 20 | 5. Suggest validation checklist: |
| 21 | - clear trigger description, |
| 22 | - deterministic steps, |
| 23 | - no secrets in skill files, |
| 24 | - tested with at least one real prompt. |