Skip to content
LiveNew tools this week
Submit
AIMarketly
skill-polisher logo

Skill Polisher (Claude Code)

skill-polisher

Meta-skill for Claude Code to validate and polish Codex skills under `.codex/skills/` by running the skill-polisher and reviewing structural integrity. Use when auditing Codex skills, enforcing standardization, or running integrity sweeps across the Codex skill set.

diegosouzapw/awesome-omni-skill0installs61starsOther

SKILL.md

Full skill instructions

Skill Polisher (Claude Code)

Audit Codex skills for structural integrity and standardization by using the existing Codex skill-polisher tooling.

Flavor Contract

  • Claude-flavored by default: validates Claude frontmatter/​tooling rules.
  • Cross-flavored compatible via shared auditor (see Cross-Flavor Audit).

Target scope

  • Codex skills:
    • Single skill: .codex/​skills/<skill-name>
    • Whole set: .codex/​skills
  • Claude skills:
    • Single skill: .claude/​skills/<skill-name>
    • Whole set: .claude/​skills

Execution

Codex skills (preferred)

Use the Codex polisher for deterministic audits:

uv run .codex/​skills/​skill-polisher/​scripts/​polish_skill.py .codex/​skills --all

For a single skill:

uv run .codex/​skills/​skill-polisher/​scripts/​polish_skill.py .codex/​skills/<skill-name>

Claude skills (manual audit)

Claude skills do not share the Codex polisher; use a lightweight audit:

Get-ChildItem .claude/​skills -Directory
Get-Content .claude/​skills/<skill-name>/​SKILL.md

Checks to confirm:

  • SKILL.md present
  • Frontmatter includes name and description
  • Any allowed-tools entries match Claude tool names (Read, Write, Glob, Grep, Bash as needed)

Cross-Flavor Audit (shared)

Use the shared auditor when you want consistent reporting:

uv run scripts/​skill_audit.py --flavor codex --root .codex/​skills
uv run scripts/​skill_audit.py --flavor claude --root .claude/​skills

Hook (Claude-side)

Run the Claude cross-compatible audit via the helper script:

.\scripts\run_claude_skill_polisher.ps1 -Root .claude/​skills

Claude-Local Audit (Claude-centric outputs)

Write JSON outputs into claude/​mailbox:

.\scripts\run_claude_local_audit.ps1 -Root .claude/​skills

Hook (Claude-side cross-polish)

Run both Codex and Claude audits in one pass:

.\scripts\run_claude_cross_polish.ps1 -CodexRoot .codex/​skills -ClaudeRoot .claude/​skills

Bridge (Codex tooling)

Invoke Codex polisher from Claude:

.\scripts\run_codex_polisher.ps1 -Root .codex/​skills

Reporting

Summarize:

  • TASTE + score
  • Issues (if any)
  • Files changed (if any)

Notes

  • This skill audits Codex and Claude skills; do not modify either unless explicitly requested.
  • If you need to add @POLISHED seals, do so after a clean run and record the timestamp.

Cross-Flavor Compatibility

  • Codex flavor: requires agents/​openai.yaml and assets/ with SVG icons.
  • Claude flavor: requires SKILL.md with valid frontmatter (name, description), optional allowed-tools.
  • For shared audits use: python scripts/​skill_audit.py --flavor codex --root .codex/​skills and python scripts/​skill_audit.py --flavor claude --root .claude/​skills.