Instruction Enhancer

    1

    Audit your CLAUDE.md and AGENTS.md: cut the lines that don't change agent behaviour, fix the ones the repo contradicts, and add a few proven rules with your real commands.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    Instruction Enhancer

    Example session with this skill installed

    My CLAUDE.md is getting ignored and feels way too long. Audit my agent instructions and prune the fluff.

    • Read your context and instructions
    • Compiled the instruction enhancer

    I have audited CLAUDE.md and AGENTS.md against your current repository state (using package.json and pnpm-lock.yaml as truth). Your instructions contained 42 lines of directory tours that the agent can already see and several commands that pointed to a deprecated npm workflow despite the repo using pnpm.

    Instruction Enhancement Plan

    CLAUDE.md — 184 lines → 62 lines

    • Remove
      • L10-45: Manual directory tour (redundant to file tree).
      • L55: "Write clean code" (generic behavioral fluff).
      • L60-65: Duplicated test instructions.
    • Rewrite
      • L8: "Always be thorough" → "Verify changes with pnpm test before reporting completion."
      • L12: "Use npm for tasks" → Update to pnpm based on lockfile.
    • Add
      • Rule: Search prior art before building new components.
      • Don't touch: dist/, build/, and .next/ directories.
    • Ask
      • L15 mentions a deploy.sh script that does not exist in the root or scripts/. Should this be removed or updated to the new CI flow?

    Next steps

    1. Review the removal of the directory tour.
    2. Confirm if the deploy.sh reference is obsolete.
    3. Say "approved" to apply these changes to both CLAUDE.md and AGENTS.md.
    CLAUDE.md

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

    About this skill

    Agents read CLAUDE.md and AGENTS.md on every task, so every line costs tokens and attention, and generic or out-of-date lines make agents worse, not better. Instruction Enhancer makes these files shorter and sharper. It removes generic advice, directory tours, and duplicates. It checks every path, command, and version against the repo, using git log to find changes made after the file was last edited. It rewrites vague lines such as "be thorough" into checkable rules. It adds rules only from a fixed library of seven core rules and two UI rules, and only when the repo shows the signal that each rule needs. Commands and do-not-touch paths come from files it reads during the run, never from guesses. When a repo has both CLAUDE.md and AGENTS.md, both get the same content. It shows a remove, rewrite, and add plan, then stops until you approve it.

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Code Quality & Review.

    It checks that documented commands and paths exist and match the files that define them, but it doesn't run the commands. A command that exists but behaves differently than documented can slip through. Behavioural rules come only from its built-in library. It suggests hooks for "always run X" lines but doesn't install them unless asked.

    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 16 days ago

    • Free with an Agensi account

    Software
    File-edit capabilityGit

    Permissions

    Terminal / Shell
    Read Files
    Write Files

    File Scopes

    CLAUDE.md
    AGENTS.md
    Listed16 days ago

    What's inside

    Frequently Asked Questions

    This skill scans your repository's actual configuration files (like package.json or Makefiles) to ensure every documented command is valid, while aggressively deleting generic "fluff" that wastes tokens and confuses agents.

    Instruction Enhancer is designed for any agent that consumes root-level markdown rules, including Claude Code, Cursor, Windsurf, and custom internal agents that utilize AGENTS.md or CLAUDE.md.

    No, the skill generates a detailed proposal and diff first; it will only modify your files after you review the plan and provide explicit approval.

    To ensure high reliability and low token usage, the skill enforces a 150-line limit per file, prioritizing high-impact behavioral rules over redundant directory maps or lengthy explanations.

    The skill is highly effective at identifying 'instruction creep' after migrations, cross-referencing your updated lockfiles and CI configs to purge legacy commands that no longer function.

    Yes. Running it again on its own output should report no changes, or very few.

    New in Code Quality & Review

    Free