An interactive AI design coaching and documentation skill that aligns system architecture using rigorous interviews, domain glossaries, and Architectural Decision Records (ADRs).
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install grill-docs
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install grill-docs using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Grill with Docs?
Grill with Docs is a system design alignment utility among the ecosystem of Openclaw Skills, designed to ruthlessly interrogate and refine architectural plans. Acting as an expert design partner, this skill conducts a relentless, branch-by-branch interview to uncover ambiguities, resolve domain conflicts, and establish shared understanding between developers and AI agents.
By probing edge cases and cross-referencing decisions against the existing codebase, it prevents domain drift and ensures alignment. Instead of waiting for the end of a session, it dynamically captures and updates domain terms inline inside a standardized documentation framework, making it a highly effective asset for team alignment.
Grill with Docs Use Cases
- Initiating a brand-new system architecture or microservice boundary plan using structured Openclaw Skills workflows.
- Reconciling vague or legacy terminology in complex codebases by sharpening fuzzy definitions.
- Deciding on critical architectural trade-offs that require high-impact, permanent documentation (such as Architectural Decision Records).
- Reviewing existing source code against theoretical specifications to flag contradictions or implementation mismatches.
How Grill with Docs Works
- Codebase Scan: The AI analyzes the repository's layout, detecting root files like CONTEXT-MAP.md or existing CONTEXT.md files to build system-wide awareness.
- Relentless Interviewing: The skill asks sharp, singular questions regarding design dependencies, proposing ideal alternatives and probing domain boundaries.
- Inline Glossary Editing: As definitions solidify, the AI lazily updates or creates the CONTEXT.md glossary, ensuring implementation-free conceptual integrity.
- Strict ADR Assessment: The agent filters decisions against strict criteria (reversibility, surprise-factor, actual trade-offs) to offer targeted ADR generation.
- Final Generation: Post-session, the AI outputs polished ADRs, a structured directory map, and a summary detailing resolved terms and remaining open items.
Grill with Docs Setup
To implement this tool within your active project directories utilizing Openclaw Skills configurations, construct your workspace profiles as follows:
# Navigate to your repository or workspace folder
cd your-project-repo
# Ensure you have your openclaw or AI assistant configuration files active
# Initialize or copy the grill-with-docs prompt into your active skills path
mkdir -p .claws/skills
cp grill-with-docs.md .claws/skills/
Configure your agent environment to recognize the system prompts, enabling automated file system checks and codebase exploration protocols automatically.
Grill with Docs Data Schema & Taxonomy
The skill enforces a clean, implementation-free documentation hierarchy across single or multi-context environments:
| Path | Purpose | Content Type |
|---|---|---|
CONTEXT.md |
Single-context domain glossary | Concepts, canonical terms, definitions |
CONTEXT-MAP.md |
Multi-context directory layout map | Pointers to distributed context roots |
docs/adr/ |
Global architectural decisions | High-impact architectural history (.md) |
src/<context>/CONTEXT.md |
Context-specific glossary | Local domain term mappings |
src/<context>/docs/adr/ |
Context-specific decisions | Local architectural history (.md) |
Grill with Docs Advanced Features
- Domain Mismatch Guardrails: Immediately alerts developers when a newly proposed concept collides with the pre-existing glossary terms.
- Lazy Document Creation: Creates CONTEXT.md and ADR files on-demand only when tangible terms are fully resolved, avoiding empty file clutter.
- Multi-Context Navigation: Adapts automatically to repository layouts that utilize a CONTEXT-MAP.md for federated domains.
- Strict ADR Gating: Leverages a three-tier logical test to ensure only high-impact, hard-to-reverse decisions receive formal ADR markdown files.
SKILL.md
Loading
Related Openclaw Skills
Self-Evolving Blueprint
A production-tested memory and self-evolution blueprint designed to give AI agents persistent contextual awareness and adaptive performance across sessions.
Career Path & Education Intelligence
An AI-powered career development and education planning skill that tracks global job market shifts, salary benchmarks, and education ROI across 800+ occupations.
Zoom Out
A structural analysis skill that directs AI agents to stop low-level code reading and synthesize a high-level architectural map of code modules, APIs, and dependencies.
Personal Finance & Wealth Intelligence
An AI-powered personal finance and wealth management intelligence engine designed to analyze portfolios, project retirement goals, and optimize debt payoff strategies.
Diagnose Skill
A disciplined, multi-phase diagnosis loop designed for AI agents to systematically reproduce, isolate, and resolve complex software bugs and performance regressions.
Hugging Face Agent Skill
An AI agent skill enabling cost-effective, secure discovery and multi-provider inference of open-source models and datasets on Hugging Face.
Featured*
