| name | creating-skills |
| description | Defines the local checklist and source-loading rules for creating or editing skills and their resources. |
Guidance Source
Read the complete external guidance before:
- creating a skill
- changing skill discovery or behavior, resource organization, progressive
disclosure, scripts, or tool workflows
- performing a periodic guidance refresh or updating this checklist
Source:
https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
Follow the source strictly when it applies. If it cannot be read, report the
blocker before editing unless the user explicitly says to continue.
For routine wording, spelling, and formatting edits that do not change skill
behavior or structure, use only the local checklist below.
Routine Edit Checklist
- Preserve the skill's behavior, triggers, structure, and file references.
- Keep instructions concise and use consistent terminology.
- Keep names and descriptions specific and truthful about what the skill does
and when it applies.
- Keep file references directly linked from
SKILL.md and use forward slashes.
- Avoid adding time-sensitive guidance or unnecessary choices and explanations.
- Verify referenced paths and any repository validation affected by the edit.
