diff --git a/plugins/engineering-playbook/skills/creating-skills/SKILL.md b/plugins/engineering-playbook/skills/creating-skills/SKILL.md index e848df3..f41a03a 100644 --- a/plugins/engineering-playbook/skills/creating-skills/SKILL.md +++ b/plugins/engineering-playbook/skills/creating-skills/SKILL.md @@ -1,13 +1,32 @@ --- name: creating-skills -description: Defines skill-authoring guidance loaded by development before skill or skill-resource changes. +description: Defines the local checklist and source-loading rules for creating or editing skills and their resources. --- -## Source +## Guidance Source -Before creating or editing a skill or any file referenced by a skill, read: +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 that guidance strictly. If the page cannot be read, report the blocker -before editing unless the user explicitly says to continue. +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.