# Agent Context Audit

Audit a repo's agent context, CLAUDE.md files, codebase docs, skills, and tool/MCP...

- Repository: https://github.com/AI-Builder-Club/skills (1308 stars)
- Category: Design
- License: see repository
- Last updated: 2026-09-15
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add AI-Builder-Club/skills --skill agent-context-audit -g -a claude-code -y`
Codex: `npx skills add AI-Builder-Club/skills --skill agent-context-audit -g -a codex -y`
Cursor: `npx skills add AI-Builder-Club/skills --skill agent-context-audit -g -a cursor -y`
Gemini CLI: `npx skills add AI-Builder-Club/skills --skill agent-context-audit -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add AI-Builder-Club/skills`

## Description

Audit a repo's agent context, CLAUDE.md files, codebase docs, skills, and tool/MCP designs, against Anthropic's Claude 5 context-engineering guidance ("unhobbling": Anthropic cut ~80% of Claude Code's system prompt with no eval loss). Finds overconstraint, conflicting instructions, redundancy, stale facts, and missing "unknown knowns"; produces a scored findings report with concrete rewrites, then applies approved fixes. Use when someone says "audit my CLAUDE.md", "context audit", "unhobble this repo", "review our agent docs/skills/tools", or after upgrading to Claude 5-generation models.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# agent-context-audit, unhobble this repo's agent context

Goal: find where this repo's context (CLAUDE.md, docs, skills, tool designs)
**hobbles** a Claude 5-generation model, overconstrains it, contradicts itself,
repeats itself, or hides context the model actually needs, and leave behind a
findings report plus approved fixes.

Background: Anthropic removed over 80% of Claude Code's system prompt for
Claude 5 models with **no measurable loss** on coding evals. Older context was
written for models that needed rules; newer models need judgment, good
interfaces, and the facts they can't infer. This skill audits against that
shift, plus the "finding your unknowns" framework (the gap between the *map*, your prompts/docs, and the *territory*, the actual codebase).

You are **auditing first, fixing second**. Do not edit anything until Step 4.

## The six shifts (the audit rubric)

Every finding maps to one of these. Cite the shift number in the report.

The rest: https://github.com/AI-Builder-Club/skills/blob/HEAD/skills/agent-context-audit/SKILL.md