Skip to main content
subagent CX Codex

skill-lint — Claude Code subagent: what it does, how to install

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

no license ★ 276 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-skills@Claudest
Open on GitHub

What skill-lint 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.

What it helps with

  • 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 for the agent

  • 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

How to install skill-lint

1Plugin marketplace

/plugin marketplace add gupsammy/Claudest
/plugin install claude-skills@Claudest

2Manually: put the files in place

.claude/agents/skill-lint.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about skill-lint

How to install skill-lint in Claude Code?

Run /plugin marketplace add gupsammy/Claudest first, then run /plugin install claude-skills@Claudest.

What does skill-lint do?

It audits a skill's SKILL.md across seven dimensions, automatically rewrites critical and major structural flaws, and asks before changing minor style details.

Can skill-lint audit agent definitions?

No, the linter explicitly declines AGENT.md files because agents adhere to a different structural contract.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set47

The whole set →
share-social share-social reshapes a clip to a network's upload spec — frame ratio, resolution, length and bitrate — from built-in presets. CX Codex +1 ★ 276repo stars convert-video convert-video handles video tasks in Claude Code via FFmpeg: remuxes containers, trims clips, adjusts playback speed, and scales footage. CX Codex +1 ★ 276repo stars commit This skill reviews Git changes and creates Conventional Commits. Use it to split unrelated work into separate commits and push when requested. CX Codex +1 ★ 276repo stars signal-discoverer The signal-discoverer subagent for Claude Code mines recent sessions for undocumented user corrections, architectural decisions, behavioral patterns and preferences to save to project memory. CX Codex ★ 276repo stars memory-auditor The memory-auditor subagent for Claude Code checks memory against code and Git, flagging stale or duplicate entries. Run it after a major refactor. CX Codex ★ 276repo stars clean-branches clean-branches is a Claude Code skill that finds merged and stale git branches, marks protected ones, and asks before deletion. It helps clear accumulated branch clutter. CX Codex +1 ★ 276repo stars council council launches parallel personas to deliberate on technical questions, examine codebase files, and formulate an opinionated verdict. CX Codex +1 ★ 276repo stars claw-advisor claw-advisor is a Claude Code skill for OpenClaw setup, troubleshooting, and architecture questions. It handles requests about channels, gateways, models, and automation. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open