1
    πŸ€– AGENTS.md Linter

    πŸ€– AGENTS.md Linter

    by JustHandled Labs

    Lint your AGENTS.md (or CLAUDE.md and .cursorrules) for the problems that make a coding agent misbehave. Flags contradictory rules, references to files and commands that no longer exist, overly broad or unsafe instructions, missing sections (build, test, run, conventions), duplicate rules, and the case where you have competing rule files that should be consolidated into one AGENTS.md.

    Updated Jun 2026
    Security scanned
    Cursor

    $12

    Β· or 60 credits

    30-day refund guarantee

    Secure checkout via Stripe

    Included in download

    • Identify broken terminal commands in CLAUDE.md and .cursorrules.
    • Resolve conflicting style guides between multiple agent configuration files.
    • file_read, terminal automation included
    • Ready for Cursor
    • Instant install

    Sample input

    Lint my .cursorrules and AGENTS.md files for any contradictions or stale command references.

    Sample output

    Linting Results

    • [AML003] Stale Command: .cursorrules line 12 references npm run dev:legacy, but only dev:next exists in package.json.
    • [AML001] Contradiction: AGENTS.md mandates tabs for indents, while .cursorrules line 45 enforces 2-space indentation.
    • [AML007] Redundant: Rule 'No comments' found in both files.

    About This Skill

    Optimized Agent Instruction Linting

    Maintaining clear and consistent instructions for AI agents is critical for reliable development workflows. The AGENTS.md Linter provides a rigorous analysis of your configuration files (AGENTS.md, CLAUDE.md, .cursorrules) to ensure your AI isn't being slowed down by conflicting commands or stale context.

    What it does

    This skill scans your repository's instruction files against your actual codebase to identify breaking issues. It goes beyond simple text checking by cross-referencing your project's package.json, Makefile, and source files to verify that the commands your agents are told to run actually exist.

    • Detects conflicting rules that cause agent "hallucination" or refusal.
    • Flags stale file paths and obsolete terminal commands.
    • Identifies overly broad or unsafe instructions that could compromise code quality.
    • Suggests consolidation strategies when multiple competing rule files are found.

    Why use this skill

    Unlike basic prompting, this tool uses specific rule IDs (AML001-AML007) and manifest scanning to provide high-precision feedback. It prevents the common "instruction bloat" that leads to context window waste and ensures your Cursor, Claude, or Copilot agents remain surgical and efficient.

    Use Cases

    • Identify broken terminal commands in CLAUDE.md and .cursorrules.
    • Resolve conflicting style guides between multiple agent configuration files.
    • Clean up redundant instructions to save context window space.
    • Verify that rule file paths exist within the current repository structure.

    Reviews

    No reviews yet - be the first to share your experience.

    Only users who have downloaded or purchased this skill can leave a review.

    Security Scanned

    Passed automated security review

    Permissions

    Read Files
    Terminal / Shell

    File Scopes

    agents-md-linter/**
    **/AGENTS.md
    **/CLAUDE.md
    **/.cursorrules
    **/.github/copilot-instructions.md
    package.json
    Makefile
    **/*.py
    **/*.js
    **/*.ts

    Read-only. It reads your rule file and cross-references the named files and commands against the repo. Reads no environment variables and writes nothing.

    Tags

    linting
    cursorrules
    agent-ops
    claude-md
    developer-productivity

    Works with any agent that can read a repo and run a local Python script (Claude Code, Cursor, Codex CLI, and other SKILL.md-compatible agents). Standard library only, no install step. Read-only, no network.

    Creator

    JustHandled Labs

    JustHandled Labs builds focused agent skills for the work nobody wants to do by hand. Each one is a single repeatable job done well: catching the security and data mistakes that quietly ship, keeping docs and tests honest, gating the commands an agent is about to run, sharpening writing, and handling the founder chores around launches, outreach, and brand setup. Not generic AI productivity. Specific workflows that are easy to run, review, and repeat. Maintained by H.J. Westerfield, with a background in communications, editing, project coordination, customer support, and practical AI systems. Tools for people who want useful automation without theatrical complexity.

    Frequently Asked Questions

    Learn More About AI Agent Skills

    More Premium Skills

    designing-hybrid-context-layers

    Architects the right retrieval strategy for every query β€” teaching your agent when to use RAG, a knowledge graph, or a temporal index instead of defaulting to vector search for everything.

    $1015 installs

    consumer-motivation-analyzer

    Go beyond surface-level feedback to uncover the psychological drivers and hidden motivations behind buyer behavior.

    $199 installs

    ai-automation-qa-pack

    Professional QA & UAT documentation generator for AI automation agencies and complex agent deployments.

    $58 installs

    Bounty Security Pattern Master Library β€” 399 Vulnerability Patterns

    A premium library of 399 vulnerability patterns and DeFi attack vectors for AI-driven bug hunting and security audits.

    $758 installs

    $12