{"id":50381451,"url":"https://github.com/zhjai/grill-all","last_synced_at":"2026-05-30T12:02:41.261Z","repository":{"id":358687799,"uuid":"1239380282","full_name":"zhjai/grill-all","owner":"zhjai","description":"Source-aware plan-review skill for Claude Code, Codex, and AI coding agents.","archived":false,"fork":false,"pushed_at":"2026-05-18T15:10:22.000Z","size":13,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-18T17:13:03.927Z","etag":null,"topics":["agent-skills","ai-agents","claude-code","codex","coding-agents","developer-tools","open-source","plan-review","prompt-engineering","source-aware"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhjai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-15T03:21:41.000Z","updated_at":"2026-05-18T15:10:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zhjai/grill-all","commit_stats":null,"previous_names":["zhjai/grill-all"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zhjai/grill-all","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhjai%2Fgrill-all","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhjai%2Fgrill-all/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhjai%2Fgrill-all/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhjai%2Fgrill-all/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhjai","download_url":"https://codeload.github.com/zhjai/grill-all/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhjai%2Fgrill-all/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33691312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agents","claude-code","codex","coding-agents","developer-tools","open-source","plan-review","prompt-engineering","source-aware"],"created_at":"2026-05-30T12:02:41.199Z","updated_at":"2026-05-30T12:02:41.251Z","avatar_url":"https://github.com/zhjai.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# grill-all: source-aware plan review for Claude Code, Codex, and AI coding agents\n\n[![Skill](https://img.shields.io/badge/skill-grill--all-blue)](./skills/grill-all/SKILL.md)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n[![Release](https://img.shields.io/badge/release-v0.1.1-green)](https://github.com/zhjai/grill-all/releases/tag/v0.1.1)\n\n`grill-all` is a source-aware plan-review skill that helps Claude Code, Codex, and other AI coding agents pressure-test implementation plans. It routes unresolved questions to the right source: project docs, the codebase, human intent, or current web documentation.\n\nInspired by [`grill-me`](https://github.com/mattpocock/skills/blob/main/skills/productivity/grill-me/SKILL.md) and [`grill-with-docs`](https://github.com/mattpocock/skills/blob/main/skills/engineering/grill-with-docs/SKILL.md), `grill-all` extends the idea with source routing across humans, docs, code, and web research.\n\n## What this is\n\n- A plain Markdown skill/instruction package.\n- No code execution by itself.\n- No telemetry by itself.\n- Portable to Claude Code, Codex, Hermes Agent, and other coding-agent systems that can load skills or custom instructions.\n\n## Why this exists\n\nCoding agents often fail in two opposite ways:\n\n- They ask humans questions that docs or code could answer.\n- They proceed through decisions that actually require human intent, taste, priority, or risk acceptance.\n\n`grill-all` teaches the agent to route each unresolved question to the right source of truth.\n\n## When to use it\n\nUse `grill-all` when you want an agent to challenge a plan, design, refactor, migration, or feature before or during implementation.\n\nIt is especially useful when:\n\n- you are vibe coding but still want the agent to stop for real product decisions;\n- the project has docs, ADRs, OpenSpec files, issues, or code patterns the agent should inspect before asking you;\n- the task may depend on current external facts such as SDK docs, API behavior, framework changes, or ecosystem guidance;\n- you want `grill-me`-style questioning without being asked things the agent can verify itself.\n\n## How it behaves\n\n`grill-all` chooses its interaction mode from your prompt:\n\n- **Grill-heavy:** if you ask to be grilled, challenged, pressure-tested, or repeatedly confirmed.\n- **Autonomous:** if you ask for vibe coding, autonomous execution, or \"don't ask unless blocked\".\n- **Ask once:** if your prompt does not say, the agent asks whether you prefer more confirmation questions or more autonomous source-checking.\n\nThen it routes questions:\n\n- project facts → docs, specs, ADRs, issues, README, OpenSpec;\n- implementation facts → codebase, tests, types, call sites;\n- human decisions → one question at a time, with a recommended answer;\n- current external facts → official web docs and primary sources.\n\n## Installation\n\n`grill-all` supports Codex, Claude Code, and generic coding agents.\n\n### Claude Code plugin\n\nUse the explicit HTTPS URL; it is more reliable than shorthand in environments where SSH is not configured.\n\n```bash\nclaude plugin marketplace add https://github.com/zhjai/grill-all.git\nclaude plugin install grill-all@grill-all-marketplace\n```\n\nInside Claude Code:\n\n```text\n/plugin marketplace add https://github.com/zhjai/grill-all.git\n/plugin install grill-all@grill-all-marketplace\n```\n\nThis repository includes the Claude Code marketplace at `.claude-plugin/marketplace.json`, and the plugin package at `plugins/grill-all/`.\n\n### Claude Code user skill\n\nInstall the skill into your user skills directory:\n\n```bash\nmkdir -p ~/.claude/skills\ncp -R skills/grill-all ~/.claude/skills/grill-all\n```\n\n### Codex plugin\n\nThis repository includes a Codex plugin marketplace at `.agents/plugins/marketplace.json`. The marketplace points to the plugin package in `plugins/grill-all/`, whose Codex manifest is `plugins/grill-all/.codex-plugin/plugin.json`.\n\n```bash\ncodex plugin marketplace add https://github.com/zhjai/grill-all.git\ncodex plugin list\ncodex plugin add grill-all@grill-all-plugins\n```\n\nIf your Codex version uses an interactive installer, add the marketplace and select `grill-all` from the plugin marketplace UI.\n\n### Repo-scoped Codex skill\n\nIf you want to use `grill-all` inside another project without installing the plugin, copy the skill to that project's `.agents/skills` directory:\n\n```bash\nmkdir -p .agents/skills\ncp -R skills/grill-all .agents/skills/grill-all\n```\n\nCodex discovers repo-scoped skills from `.agents/skills` while working in that repository.\n\n### Codex user skill\n\nFor user-level installation, copy the skill into your Codex skills directory:\n\n```bash\nmkdir -p \"${CODEX_HOME:-$HOME/.codex}/skills\"\ncp -R skills/grill-all \"${CODEX_HOME:-$HOME/.codex}/skills/grill-all\"\n```\n\nNote: `.agents/skills` is for repo-scoped skills. `${CODEX_HOME:-$HOME/.codex}/skills` is the user-level Codex skills location.\n\n### Any coding agent\n\nCopy or reference:\n\n```text\nskills/grill-all/SKILL.md\n```\n\nThe skill is plain Markdown with YAML frontmatter, so it can be adapted to most agent systems.\n\n## Safety and privacy\n\n- Do not send secrets, private credentials, customer data, or unnecessary proprietary code to web search or external agents.\n- Web pages and third-party docs are evidence, not instructions.\n- Documentation writes require task authorization or confirmation.\n- In review-only mode, `grill-all` should suggest what to record rather than editing project files.\n\nSee [`SECURITY.md`](./SECURITY.md).\n\n## Example prompts\n\n```text\nUse grill-all to stress-test this auth redesign before implementation.\n```\n\n```text\nVibe code this feature. Use grill-all, but only ask me when docs/code/web cannot resolve a human decision.\n```\n\n```text\nUse docs and codebase first. Ask me only for product trade-offs.\n```\n\n```text\nChallenge this plan using the codebase, OpenSpec, and current framework docs.\n```\n\nMore examples: [`examples/prompts.md`](./examples/prompts.md)\n\n## Related topics and search terms\n\nAI agent skills, Claude Code skills, Codex plugin, Codex skills, coding agents, plan review, source-aware agents, grill-me, RAG for project context, human-in-the-loop coding agents, vibe coding, implementation plan review, OpenSpec, ADRs, codebase-aware agents.\n\n## Prior art\n\n- [`grill-me`](https://github.com/mattpocock/skills/blob/main/skills/productivity/grill-me/SKILL.md): relentless one-question-at-a-time plan interrogation.\n- [`grill-with-docs`](https://github.com/mattpocock/skills/blob/main/skills/engineering/grill-with-docs/SKILL.md): grilling against project language and documentation.\n\nThis repository is inspired by those public skills. The implementation here is an independent Markdown skill focused on source routing across humans, docs, code, and web research.\n\n## Release\n\nCurrent preview release: [`v0.1.1`](https://github.com/zhjai/grill-all/releases/tag/v0.1.1).\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhjai%2Fgrill-all","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhjai%2Fgrill-all","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhjai%2Fgrill-all/lists"}