# skill-lint

skill-lint audits SKILL.md files against seven structural quality dimensions, fixing critical defects immediately and flagging minor issues for approval.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-skills/agents/skill-lint.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/skill-lint

## What it does

The subagent inspects `SKILL.md` files after new skills are created or updated. It reviews YAML frontmatter, execution parameters, prompt token density, workflow stages, and directory completeness. It also looks for code snippets that should run as scripts instead of model instructions.

Fixes are split by severity. Critical and major issues get applied automatically without prompts. Minor formatting choices or missing optional folders appear in a summary table so you decide whether to patch them. Once done, the agent verifies changes against a quality checklist.

This agent depends on reference guides inside the plugin directory and saves run summaries into project `MEMORY.md`. It rejects agent definitions such as `AGENT.md` because they follow a separate contract.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-skills@Claudest
```

2. **Manually: put the files in place**
- File: `.claude/agents/skill-lint.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/skill-lint.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/skill-lint.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-skills/agents/skill-lint.md

## When to use it
- audit SKILL.md against structural quality standards
- patch critical YAML frontmatter mistakes automatically
- trim verbose token overhead from skill descriptions
- separate deterministic code blocks into standalone scripts

## Example prompts
- Run skill-lint on `skills/deploy-app/SKILL.md`
- Audit the new skill in `skills/extract-data` and fix major issues
- Check `SKILL.md` structure and report minor warnings

## Similar
- [golang-lint](https://affpapa.org/en/nevibecode/skills/golang-lint.md) — skill · 42700 installs
- [lint-and-validate](https://affpapa.org/en/nevibecode/skills/sickn33-lint-and-validate.md) — skill · 1300 installs
- [kb-lint](https://affpapa.org/en/nevibecode/skills/kb-lint.md) — skill · ★ 45 repo stars
- [wiki-lint](https://affpapa.org/en/nevibecode/skills/wiki-lint.md) — skill · 3600 installs
- [lint-on-save](https://affpapa.org/en/nevibecode/hooks/lint-on-save.md) — hook · 3235 installs
- [sasjs-lint](https://affpapa.org/en/nevibecode/skills/sasjs-lint.md) — skill · 1100 installs

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 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
