creating-skills

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.