skill-standardization — Claude Code skill: what it does and setup
Validates and standardizes SKILL.md files against the Agent Skills spec. Helps draft trigger-focused frontmatter and removes catalog drift across repositories.
npx skills add akillness/jeo-skills --skill skill-standardization -a claude-codeWhat skill-standardization does
This skill audits and structures SKILL.md files according to agentskills.io standards. It checks frontmatter fields like name and description to ensure agent dispatchers understand user intent. When two skills overlap, it designates one as canonical and turns the duplicate into a compatibility alias.
Execution relies on filesystem access and Bash. The bundled validate_skill.sh script catches invalid folder naming and weak routing text. It also monitors file size. Prompts stay cleaner when SKILL.md remains below 500 lines, so bulky checklists belong inside a separate references/ directory.
Repository-level maintenance relies on Python. Running validate_catalog_sync.py flags mismatches in skills.json or derived summaries after renaming a folder. Missing Python 3 blocks these synchronization checks completely.
What it helps with
- validate SKILL.md frontmatter against the Agent Skills specification
- rewrite vague trigger descriptions within the 1024-character limit
- resolve duplicate skills into a canonical version with an alias
- check skills.json and repository inventory files for naming drift
Example prompts for the agent
- Check .agent-skills/deploy-helper/SKILL.md against the Agent Skills specification
- Generate a valid SKILL.md template for a git commit assistant
- Audit the repository for conflicting skills and configure compatibility aliases
How to install skill-standardization
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill skill-standardization -a claude-code2Manually: put the files in place
~/.claude/skills/skill-standardization/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-standardization/
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill skill-standardization -a codex2Manually: put the files in place
.agents/skills/skill-standardization/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill skill-standardization -a cursor2Manually: put the files in place
.cursor/skills/skill-standardization/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install akillness/jeo-skills skill-standardization2Manually: put the files in place
.github/skills/skill-standardization/SKILL.md1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill skill-standardization -a gemini-cli2Platform CLI
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/skill-standardizationManually: put the files in place
.devin/skills/skill-standardization/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill skill-standardization -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 skill-standardization
How to install skill-standardization in Claude Code?
Run npx skills add akillness/jeo-skills --skill skill-standardization -a claude-code in your terminal. You can also place the configuration at ~/.claude/skills/skill-standardization/SKILL.md.
What does skill-standardization do?
It standardizes SKILL.md files to match the Agent Skills specification. The skill tunes trigger phrasing, validates frontmatter parameters, and prevents registry drift.
What limits does the validator enforce on skill files?
Descriptions must remain under 1024 characters with explicit trigger conditions. The validator also warns if SKILL.md exceeds 500 lines, prompting you to move reference material into references/.
