grill with docs
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
Overview
The grill with docs skill, hosted in the mxyhi/ok-skills repository, provides a structured environment for refining technical plans through critical analysis. It functions by challenging proposed strategies against an existing domain model to ensure terminology consistency and architectural alignment. As decisions are finalized during the session, the tool facilitates inline updates to project documentation, specifically targeting files like CONTEXT.md and Architectural Decision Records (ADRs). This skill is compatible with various AI agents, including Codex, Claude-code, and Cursor. By integrating with the mxyhi/ok-skills ecosystem—a project with over 400 stars on GitHub—it helps developers maintain documentation accuracy while pressure-testing new features or design changes. It is particularly useful for projects involving complex design requirements or ROS-based systems.
Use Cases
Install Notes
# Review source first
open https://github.com/mxyhi/ok-skills/blob/main/grill-with-docs/SKILL.mdCopy or clone the skill folder into your agent skills directory after reviewing its instructions and scripts.
Security Notes
Users should review the skill's access to local project files, as it performs inline modifications to documentation like CONTEXT.md and ADRs. Ensure that the AI agent's environment is configured with appropriate file system permissions and that sensitive data is not inadvertently exposed during the automated documentation update process within the mxyhi/ok-skills framework.
Related Skills
internal comms
anthropics/skills
A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project update
Find Skills
mxyhi/ok-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
caveman
mxyhi/ok-skills
Respond terse like smart caveman. All technical substance stay. Only fluff die.
Diagnose
mxyhi/ok-skills
Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
grill me
mxyhi/ok-skills
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
Dogfood
mxyhi/ok-skills
Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step