<!-- SYNC:shared-protocol-duplication-policy -->[IMPORTANT] Use
TaskCreateto break ALL work into small tasks BEFORE starting.
<!-- /SYNC:shared-protocol-duplication-policy -->Shared Protocol Duplication Policy — Inline protocol content in skills (wrapped in
<!-- SYNC:tag -->) is INTENTIONAL duplication. Do NOT extract, deduplicate, or replace with file references. AI compliance drops significantly when protocols are behind file-read indirection. To update: edit.claude/skills/shared/sync-inline-versions.mdfirst, then grepSYNC:protocol-nameand update all occurrences.
Quick Summary
Goal: Add new reference files or scripts to an existing skill directory.
Workflow:
- Identify — Determine target skill and required additions
- Create — Add reference/script files following progressive disclosure (<100 lines each)
- Update SKILL.md — Add SYNC blocks if new protocols apply, update references
- Enhance — Call
/prompt-enhanceon the updated SKILL.md - Validate — Verify files work, scripts pass tests
Key Rules:
- Reference files under 100 lines each (progressive disclosure)
- Scripts must have tests and respect
.envloading order - If adding shared protocol content → use
<!-- SYNC:tag -->inline blocks fromsync-inline-versions.md - MUST ATTENTION call
/prompt-enhanceon SKILL.md after modifications
Arguments
$1: skill name (required)
$2: reference or script prompt (required)
If $1 or $2 is not provided, ask via AskUserQuestion.
Mission
Add new reference files or scripts to .claude/skills/$1 directory.
<reference-or-script-prompt>$2</reference-or-script-prompt>
Rules
- Token-efficient: SKILL.md short and concise, references under 100 lines each
- If given a URL → use
Exploresubagent to explore all internal links - If given multiple URLs → use parallel
Exploresubagents - If given a GitHub URL → use
repomixto summarize + parallelExploresubagents - Skills are instructions, not documentation. Teach Claude HOW to do the task.
- If new content involves shared protocols → inline via SYNC tags, never file references
Closing Reminders
- IMPORTANT MUST ATTENTION break work into small todo tasks using
TaskCreateBEFORE starting - IMPORTANT MUST ATTENTION inline shared protocols via
<!-- SYNC:tag -->blocks — NEVER use file references - IMPORTANT MUST ATTENTION call
/prompt-enhanceon updated SKILL.md as final quality pass - IMPORTANT MUST ATTENTION keep reference files under 100 lines each (progressive disclosure) <!-- SYNC:shared-protocol-duplication-policy:reminder -->
- IMPORTANT MUST ATTENTION follow duplication policy: inline protocols are INTENTIONAL, never extract to file references <!-- /SYNC:shared-protocol-duplication-policy:reminder -->