agent-density-auditor

Audit Claude Code agent prompt density and enforce VibeFlow ADR-029 limits.

9|Updated May 24, 2026
One-click install
npx skills add https://github.com/picmakpro/vibeflow-os --skill agent-density-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-density-auditor
Source: https://github.com/picmakpro/vibeflow-os/tree/main/plugin/reference/content/methodology/templates/skills/agent-density-auditor
Command: npx skills add https://github.com/picmakpro/vibeflow-os --skill agent-density-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill prevents oversized Claude Code agent prompts from causing context rot, hallucinations, drift, and inefficient token usage by enforcing VibeFlow ADR-029 density thresholds.

Core Features & Use Cases

  • Density Measurement: Measure agent files and directories, including body lines, estimated tokens, and compliance classifications.
  • Migration Planning: Analyze oversized agents and recommend content to keep, extract into references, or transform into reusable skills.
  • Validation Gates: Enforce line limits, description length, frontmatter conventions, and section-size warnings after agent edits.
  • Use Case: Audit a project’s Claude agents, generate a migration plan for an oversized backend agent, then run the validation gate to confirm the refactoring meets project standards.

Quick Start

Use the agent-density-auditor skill to measure all Claude Code agents in the project, identify violations, and generate a migration plan for each oversized agent.

Frequently Asked Questions about agent-density-auditor

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

FAQPage Schema
How do I reduce context rot in Claude Code agent prompts?

To reduce context rot in Claude Code agent prompts, audit agent prompt density to enforce line limits and identify oversized sections. This process measures body lines and estimated tokens to keep agents lean, focused, and reliable.

What is agent prompt density and why does it matter for Claude Code?

Agent prompt density measures the volume of text, body lines, and estimated tokens within Claude Code agent files. High density causes context rot, hallucinations, and drift, making prompt density measurement critical for efficient token usage and agent reliability.

How do I generate a migration plan for an oversized Claude Code agent?

To generate a migration plan for an oversized Claude Code agent, analyze the agent prompt to classify sections and recommend content to keep, extract into references, or transform into reusable skills, ensuring compliance with density thresholds.

Can I use Python standard-library tooling to enforce validation gates after agent edits?

Yes, you can use Python standard-library tooling and shell scripts to run validation gates after agent edits. This enforces line limits, description length, and frontmatter conventions, returning compliance exit codes for VibeFlow project maintenance.

What are the limitations of enforcing VibeFlow ADR-029 density thresholds?

Enforcing VibeFlow ADR-029 density thresholds is limited to auditing agent bodies, skill files, bootstrap prompts, and descriptions. It requires shell and Python standard-library tooling, and focuses strictly on line limits and section-size warnings rather than semantic logic.