ai-raccoon-manual-checklist

Runs an evidence-backed manual verification checklist against a live AiRaccoon build.

2|Updated Jul 18, 2026
One-click install
npx skills add https://github.com/Arasz/ai-badger --skill ai-raccoon-manual-checklist-arasz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-raccoon-manual-checklist
Source: https://github.com/Arasz/ai-badger/tree/main/features/ai-raccoon/skills/ai-raccoon-manual-checklist
Command: npx skills add https://github.com/Arasz/ai-badger --skill ai-raccoon-manual-checklist-arasz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Automated tests cannot verify behavior that only appears in a real install — a real server, a real global tool, a real data bank. This Skill structures that hand-run verification so every checklist answer is backed by the command that was run and the output that was read, making a filled checklist distinguishable from a plausible-sounding one. ## Core Features & Use Cases - Derived facts, not pinned ones: scripts/derive-facts.py reads the version, MCP tool count, and prompt count from the source tree at run time and fails loudly on zero, so the checklist compares the running binary against what the tree actually says. - Evidence-required template: templates/checklist-template.json forces every item to record the exact command, verbatim evidence, observed result, a tri-state status (pass/fail/skipped/substituted), and an explicit acceptance decision. - Anti-rot design: documents six ways predecessor checklists silently drifted — pinned versions, steps for deleted features, inherited verdict reasons — and the defenses against each. - Use Case: Before shipping an AiRaccoon release, run the checklist to force-update the global tool, verify the server lifecycle on a non-default port, exercise the write/read/noise-filter paths against a scratch data root, and record the filled checklist under docs/work/checklist/. ## Quick Start Ask the agent to run the AiRaccoon manual checklist against the current repository and write the filled results to docs/work/checklist/.

Frequently Asked Questions about ai-raccoon-manual-checklist

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

FAQPage Schema
How do I manually verify an AiRaccoon build before release?

Copy templates/checklist-template.json to docs/work/checklist/, run scripts/derive-facts.py to get the version and MCP tool/prompt counts, then work each item recording the exact command, verbatim evidence, status, and acceptance decision for every step.

What does the manual checklist cover that dotnet test cannot?

It covers behavior that only appears in a real install: force-updating the global tool, server start and restart on a non-default port, write/read paths against a real bank, noise filtering, file watch status, the promotion queue, and the full MCP tool surface.

Why does derive-facts.py exit with an error instead of returning zero counts?

A zero count usually means a path moved, not that there are no tools. The script treats zero as a failure and exits 1 with the reason, because a confident wrong zero has silently stale-pinned checklists in the past.

Can I run the checklist against my live ~/.ai-raccoon bank?

No. Never write to the live bank; read it only through read-only mode. The checklist's own writes go to a scratch data root created with --data-root, and servers must bind with --port 0 rather than the default port 7721.

When should I not use this manual checklist?

Skip it for anything dotnet test already covers, for judging a diff or PR (that is code review), and for debugging one failing symptom. The checklist finds what is broken; tracing why belongs elsewhere.