# Claudex Grill With Docs

> Run a documented grilling session in claudex with Claude leading the interview and the GPT/Codex-family grill-advisor challenging the opening design tree and auditing the final decisions. Use when the user wants Claude and Codex to stress-test a plan or design together while recording ADRs and domain terminology.

- **Type:** Skill
- **Install:** `agentstack add skill-tschuehly-skill-incubator-claudex-grill-with-docs`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tschuehly](https://agentstack.voostack.com/s/tschuehly)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tschuehly](https://github.com/tschuehly)
- **Source:** https://github.com/tschuehly/skill-incubator/tree/master/skills/claudex-grill-with-docs

## Install

```sh
agentstack add skill-tschuehly-skill-incubator-claudex-grill-with-docs
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Claudex Grill with Docs

Compose `/grilling`, `/domain-modeling`, `/atelier`, and `/agent-orchestration`. Claude owns the
conversation and documentation; the `grill-advisor` agent (`gpt-5.6-sol`) acts as the
Codex advisor. This skill fixes that advisor binding; use `/model-orchestration` only for
broader routing and quota policy outside this composition.

## Workflow

1. Confirm the session is running under `claudex` and the `grill-advisor` agent is
   available. If it is unavailable or its model fails to resolve, explain that the
   cross-family session cannot run and do not claim that Codex participated.
2. Establish the target. If the user named a doc, branch, handoff file, or topic,
   use it — a handoff passed as an argument is the target; read it first. If none is
   given, ask what to grill. Do not spelunk the repo to guess the topic.
3. Gather facts from the codebase and supplied documents. Distill the plan,
   constraints, known facts, and unresolved decisions; do not give the advisor raw
   file dumps.
4. Before asking the first question, start one persistent `grill-advisor`. Ask it to
   identify the consequential assumptions, missing branches, contradictions, and
   highest-value questions, with a recommended answer for each.
5. Use those findings as input to a `/grilling` session that maintains docs via
   `/domain-modeling`. Follow both contracts: work one decision at a time,
   recommend an answer, resolve discoverable facts without asking the user, and
   maintain the ADRs and glossary as decisions settle. Present each decision richly — the tension, a
   worked example, the verified facts (with `file:line`), and your recommendation —
   never a bare one-line question. Present the decisions on an `/atelier` surface
   with one Review Unit per decision. Apply `/agent-orchestration` for collaborator
   reuse, compact handoffs, durable state, continuity, and one human-facing voice.
6. Synthesize the advisor's advice into the grill; do not invoke the advisor before
   every question.
7. Before declaring shared understanding, distill the settled decisions, rationale,
   glossary, and remaining uncertainties. Continue the same `grill-advisor` with
   that compact delta for an adversarial completeness check.
8. If the final check finds a material gap, resume the grill one decision at a time.
   Otherwise, present the intended-state documents for confirmation.
9. Do not implement the plan, or ratify ADRs and glossary terms as decided, until
   the user explicitly confirms shared understanding.

Treat the two advisor calls as the default budget. Add another only when new
information materially invalidates an earlier branch.

## AFK / autonomous convergence

When the user says they are away and asks you to iterate to shared understanding
without them, the advisor stands in for the human interviewer:

- Run `grill-advisor` rounds (distill → challenge → correct → re-check) until the
  advisor confirms shared understanding or you reach the round budget. Apply
  `/agent-orchestration` to continue the advisor and preserve resumable state.
- Leave every decision as an open proposal on the surface; mark nothing decided.
  ADR and glossary ratification still waits for explicit human signoff (step 9).
- End with the durable grill record ready for resumption.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tschuehly](https://github.com/tschuehly)
- **Source:** [tschuehly/skill-incubator](https://github.com/tschuehly/skill-incubator)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tschuehly-skill-incubator-claudex-grill-with-docs
- Seller: https://agentstack.voostack.com/s/tschuehly
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.