bouncer
install
source · Clone the upstream repo
git clone https://github.com/buildingopen/bouncer
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/buildingopen/bouncer "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skill" ~/.claude/skills/buildingopen-bouncer-bouncer && rm -rf "$T"
manifest:
skill/SKILL.mdsource content
Bouncer - On-Demand Quality Audit
Works for any task type: code, creative work, videos, advice, research, operations.
Mode Selection
- Quick (default):
or "score" or "audit"/bouncer - Deep:
or "deep audit" or "verify everything"/bouncer deep
Quick Audit
Step 1: Gather context (adapt to the task type)
For code changes: Run git diff:
git diff --stat --no-color git diff --no-color git diff --cached --stat --no-color git diff --cached --no-color
For non-code work (videos, stories, advice, research): Skip git diff. The
assistant_text summary is the primary input.
Step 2: Read CLAUDE.md
from the current working directory (if it exists).
CLAUDE.mdStep 3: Build a JSON object and pipe it to the bouncer script:
: THE MOST IMPORTANT FIELD. A thorough summary of what you did this session. Be specific:assistant_text- For code: files changed, bugs fixed, tests written, commands run
- For creative: what you created, the goal, the audience, key decisions made
- For videos: the script/story, visual choices, duration, format, iterations
- For advice: the question asked, your recommendation, reasoning, alternatives considered
- For research: what you found, sources checked, conclusions drawn
- CRITICAL: If the staged diff includes changes from prior sessions, note this.
: Git diff stat (empty string if no code changes or not applicable)diff_stat
: Git diff (empty string if not applicable)diff_text
: The CLAUDE.md contents (empty string if no CLAUDE.md)context
Step 4: Run:
echo '<the JSON object>' | python3 ~/.claude/skills/bouncer/scripts/bouncer-check.py
Step 5: Present results exactly as printed.
Deep Audit
For code-heavy tasks where you want Gemini to independently verify claims.
Step 1: Gather context (same as quick audit).
Step 2: Read CLAUDE.md
from the current working directory (if it exists).
CLAUDE.mdStep 3: Build a JSON object with:
: Same thorough summary as quick auditassistant_text
: Git diff (empty string if not applicable)diff_text
: The CLAUDE.md contents (empty string if no CLAUDE.md)context
: The current working directory (absolute path)cwd
Step 4: Run:
echo '<the JSON object>' | python3 ~/.claude/skills/bouncer/scripts/bouncer-deep.py
Step 5: Present ALL results exactly as printed.
Important
- Do NOT skip or filter any output from the scripts.
- If the script fails (missing API key, import error), show the error to the user.
- The
field should be YOUR honest, detailed summary. Not a copy of user messages. The richer the summary, the better the audit.assistant_text - Deep audit takes 30-120 seconds. Tell the user it will take a moment.
- For non-code tasks,
carries all the weight. Make it thorough.assistant_text