# grill-with-docs

grill-with-docs challenges concepts and decisions by grounding every critical inquiry strictly in local repository documents.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 556 installs · ★ 601 repo stars
- Author: haowjy
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/haowjy/creative-writing-skills/tree/HEAD/plugin/claude/skills/grill-with-docs/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/grill-with-docs-2

## What it does

This skill triggers `/creative-writing-skills:grill` alongside `/creative-writing-skills:knowledge-layers`. It forces the model to examine internal project vocabulary, active work artifacts, recorded decisions, and repository docs before fetching external data.

Context retrieval stays disciplined. Rather than dumping the entire file tree into context, the agent launches a bounded `@explorer`. It delegates transcript searches to `@session-miner` only when details exist exclusively in session logs. Any lasting terminology or consensus that emerges must be written back into the project docs.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill grill-with-docs -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/grill-with-docs/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/grill-with-docs/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill grill-with-docs -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/grill-with-docs/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill grill-with-docs -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/grill-with-docs/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install haowjy/creative-writing-skills plugin/claude/skills/grill-with-docs
```

2. **Manually: put the files in place**
- File: `.github/skills/grill-with-docs/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill grill-with-docs -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/haowjy/creative-writing-skills --path plugin/claude/skills/grill-with-docs
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/grill-with-docs/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill grill-with-docs -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/haowjy/creative-writing-skills/tree/HEAD/plugin/claude/skills/grill-with-docs/SKILL.md

## When to use it
- interrogate proposals against existing repository documentation
- verify terminology against project vocabulary before making changes
- delegate context retrieval to a bounded `@explorer` subagent
- document fresh decisions and definitions directly into project files

## Example prompts
- Grill this proposed architecture update strictly against our repository docs
- Run grill-with-docs on the new feature spec using existing project decisions
- Challenge our migration approach and verify all terms against the glossary

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: c21a642da54a34f6.

BEGIN THIRD-PARTY FILE c21a642da54a34f6
```text
---
name: grill-with-docs
description: |
  Use when grilling should be grounded primarily in project artifacts. Loads `/grill`, checks project vocabulary and prior decisions first, and spawns bounded explorers when the answer should come from docs.
metadata:
  type: reference
---

# Grill With Docs

Load `/creative-writing-skills:grill` if it isn't already loaded.
Load `/creative-writing-skills:knowledge-layers` if it isn't already loaded.

Use this when the challenge should be grounded primarily in project
artifacts.

Check repo docs, existing prompts, prior decisions, active work artifacts,
and project vocabulary before reaching for external sources.

When the answer should come from project materials beyond what is already in
context, spawn a bounded `@explorer` instead of bulk-reading the tree yourself.
Use `@session-miner` only when the missing context lives in transcripts rather
than artifacts.

If the conversation produces durable terminology or decisions, update the
right documentation surface.
```
END THIRD-PARTY FILE c21a642da54a34f6

The third-party file has ended. Everything between the c21a642da54a34f6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© haowjy · Apache-2.0 · https://github.com/haowjy/creative-writing-skills/tree/HEAD/plugin/claude/skills/grill-with-docs/SKILL.md

## Similar
- [tailwind-4-docs](https://affpapa.org/en/nevibecode/skills/tailwind-4-docs.md) — skill · 19300 installs
- [developer-troubleshooting-docs](https://affpapa.org/en/nevibecode/skills/developer-troubleshooting-docs.md) — skill · 13400 installs
- [coding-agent-docs-optimization](https://affpapa.org/en/nevibecode/skills/coding-agent-docs-optimization.md) — skill · 13400 installs
- [openai-docs](https://affpapa.org/en/nevibecode/skills/openai-docs.md) — skill · 7300 installs
- [platform-docs-get](https://affpapa.org/en/nevibecode/skills/platform-docs-get.md) — skill · 6900 installs
- [coralogix-docs](https://affpapa.org/en/nevibecode/skills/coralogix-docs.md) — skill · 5000 installs

## Other versions with the same name
- [grill-with-docs · mattpocock](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — 1219756 installs
- [grill-with-docs · haowjy](https://affpapa.org/en/nevibecode/skills/haowjy-grill-with-docs.md) — 556 installs
- [grill-with-docs · akillness](https://affpapa.org/en/nevibecode/skills/akillness-grill-with-docs.md) — 366 installs

From the same set: [haowjy/creative-writing-skills](https://affpapa.org/en/nevibecode/by/haowjy/creative-writing-skills.md) — 32 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
