capability-grill

Interviews users one question at a time with recommendations to align on requirements or stories.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/learnn-com/engineering-kb --skill capability-grill-learnn-com
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: capability-grill
Source: https://github.com/learnn-com/engineering-kb/tree/main/.skills/capability-grill
Command: npx skills add https://github.com/learnn-com/engineering-kb --skill capability-grill-learnn-com

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Gathering requirements and aligning on user stories often suffers from unasked questions, assumptions made on the user's behalf, and premature conclusions. This Skill structures AI-human interviews so every open aspect of a topic or story is explored, asked about individually, and confirmed before work proceeds. ## Core Features & Use Cases - Explore-before-asking: Reads the knowledge base, PRD, architecture docs, and codebase first so already-answerable facts are never asked as questions. - Two modes: interview mode explores a freeform topic into a raw requirements blob; sync mode systematically covers six story aspects (goal, acceptance criteria, edge cases, dependencies, design, risks) until explicit shared understanding is confirmed. - Recommendation-driven questions: Every question ships with a proposed answer, and "don't know" replies become flagged assumptions rather than blockers. - Write-free synthesis: Returns the synthesis to the caller or conversation, optionally saving a handoff file in .pair/working/ on interruption. - Use Case: A product manager refining story #142 invokes sync mode; the Skill skips aspects already covered in the draft, asks about missing risks and dependencies one at a time, and returns an alignment synthesis mapped to the user story template. ## Quick Start Ask the AI to grill you on a topic, for example: grill me on the caching strategy requirements for the API layer.

Frequently Asked Questions about capability-grill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I gather requirements through structured AI interviews?▼

Invoke the skill in interview mode with a topic, and it asks one question at a time, each with a recommended answer based on prior exploration of your docs and codebase. The session ends only after you explicitly confirm shared understanding, producing a raw requirements blob.

How to align AI and human understanding on a user story?▼

Use sync mode with a story identifier, and the skill walks through six aspects: goal, acceptance criteria, edge cases, dependencies, design, and risks. Aspects already covered in the story draft or codebase are skipped, and the result is an alignment synthesis mapped to the story template.

What happens if I answer don't know during an interview?▼

The recommended answer becomes a provisional answer and is flagged as an assumption in the final synthesis. It never blocks the session and is never silently dropped, so you can revisit flagged assumptions later.

Does the skill write requirements to files or issue trackers?▼

No, it is write-free by design and returns the synthesis to the caller or prints it in conversation. The only optional file it writes is a handoff in .pair/working/ when a session is interrupted or you explicitly request one.

What happens when an interview session gets interrupted?▼

If the session stops before explicit shared-understanding confirmation, the skill offers to save the partial synthesis plus per-aspect coverage state as a handoff file in .pair/working/. You can decline and keep the content in conversation instead.