Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    tidyagents

    1

    Lint, score and safely tidy AI agent instruction files (AGENTS.md, CLAUDE.md, .cursorrules): finds stale paths, dead scripts, contradictions and bloat.

    Free

    Security scanned
    tidyagents

    tidyagents

    Example session with this skill installed

    Run tidyagents on this repo, tell me the score, and clean up what's safe to fix.

    • Read your context and instructions
    • Compiled the tidyagents

    Summary

    tidyagents scored CLAUDE.md

    61/100, found 6 issues, and fix safely removed 3 of them, taking it to

    76/100 (74 → 53 tokens). 3 issues need a human decision.

    $ npx -y tidyagents
    
    CLAUDE.md  61/100  (74 tokens)
      ✗ line 5   references `scripts/deploy.sh`, which does not exist  [missing-path]
      ✗ line 6   runs script "typecheck", which is not in package.json  [missing-script] fixable
      ⚠ line 7   "follow best practices" is too vague for an agent to act on  [vague]
      ✗ line 8   contradicts line 3; keep one of them  [contradiction]
      ⚠ line 9   repeats line 4 in the same section  [duplicate] fixable
      · line 11  3 blank lines in a row  [blank-lines] fixable
    

    Safe fixes applied (tidyagents fix)

    LineRemovedRule
    6Run npm run typecheck before pushing.missing-script
    9duplicate Run npm run test before committing.duplicate
    11-12extra blank linesblank-lines
    MetricBeforeAfter
    Score61/10076/100
    Tokens7453

    Needs your decision

    • Line 5: scripts/deploy.sh is gone. Update the path, or delete the line if deploys moved.
    • Line 7: "follow best practices" is too vague. Name the concrete command or rule.
    • Line 8: "Never use tabs" contradicts "Always use tabs" on line 3. Keep one.

    Next steps

    • Fix the three items above, then re-run npx -y tidyagents to reach 100.
    • Add the GitHub Action (vishwakulkarni/tidyagents@v1, min-score: 80) so new rot fails the pull request.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    tidyagents lints, scores and tidies the instruction files your AI coding agents read every session: AGENTS.md, CLAUDE.md, GEMINI.md, SKILL.md, .cursorrules and copilot-instructions.md. Agent files rot quietly. Code moves, scripts get renamed, and the instructions keep pointing at things that no longer exist. This skill has your agent find that rot and clean up what is safe to clean. It checks for missing paths, dead npm scripts, contradictions, duplicates, vague rules and oversized files, then scores each file out of 100. The fix command only deletes lines it is sure about, shows a diff first, and flags anything uncertain instead of removing it. Zero dependencies, no network calls, no model calls, deterministic scores that work as a CI gate. In a scan of 67 popular open-source repos, 27% sent their agent to files that no longer exist. Source: github.com/vishwakulkarni/tidyagents (Apache 2.0).

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Prompt & Skill Engineering.

    Skips gitignored paths and example text to avoid false positives. Does not verify external network resources. Node >= 18.3 required.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free to use

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 10 days ago

    • Free with an Agensi account

    Software
    Node.js

    Permissions

    Read Files
    Write Files
    Terminal / Shell
    Network Access
    Listed10 days ago

    What's inside

    Frequently Asked Questions

    tidyagents specializes in identifying "silent failures" that LLMs miss, such as verifying if file paths actually exist in your repo or if npm scripts are valid. Unlike generic prompts, it uses deterministic logic to find hard-coded contradictions and redundant rules that cause agent drift.

    It supports all major instruction file formats including .cursorrules, SKILL.md, CLAUDE.md, and AGENTS.md. As a zero-dependency Node.js tool, it works seamlessly across any IDE or framework as long as you have Node.js 18.3 or higher installed.

    You can integrate the tool into your GitHub Actions or CI/CD pipelines using the `--min-score` flag. This allows you to set a quality threshold (e.g., 80/100) and automatically block merges if new instructions introduce bloat, broken paths, or logic errors.

    The `fix` command is designed for safety; it generates a diff for you to review before any changes are applied. It focuses on non-destructive removals like dead paths and duplicates, while flagging complex logic contradictions for your manual approval.

    This purchase provides full access to the Node.js CLI tool, which can be run via npx or installed globally. You will receive all future logic updates, new rule definitions, and support for emerging instruction file formats as they are released.

    New in Prompt & Skill Engineering

    Free