do-bitter-pill

Audits AI instruction sets for over-prompting and classifies each rule for removal or retention.

2|Updated May 25, 2026
One-click install
npx skills add https://github.com/edheltzel/Do-Skills --skill do-bitter-pill-edheltzel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: do-bitter-pill
Source: https://github.com/edheltzel/Do-Skills/tree/main/skills/operations/do-bitter-pill
Command: npx skills add https://github.com/edheltzel/Do-Skills --skill do-bitter-pill-edheltzel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI instruction files like CLAUDE.md and AGENTS.md accumulate rules that restate model defaults, contradict each other, duplicate guidance, or preserve stale one-off workarounds, wasting context tokens and degrading agent behavior. ## Core Features & Use Cases - Six-Test Audit: Evaluates every rule against default behavior, contradiction, redundancy, one-off fixes, vagueness, and HOW-versus-WHAT reasoning choreography. - Seven-Way Classification: Labels each rule as CUT, RESOLVE, MERGE, EVALUATE, SHARPEN, MOVE, or KEEP with a structured report including estimated token savings. - Two Workflows: A full Audit workflow for entire instruction hierarchies and a QuickCheck workflow for a single file or inline rule block. - Use Case: Point it at a repository's CLAUDE.md and AGENTS.md files to identify which instructions are load-bearing contracts and which are scaffolding that a more capable model no longer needs. ## Quick Start Audit the CLAUDE.md and AGENTS.md files in this repository for over-prompting and report which rules to cut, merge, or keep.

Frequently Asked Questions about do-bitter-pill

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

FAQPage Schema
How do I audit my CLAUDE.md file for unnecessary instructions?▼

Run the QuickCheck workflow on the file to identify independently actionable rules, apply the six tests for defaults, contradictions, redundancy, one-off fixes, vagueness, and reasoning choreography, then receive a verdict listing rules to cut, sharpen, or keep.

What is over-prompting in AI agent instructions?▼

Over-prompting is adding rules that restate behavior the model already enforces, duplicate other instructions, preserve one-off workarounds, or script reasoning steps where an outcome or constraint would suffice. The core test is whether a more capable model would make the rule unnecessary.

Does the audit modify my instruction files automatically?▼

No, the audit is read-only by default. It produces a classification report with recommended actions, and files are only changed after you explicitly request edits.

When should I use the full Audit workflow instead of QuickCheck?▼

Use the full Audit when reviewing an entire instruction hierarchy across a repository, including cross-source conflicts, loading evidence, and context-value estimates. Use QuickCheck for a single file or an inline rule block.

What is the difference between do-bitter-pill and do-red-team?▼

do-bitter-pill audits instruction sets for over-prompting and rule hygiene, while do-red-team attacks the logic of an idea. Use do-bitter-pill to trim setup files, not to critique arguments.