context-rot

Audit CLAUDE.md files and transcripts to detect context rot.

2|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/ran729/context-rot-skill --skill context-rot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-rot
Source: https://github.com/ran729/context-rot-skill/tree/main/.claude/.claude/skills/context-rot
Command: npx skills add https://github.com/ran729/context-rot-skill --skill context-rot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill identifies and helps you fix "context rot" – stale, redundant, or missing instructions in your AI's context files (CLAUDE.md) and recent conversation transcripts that degrade performance and increase costs.

Core Features & Use Cases

  • Transcript Analysis: Scans recent conversation logs for friction signals like user corrections, repeated clarifications, and policy overrides.
  • Context File Audit: Reviews CLAUDE.md for redundancy, ghost sections, bloat, and stale references.
  • Scored Health Report: Generates a visual scorecard grading your context health against research-backed anti-patterns, with a prioritized fix queue.
  • Use Case: Before a major project kickoff, run this Skill to ensure your AI agent's foundational instructions are clear, concise, and up-to-date, preventing costly misunderstandings and improving efficiency.

Quick Start

Use the context-rot skill to audit your CLAUDE.md and recent transcripts for issues.

Frequently Asked Questions about context-rot

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

FAQPage Schema
How do I audit my AI context files for stale or redundant instructions?

To audit AI context files for stale or redundant instructions, scan your CLAUDE.md and recent conversation transcripts to detect friction signals like user corrections and repeated clarifications, generating a scored health report with prioritized fixes.

What is context rot and how does it degrade AI agent performance?

Context rot is the accumulation of stale, redundant, or missing instructions in AI context files and transcripts that degrades performance and increases operational costs by causing costly misunderstandings and repeated clarifications.

How do I fix missing or bloated instructions in CLAUDE.md documentation?

Fix missing or bloated CLAUDE.md instructions by reviewing the markdown documentation for anti-patterns, redundancy, and ghost sections, then applying actionable fixes from a prioritized queue based on transcript friction analysis.

Can I detect AI conversation friction signals from user corrections in transcripts?

Yes, you can detect conversation friction signals by scanning recent transcripts for user corrections, repeated clarifications, and policy overrides, which indicate underlying issues in your foundational AI context instructions.

When should I run a context health audit before a major project kickoff?

Run a context health audit before a major project kickoff to ensure your AI agent's foundational instructions are clear, concise, and up-to-date, preventing costly misunderstandings and improving overall operational efficiency.

Does this context audit tool work without external dependencies?

Yes, this context audit tool works without external dependencies, using internal scripts and references to analyze markdown documentation and conversation transcripts for anti-patterns and friction signals.