Reverse brief
Skill batteryshark/skill-tap/skills/productivity/reverse-brief
Reconstruct a concise implementation brief from an existing codebase or artifact when original requirements are missing, stale, or incomplete.From its SKILL.md
npx -y skills add batteryshark/skill-tap --skill reverse-briefAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.0 KB, 171 tokens by cl100k_base, as published. Nobody here has run it
Reconstruct an Implementation Brief
- Run
bin/reverse-brief PATHto collect a bounded repository inventory. - Inspect entry points, tests, public interfaces, configuration, examples, history, and user-visible text. Treat code as evidence of implementation, not proof of original intent.
- Write the brief using references/brief-template.md: problem, users, observed behavior, constraints, acceptance criteria, inferred decisions, contradictions, and open questions.
- Label every non-obvious statement as observed, inferred, or unknown. Cite concrete files and commands.
- Reconcile documentation against behavior and tests; surface contradictions instead of silently choosing a story.
Use agents/brief-reviewer.md for an independent intent-versus-evidence pass.
What ships with it: 4 files
2.1 KB alongside SKILL.md, 2 of them executable
agents/
- brief-reviewer.md292 B
bin/
- reverse-briefruns232 B
references/
- brief-template.md500 B
scripts/
- inventory.pyruns1.1 KB