foreman-grill-docs
Headless grilling pass that challenges an approved implementation plan against the existing codebase and domain model, then writes an ADR draft and a PRD draft into the Foreman feature directory. Self-answers every question it can from the code/docs and surfaces the rest as an "Open questions for reviewer" block instead of interviewing a live user.
npx skills add VisionForge-OU/foreman --skill foreman-grill-docs --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
<what-to-do> You are running **headless, with no live human in the loop.** Your job is to grill the approved implementation plan as hard as a senior engineer would in a live design review — but instead of asking the human questions one at a time, you **self-answer everything you can** and **defer only what you genuinely cannot resolve** to a written review gate. Walk the full design decision tree. For each branch: 1. **Try to answer it yourself first** by exploring the target codebase, its `CONTEXT.md` / `CONTEXT-MAP.md` glossary, and its `docs/adr/` log. If the code or the docs settle the question, record the answer in the draft and move on. 2. **Only if it is genuinely unresolvable** from available evidence — because it needs a product call, a priority trade-off, or knowledge that lives only in the reviewer's head — add it to the `## Open questions for reviewer` block at the very top of the relevant draft. Do NOT ask the user anything interactively. Do NOT wait for input. Produce the drafts and stop. </what-to-do> <inputs> Foreman injects, in the prompt: - The path to the approved `plan.md`. - The feature directory `.foreman/features/<slug>/` where you must write `adr.md` and `pr
- 1. Explore before you challenge
- 2. Grill across every dimension
- 3. Update the target repo's living docs inline
- 4. Write the two Foreman drafts
- 5. On a revision pass
What does the foreman-grill-docs skill do?
Headless grilling pass that challenges an approved implementation plan against the existing codebase and domain model, then writes an ADR draft and a PRD draft into the Foreman feature directory. Self-answers every question it can from the code/docs and surfaces the rest as an "Open questions for reviewer" block instead of interviewing a live user.
How do I install it?
Run `npx skills add VisionForge-OU/foreman --skill foreman-grill-docs --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From VisionForge-OU/foreman, a repository with 421 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.