grill with docs

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.md

Copy 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.