Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 24 additions & 5 deletions plugins/engineering-playbook/skills/creating-skills/SKILL.md
Original file line number Diff line number Diff line change
@@ -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.