Agent Skills Lint

agent-skills-lint

Cross-agent skill validator, installer, and index generator. One tool for Claude Code, Codex, OpenCode, Aider, Copilot, Cursor, Gemini, Droid, Trae, Kiro — and more.

[](https://www.npmjs.com/package/@swarmclawai/agent-skills-lint) [](./LICENSE) [](https://github.com/swarmclawai/agent-skills-lint/actions/workflows/ci.yml)

Why this exists

Every coding agent now ships a "skills" feature — and every one uses a slightly different file layout, a slightly different frontmatter schema, and a slightly different install path. You install skills from three different repos and end up with:

• one skill silently overriding another because their names collide
• a typo in a frontmatter field that nobody catches until an agent just quietly ignores the skill
• fifteen .md files in ~/.claude/skills/ with no index, no versioning, and no idea which came from where

`agent-skills-lint` is the first tooling layer on top of the skills content ecosystem. It **validates** skill files against per-agent schemas, **installs** them safely (collision-aware) into the right directory for your agent of choice, and **generates an index** so you always know what's installed.

Most agents use the same `name` + `description` frontmatter pattern — we validate that core schema across all of them, and layer on per-flavor rules (Cursor's `.mdc` files with `globs`/`alwaysApply`, OpenClaw's richer `version` + `metadata` fields, etc).

30-second demo

# Validate every skill in your Claude Code install
npx @swarmclawai/agent-skills-lint@latest lint ~/.claude/skills

# Install a skill for OpenAI Codex (uses ~/.agents/skills//SKILL.md)
npx @swarmclawai/agent-skills-lint --flavor codex install ./my-skill.md

# Generate a CLAUDE.md-st