claude-skills/docs/skills/engineering/grill-me.md
Claude cc8ff7c2d6
docs(v2.6.0): add Pocock skills/agents to docs site + refresh stale counts
Adds the 4 new Matt Pocock-derived skills + 4 cs-* agent pages to the
github.io docs site (Material for MkDocs). Refreshes stale skill counts
across index.md + mkdocs.yml site_description.

Auto-generated via scripts/generate-docs.py (the established generator
that v2.5.7 fixed the dedup bug in):

New skill pages (docs/skills/engineering/):
- caveman.md
- grill-me.md
- handoff.md
- write-a-skill.md

New agent pages (docs/agents/):
- cs-caveman-mode.md
- cs-grill-master.md
- cs-handoff-author.md
- cs-skill-author.md

mkdocs.yml nav additions:
- Engineering POWERFUL section: 4 new entries after Ship Gate, labeled
  "(Matt Pocock-derived)" for clear attribution
- Agents section: 4 new entries after CS VPE Advisor, same labeling
- site_description: 268 → 272 skills; 33 → 37 cs-* agents; 21 → 25 /cs:*
  commands; explicit Pocock quartet callout

docs/index.md refresh:
- title: 246 → 272 Agent Skills
- description: refreshed with v2.6.0 Pocock-quartet callout
- hero subtitle: 246 → 272 skills; 20 → 37 cs-* agents
- "What's Inside" cards: 246 → 272 Skills; 20 → 37 Agents

Side-effect (additive only, non-blocking):
- 2 pre-existing ra-qm-team skills (EU AI Act Specialist + ISO 42001
  Specialist) finally generated their canonical docs pages (they had
  SKILL.md files but no docs/ entries). The long-named dual-publish
  duplicates were removed to avoid the v2.5.7 dedup regression.

Build verified: 412 HTML pages generated in 18.17s (was 357 in v2.5.7).
All 4 new skill pages + 4 new agent pages present in build output.
No new warnings from our additions (only generic Material for MkDocs
2.0 upgrade notice that pre-dates this PR).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 22:28:51 +00:00

3 KiB

title description
Grill Me — Agent Skill for Codex & OpenClaw Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw.

Grill Me

:material-rocket-launch: Engineering - POWERFUL :material-identifier: `grill-me` :material-github: Source
Install: claude /plugin install engineering-advanced-skills

Derived from Matt Pocock's grill-me (MIT). Matt's interview discipline preserved verbatim. Additions: extraction + question + session tools + references + cs-* wrapper (see references/companion_tooling.md).

Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.

Ask the questions one at a time.

If a question can be answered by exploring the codebase, explore the codebase instead.

Rules (preserved + amplified)

  1. One question per turn. Never bundle.
  2. Provide a recommended answer with each question. Defaulting to "what do you think?" is lazy.
  3. Explore the codebase before asking. If grep / Read resolves it, do that first. Saves a turn.
  4. Walk the tree depth-first. Finish a branch before opening another.
  5. Track dependencies. If decision B depends on decision A, ask A first.

Workflow

  1. User provides a plan or design (or path to one).
  2. Run scripts/decision_tree_extractor.py to extract branches.
  3. Run scripts/question_generator.py to produce the question list with recommendations.
  4. Start a session: scripts/grill_session_tracker.py --action start.
  5. Walk the tree, one question at a time, recording answers in the session.
  6. When all branches resolved: report "shared understanding reached" + the locked-in decisions.

Output Pattern

Per question turn:

Q[i]/[total]: [question]
Recommended answer: [your call + 1-sentence rationale]

(Or: I explored the codebase and found [evidence]. Confirm?)

Tooling

See references/companion_tooling.md. Tools: extractor + generator + tracker. Agent: cs-grill-master. Command: /cs:grill-me.


Version: 1.0.0 Derived: Matt Pocock (MIT) + this repo's wrapper