← ClaudeAtlas

lint-agentslisted

Validates required frontmatter fields and body content in every agent and skill file in the pack by running scripts/lint-agents.sh. Interprets failures with specific fix instructions. Use before committing new or modified agents/skills, or as a CI gate. Trigger this when someone says: lint agents, validate agents, check agent files, run lint-agents, validate the pack, check if my agent is valid, did I write the skill correctly.
chuckplayer/claude-agent-pack · ★ 2 · AI & Automation · score 75
Install: claude install-skill chuckplayer/claude-agent-pack
# Lint Agents Run the Agent Pack linter to validate all agent and skill files, then interpret any failures with specific, actionable fix instructions. ## 1. Run the linter ```bash bash scripts/lint-agents.sh ``` Capture the full output. If the script does not exist or is not executable, report: > `scripts/lint-agents.sh` not found. Run `/setup-project` to scaffold the project structure, or check that you are in the correct repository root. ## 2. Parse the output For each file reported in the output: - **PASS** — note it as passing. No action needed. - **FAIL** — identify the specific reason from the linter message and produce a targeted fix instruction (see below). ## 3. Produce fix instructions for each failure Map linter failure messages to actionable fixes: | Failure message | Fix | |---|---| | Missing required field: `name` | Add `name: <value>` to the frontmatter. For agents, this is the agent's identifier. For skills, it matches the slash command name. | | Missing required field: `description` | Add `description: >` followed by a multi-line description, or `description: "..."` for a single-line value. The description is the routing contract — make it specific. | | Unknown frontmatter field: `<field>` | Remove the `<field>` line. Only `name`, `description`, `model`, `effort`, `tools`, `permissionMode`, and `version` are valid for agents; only `name`, `description`, `model`, and `effort` are valid for skills. | | Description exceeds 1536 characters | Shorten th