lint-agentslisted
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