Skip to content
cccskills
FreePublished on GitHub

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 the user wants to stress-test a plan against their project's language and documented decisions.

The English summary is being prepared. Showing the original description.

See how to install

Files included (3)

  • SKILL.md2.5 KB
  • ADR-FORMAT.md1.1 KB
  • CONTEXT-FORMAT.md1.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Grill With Docs

Interview the user relentlessly about every aspect of this plan until there is shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one by one. For each question, provide your recommended answer.

Ask exactly one question at a time, waiting for feedback before continuing.

If a question can be answered by exploring the codebase, inspect the codebase instead of asking.

Domain Awareness

During codebase exploration, also look for existing documentation:

/
├── CONTEXT.md
├── docs/
│   └── adr/
└── src/

If a CONTEXT-MAP.md exists at the root, the repo has multiple contexts. The map points to where each one lives.

Create files lazily. If no CONTEXT.md exists, create one when the first term is resolved. If no docs/adr/ exists, create it when the first ADR is needed.

During The Session

Challenge Against The Glossary

When the user uses a term that conflicts with existing language in CONTEXT.md, call it out immediately.

Sharpen Fuzzy Language

When the user uses vague or overloaded terms, propose a precise canonical term.

Discuss Concrete Scenarios

When domain relationships are being discussed, stress-test them with specific scenarios that probe edge cases and force precise boundaries between concepts.

Cross-Reference With Code

When the user states how something works, check whether the code agrees. If you find a contradiction, surface it.

Update CONTEXT.md Inline

When a term is resolved, update CONTEXT.md immediately. Use CONTEXT-FORMAT.md.

Do not couple CONTEXT.md to implementation details. Only include terms that are meaningful to domain experts.

Offer ADRs Sparingly

Only offer to create an ADR when all three are true:

  1. Hard to reverse: the cost of changing your mind later is meaningful.
  2. Surprising without context: a future reader will wonder why it was done this way.
  3. Real trade-off: there were genuine alternatives and one was picked for specific reasons.

If any condition is missing, skip the ADR. Use ADR-FORMAT.md.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when the user wants to stress-test a plan, get grilled on their design, or mentions "grill me" outside an Odoo-specific context.

The English summary is being prepared. Showing the original description.

mart337i/odoo-skills59Updated Oct 2, 2026

Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.

The English summary is being prepared. Showing the original description.

mart337i/odoo-skills59Updated Oct 2, 2026

odoo

Free

Odoo engineering workflows for addon development, codebase exploration, debugging, architecture/refactor review, manifest/docs sync, and routing to migration work. Use when the user mentions Odoo, addons, modules, manifests, models, XML views, security CSVs, record rules, Odoo shell, OWL/QWeb/assets, or when an Odoo codebase is detected.

The English summary is being prepared. Showing the original description.

mart337i/odoo-skills59Updated Oct 2, 2026

Odoo 17 development reference for Python models and ORM (search, domain, read_group, compute fields), XML/CSV data and views, OWL/JS client code, QWeb reports, security (ACL, record rules, groups), cron and server actions, migrations and module upgrades, tests, i18n, and performance. Use this skill whenever work involves Odoo 17 or custom addons, including traceback diagnosis, addons, manifests, XML errors, HTTP controllers, business rules, feature work, refactoring, or reviews.

The English summary is being prepared. Showing the original description.

mart337i/odoo-skills59Updated Oct 2, 2026

Odoo 18 development reference for Python models and ORM (search, domain, read_group, compute fields), XML/CSV data and views, OWL/JS client code, QWeb reports, security (ACL, record rules, groups), cron and server actions, migrations and module upgrades, tests, i18n, and performance. Use this skill whenever work involves Odoo 18 or custom addons, including traceback diagnosis, addons, manifests, XML errors, HTTP controllers, business rules, feature work, refactoring, or reviews.

The English summary is being prepared. Showing the original description.

mart337i/odoo-skills59Updated Oct 2, 2026

Odoo 19 development knowledge base covering actions, controllers, data files, API decorators, SQL constraints, indexes, modules, fields, manifests, mixins, ORM methods, migrations, OWL components, performance, QWeb reports, security, testing, transactions, translations, and XML views. Use when writing, reviewing, or debugging Odoo 19 Python, XML, or JavaScript code, creating or modifying modules, fixing performance issues, or looking up Odoo 19 API patterns and best practices.

The English summary is being prepared. Showing the original description.

mart337i/odoo-skills59Updated Oct 2, 2026

See all skills by mart337i

Report a problem with this skill