# skill-standardization

Validates and standardizes SKILL.md files against the Agent Skills spec. Helps draft trigger-focused frontmatter and removes catalog drift across repositories.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 351 installs · ★ 51
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/skill-standardization/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/skill-standardization

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill skill-standardization -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/skill-standardization/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/skill-standardization/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill skill-standardization -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/skill-standardization/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill skill-standardization -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/skill-standardization/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills skill-standardization
```

2. **Manually: put the files in place**
- File: `.github/skills/skill-standardization/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill skill-standardization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/skill-standardization
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/skill-standardization/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill skill-standardization -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/skill-standardization/SKILL.md

## When to use it
- 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
- 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

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 65 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md