Non-negotiable rules:

1. Read references/claude-skill-runtime.md before planning or rewriting.
2. Default to --mode plan unless the user explicitly asks to rewrite now.
3. Treat frontmatter as the highest-leverage surface. Claude routes and budgets skills from metadata first.
4. Keep SKILL.md focused on workflow. Move bulky examples, framework variants, and edge-case catalogs into references/ or scripts/.
5. Do not add context: fork, paths:, or user-invocable: false without a concrete runtime reason.
6. Never add agent-only frontmatter to a skill. tools, disallowedTools, skills, initialPrompt, permissionMode, maxTurns, background, memory, isolation, color, and mcpServers belong to agents, not skills.

Normalize Skill For Claude

Inputs

• $target: Skill directory or direct path to SKILL.md
• $mode: Optional. plan or rewrite. Default: plan