akillness avatar

Skill Standardization

When you're wrangling a repo full of SKILL.md files and need them to actually conform to the Agent Skills spec, this is your audit and repair loop. It validates frontmatter, checks trigger descriptions for weakness, catches catalog drift between live folders and your discovery surfaces, and handles the canonicalization dance when two skills compete for the same job. The working modes are unusually precise: you pick validate, create, canonicalize duplicates, structural sync, or derived surface sync, then run the truthful validator command for your current directory. It treats natural language in descriptions as sacred and validator bugs as fixable, which is the right stance. If you've ever shipped a skill rename only to find stale paths in three different README files, the residue scan checklist will feel familiar.

skills.sh installs
164
GitHub stars
22
last updated
Jun 3, 2026

Install

$ npx -y skills add akillness/oh-my-skills --skill skill-standardization --agent claude-code

Installs into .claude/skills of the current project.

Files

Skill Standardization

When to use this skill

  • Creating a new SKILL.md from scratch
  • Auditing an existing skill for Agent Skills spec compliance
  • Repairing weak trigger descriptions or stale route-outs
  • Canonicalizing duplicate skills into a default skill plus compatibility alias
  • Validating repo-level discovery/catalog drift after add/rename/remove/alias work
  • Reviewing SKILL.toon / SKILL.compact.md drift after material rewrites

Instructions

Step 1: Pick the smallest working mode

Use references/working-modes.md and pick exactly one primary mode:

  1. validate or repair one existing skill
  2. create or rewrite a SKILL.md
  3. canonicalize duplicates
  4. structural catalog / discovery sync
  5. derived-surface sync after a material rewrite

Do not start with a giant blended pass if one of those modes answers the job.

Step 2: Run the truthful validator command for the current working directory

For jeo-skills repo-root maintenance loops, use:

bash .agent-skills/skill-standardization/scripts/validate_skill.sh .agent-skills/<skill-name>

Sponsors

Details

Repository
github.com/akillness/oh-my-skills
First seen
Jun 3, 2026

More from akillness/oh-my-skills

All 81

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs