Add repo-pincer skill (codebase reverse-engineering)#27
Merged
Conversation
New skill under agent-design, sibling to agent-eval/agent-redteam — methodology-only, no scripts, since its tools (Glob/Grep/Read, the Explore agent) are already general-purpose. Same shape as the wiki skills: pure SKILL.md, no computation to ship. Two independent passes that must reconcile, closing like a pincer: - Pass 1 (top-down): claims ledger from README/docs/manifests/API surface - Pass 2 (bottom-up): as-built model from entry points through the actual implementation, traced only as far as needed to check a specific claim - Pass 3 (reconciliation): every claim classified Confirmed / Drift / Aspirational / Silent, ranked High/Medium/Low by whether it sits on a write path or safety boundary. The ranked discrepancy list is the deliverable, not either summary alone. /pincer [path or repo] [--depth quick|standard|thorough] — scoped to a single module by default, not the whole repo. Runs standalone (no MCP/wiki dependency). If a vault is connected, output optionally compiles into Sources/raw/ via the *existing* wiki-synthesizer / wiki-operator /source pipeline — zero changes needed to either skill. Registered in marketplace.json (agent-design category) and README (skill table + repo structure tree). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013H1oBwjtpzDLGreGTTjoP7
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
New skill:
repo-pincer— reverse-engineers a codebase by reconciling top-down claims against bottom-up reality, closing on the discrepancies like a pincer.Why a separate skill, not folded into
agent-evalagent-evalgrades an agent's output;repo-pinceraudits a codebase's internal consistency (docs vs. implementation) — different subject matter, different trigger phrases. It also has less structural coupling toagent-evalthanagent-redteamdoes (no shared scoring engine, no JSONL output), andagent-redteamstayed a sibling despite that coupling. Folding this in would have muddiedagent-eval's domain-neutral trigger-matching and pushed it well past its ~500-line budget for no real benefit.The methodology
Two independent passes that must reconcile — the discrepancy between them is the actual finding, not either pass alone:
Scope
/pincer [path or repo] [--depth quick|standard|thorough]— defaults to a single module, not a whole-repo scan.No scripts — methodology only
Same shape as the wiki skills, not
agent-eval/agent-redteam/deid-reid-harness: its tools (Glob/Grep/Read, theExploreagent) are already general-purpose, so there's nothing to compute or ship as code.Integration — zero changes to existing skills
If a vault is connected, output optionally writes to
Sources/raw/<repo>-pincer-<date>.md— the existing raw-capture convention.wiki-synthesizer/wiki-operator /sourcepicks it up unchanged. Runs fully standalone otherwise; no MCP dependency.Files
skills/repo-pincer/SKILL.md— the skill (77 lines).claude-plugin/marketplace.json— registered underagent-design, grouped withagent-eval/agent-redteam/deid-reid-harnessREADME.md— skill table + repo structure treeDocs-only skill, no runnable code — marketplace JSON validated (8 plugins, correct category grouping).
🤖 Generated with Claude Code
Generated by Claude Code