normalize-skill-for-claude — Claude Code skill: what it does
normalize-skill-for-claude is a Claude Code skill that audits an existing skill, plans changes, and rewrites its metadata, body, and references for routing.
no license 118 installs ★ 5 updated 2026-08-31
npx skills add ulpi-io/skills --skill normalize-skill-for-claude -a claude-codeWhat normalize-skill-for-claude does
The skill checks an existing SKILL.md against Claude Code runtime requirements: reads references/claude-skill-runtime.md, inventories frontmatter fields (description, when_to_use, allowed-tools, paths, context), compares them to routing and token budget constraints. Default mode is plan — it builds a DAG plan with justification for each change, no blind rewrite. rewrite mode applies changes: updates metadata, extracts examples and routing tables into references/ or scripts/, trims the body to working workflow, validates allowed-tools scope.
It distinguishes structural content (routing tables, rule sets, expertise definitions) from bloat (repeated examples, framework variants) — the former stays inline, the latter moves out. Without references/claude-skill-runtime.md, no plan is created: every recommendation is backed by runtime behavior, not preference. Works on any skill in a repository, but not on AGENT.md.
Installed paths differ: Claude Code uses ~/.claude/skills/, Codex .agents/skills/, Cursor .cursor/skills/, GitHub Copilot .github/skills/.
What it helps with
- validate skill metadata against Claude Code runtime
- build a DAG rewrite plan with source-backed rationale
- extract examples and tables from
SKILL.mdtoreferences/without losing structural content - optimize frontmatter for cheaper routing and auto-invocation
- trim skill body to workflow while keeping rules and definitions inline
Example prompts for the agent
- Check
skills/my-skill/SKILL.md— what needs to change for Claude Code - Plan normalization for the skill in
skills/data-pipeline/against Claude runtime - Rewrite
.cursor/skills/api-builder/SKILL.mdfor Claude Code inrewritemode
How to install normalize-skill-for-claude
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill normalize-skill-for-claude -a claude-code2Manually: put the files in place
~/.claude/skills/normalize-skill-for-claude/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/normalize-skill-for-claude/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill normalize-skill-for-claude -a codex2Manually: put the files in place
.agents/skills/normalize-skill-for-claude/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill normalize-skill-for-claude -a cursor2Manually: put the files in place
.cursor/skills/normalize-skill-for-claude/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ulpi-io/skills normalize-skill-for-claude2Manually: put the files in place
.github/skills/normalize-skill-for-claude/SKILL.md1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill normalize-skill-for-claude -a gemini-cli2Platform CLI
gemini skills install https://github.com/ulpi-io/skills --path normalize-skill-for-claudeManually: put the files in place
.devin/skills/normalize-skill-for-claude/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill normalize-skill-for-claude -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about normalize-skill-for-claude
How to install normalize-skill-for-claude in Claude Code?
Run npx skills add ulpi-io/skills --skill normalize-skill-for-claude -a claude-code, the skill lands in ~/.claude/skills/normalize-skill-for-claude/SKILL.md.
What does normalize-skill-for-claude do?
Checks a skill against Claude Code runtime, writes a DAG plan with justified changes, in rewrite mode rewrites frontmatter and body, extracts bloat to references/, and cuts tokens.
Can I use normalize-skill-for-claude on AGENT.md?
No, the skill only works on SKILL.md files. For agents, use normalize-agent-for-claude instead.