skills.rest
agentic-cookbook
agentic-cookbookOFFICIAL
Explore all skills by this author →
GitHub

lint-agent

Lint Claude Code agent files in .claude/agents/ for Anthropic best-practice compliance.

Updated Aug 27, 2026
Search Tags:#validation#claude#agent#best-practices#lint#ci
One-click install
npx skills add https://github.com/agentic-cookbook/tools --skill lint-agent-agentic-cookbook
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lint-agent
Source: https://github.com/agentic-cookbook/tools/tree/main/skills/lint-agent
Command: npx skills add https://github.com/agentic-cookbook/tools --skill lint-agent-agentic-cookbook

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps developers ensure their Claude agents follow Anthropic's best‑practice standards, catching structural and security issues before deployment.

Core Features & Use Cases

  • Structured lint report with PASS/WARN/FAIL ratings for frontmatter, content quality, and best‑practice compliance.
  • Automatic version check that warns when the installed skill version differs.
  • Interactive target resolution using file paths, name searches, or recent session context, with user prompts for ambiguous matches.
  • Use Cases: integrate into CI pipelines, run as a pre‑commit hook, or invoke on‑demand during agent development.

Quick Start

Ask the assistant to “lint my agent named build‑runner” to receive an immediate compliance report.

Frequently Asked Questions about lint-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I lint Claude agents for best-practice compliance before deployment?▼

Lint Claude agents by validating markdown files in .claude/agents/ against best-practice standards to catch structural and security issues. It generates a PASS/WARN/FAIL report covering frontmatter, content quality, and compliance.

Can I run Claude agent linting as a pre-commit hook or in CI pipelines?▼

Yes, you can integrate Claude agent linting into CI pipelines or run it as a pre-commit hook. It requires read-only file access and optionally fetches web guidance to validate agent markdown files.

How do I check a specific Claude agent file for compliance issues?▼

Check specific Claude agent files by asking the assistant to lint a named agent. It resolves targets interactively using file paths, name searches, or recent session context, prompting for ambiguous matches.

What problems does Claude agent linting solve during development?▼

Claude agent linting solves compliance problems by ensuring agents follow Anthropic's best-practice standards. It catches structural and security issues early in development, preventing deployment of non-compliant agent configurations.

Does the linter check for skill version differences?▼

Yes, the linter includes an automatic version check that warns when the installed skill version differs. This ensures you validate Claude agents against the most current best-practice standards.

Are there limitations when resolving agent targets for linting?▼

Target resolution limitations arise with ambiguous matches, requiring user prompts to clarify. The linter needs read-only access to .claude/agents/ files and may fetch web guidance to complete best-practice validation.

Related Skills

Explore More Software Engineering Skills→
outfitter-devoutfitter-dev
28

subagent-check

Validate Claude Code subagents against best practices for YAML, prompts, and tools.

Official
Advanced
lv7devlv7dev

Verification Before Completion

Run verification commands and produce pass/fail status reports.

Community
Basic
JamesPrialJamesPrial
3

go-linting

Route Go linting tasks to vet, staticcheck, and golangci-lint.

Community
Intermediate
rohanbhatia27rohanbhatia27
1

skill-improver

Review and fix Claude Code skills for quality and frontmatter compliance.

Community
Intermediate