Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ulpi-io/skills --skill normalize-skill-for-claude -a claude-code
Open on GitHub

What 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.md to references/ 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.md for Claude Code in rewrite mode

How to install normalize-skill-for-claude

1Skills CLI (Vercel)

npx skills add ulpi-io/skills --skill normalize-skill-for-claude -a claude-code

2Manually: put the files in place

~/.claude/skills/normalize-skill-for-claude/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/normalize-skill-for-claude/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set49

The whole set →

Project sponsors

Companies that keep this analytics open