ai-forge-recap

AI Forge Recap

Audit a skill or agent by reading its actual implementation and reporting what it really does — independent of what the description claims. The description is a claim; the body is the ground truth.

---

What to Read

Use the path provided or resolved by the environment. If not found, report "Not found" and stop.

For skills: also read any references/ files marked MANDATORY READ — behaviors that live outside the main body still count.

If a references/ directory exists but no files are marked MANDATORY READ, include this note in Undeclared behaviors: "references/ directory present but no MANDATORY READ triggers — possible Orphan References pattern."

For agents: read the full .agent.md file including frontmatter (model, tools, etc.).

For other file types (.instructions.md, CLAUDE.md, standalone prompts): read the full file; if the file has a leading comment or description block, treat it as the "description claim" to compare against the body.

---

What to Compare

The description makes four implicit claims. Check each against the body:

1. WHAT it does — does the body do this, or something adjacent?
2. WHEN to use it — do trigger phrases match actual entry conditions?
3. Keywords — do searchable terms reflect what the body covers?
4. Scope — does the description under- or over-state coverage?

Also scan for undeclared behaviors: things the body does that the description never mentions. Focus on locations where iterative edits silently accumulate new behavior: NEVER rules, phases/steps, skip/exit conditions, reference-loading triggers, confirmation loops, conditional output sections, and tool/skill invocations.

Short targets (<15 lines body): Focus on scope accuracy over exhaustive four-claim comparison. A minimal body with a matching description is Aligned — don't manufacture drift from brevity.

Before writing your verdict, ask: Would an agent picking from descriptions alone make the right call? If the description would misroute, that's Significant drift regardless of how small the wording gap appears.