{"id":"47360a50-94cb-4d00-8322-12bf0b179df6","shortId":"vccnn9","kind":"skill","title":"grill-me","tagline":"Context Engineering and Architecture Intelligence for the AI Era. Machine-readable, continuously validated architecture as code for AI-assisted development.","description":"# Grill Me - Shared Understanding Skill\n\nThis skill ensures AI and human share a design concept before writing code.\n\n## Description\n\nUse this skill when planning new features or significant changes. The AI will interview you relentlessly to reach shared understanding.\n\n## Usage\n\n```bash\n# Activate skill\n@skill:grill-me\n\n# Or use in prompt\n\"Grill me on this plan until we reach shared understanding.\"\n```\n\n## Process\n\n1. You describe what you want to build\n2. AI asks questions to clarify:\n   - What problem does this solve?\n   - Who is the user?\n   - What are the success criteria?\n   - What are the dependencies?\n   - What could go wrong?\n   - How do you measure success?\n3. Continue until AI has no more questions\n4. Document the shared understanding as PRD or issues\n\n## Questions AI Will Ask\n\n### Understanding Phase\n- What exactly are you trying to build?\n- Why is this important?\n- Who will use this?\n- What happens if we don't build it?\n\n### Requirements Phase\n- What are the acceptance criteria?\n- What are the edge cases?\n- What are the error conditions?\n- What are the performance requirements?\n\n### Architecture Phase\n- What does this depend on?\n- What will depend on this?\n- Where does this fit in the architecture?\n- What are the boundary conditions?\n\n### Implementation Phase\n- How will you verify this works?\n- What could go wrong in production?\n- What is the rollback plan?\n- How do you measure success?\n\n## Example\n\n```\nYou: I want to add a feature that shows code complexity\nAI: What problem does this solve?\nYou: Developers don't understand their code quality\nAI: What specifically do you want to measure?\nYou: Cyclomatic complexity\nAI: What threshold indicates \"too complex\"?\nYou: 10\nAI: What happens when it exceeds threshold?\nAI: [continues until full understanding]\n```\n\n## Output\n\nAfter grilling, produce:\n- Product Requirements Document (PRD)\n- Or direct to issues/tasks\n- Never start coding until shared understanding reached\n\n## Why This Matters\n\nFrom the talks: \"Me and the AI don't share a design concept.\"\n- Without shared understanding, AI produces garbage\n- Re-running compiler just produces more garbage\n- Solution: reach shared understanding first","tags":["grill","sruja","sruja-ai","adr","agent-skills","ai-driven-development","architecture","architecture-as-code","architecture-governance","developer-tools","governance","rust-lang"],"capabilities":["skill","source-sruja-ai","skill-grill-me","topic-adr","topic-agent-skills","topic-ai-driven-development","topic-architecture","topic-architecture-as-code","topic-architecture-governance","topic-developer-tools","topic-governance","topic-rust-lang","topic-software-architecture","topic-system-design","topic-wasm"],"categories":["sruja"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sruja-ai/sruja/grill-me","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sruja-ai/sruja","source_repo":"https://github.com/sruja-ai/sruja","install_from":"skills.sh"}},"qualityScore":"0.458","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 17 github stars · SKILL.md body (2,184 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:06:09.700Z","embedding":null,"createdAt":"2026-04-24T13:02:48.566Z","updatedAt":"2026-05-18T19:06:09.700Z","lastSeenAt":"2026-05-18T19:06:09.700Z","tsv":"'1':88 '10':289 '2':96 '3':129 '4':137 'accept':180 'activ':67 'add':250 'ai':11,23,34,56,97,132,147,257,271,282,290,297,330,340 'ai-assist':22 'architectur':7,18,197,215 'ask':98,149 'assist':24 'bash':66 'boundari':219 'build':95,158,173 'case':186 'chang':54 'clarifi':101 'code':20,43,255,269,316 'compil':346 'complex':256,281,287 'concept':40,336 'condit':191,220 'context':4 'continu':16,130,298 'could':121,230 'criteria':115,181 'cyclomat':280 'depend':119,202,206 'describ':90 'descript':44 'design':39,335 'develop':25,264 'direct':311 'document':138,308 'edg':185 'engin':5 'ensur':33 'era':12 'error':190 'exact':153 'exampl':245 'exceed':295 'featur':51,252 'first':355 'fit':212 'full':300 'garbag':342,350 'go':122,231 'grill':2,26,71,77,304 'grill-m':1,70 'happen':168,292 'human':36 'implement':221 'import':162 'indic':285 'intellig':8 'interview':58 'issu':145 'issues/tasks':313 'machin':14 'machine-read':13 'matter':323 'measur':127,243,278 'never':314 'new':50 'output':302 'perform':195 'phase':151,176,198,222 'plan':49,81,239 'prd':143,309 'problem':103,259 'process':87 'produc':305,341,348 'product':234,306 'prompt':76 'qualiti':270 'question':99,136,146 're':344 're-run':343 'reach':62,84,320,352 'readabl':15 'relentless':60 'requir':175,196,307 'rollback':238 'run':345 'share':28,37,63,85,140,318,333,338,353 'show':254 'signific':53 'skill':30,32,47,68,69 'skill-grill-me' 'solut':351 'solv':106,262 'source-sruja-ai' 'specif':273 'start':315 'success':114,128,244 'talk':326 'threshold':284,296 'topic-adr' 'topic-agent-skills' 'topic-ai-driven-development' 'topic-architecture' 'topic-architecture-as-code' 'topic-architecture-governance' 'topic-developer-tools' 'topic-governance' 'topic-rust-lang' 'topic-software-architecture' 'topic-system-design' 'topic-wasm' 'tri':156 'understand':29,64,86,141,150,267,301,319,339,354 'usag':65 'use':45,74,165 'user':110 'valid':17 'verifi':226 'want':93,248,276 'without':337 'work':228 'write':42 'wrong':123,232","prices":[{"id":"81101421-ad58-4463-a93b-7b652b7aa50f","listingId":"47360a50-94cb-4d00-8322-12bf0b179df6","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sruja-ai","category":"sruja","install_from":"skills.sh"},"createdAt":"2026-04-24T13:02:48.566Z"}],"sources":[{"listingId":"47360a50-94cb-4d00-8322-12bf0b179df6","source":"github","sourceId":"sruja-ai/sruja/grill-me","sourceUrl":"https://github.com/sruja-ai/sruja/tree/main/skills/grill-me","isPrimary":false,"firstSeenAt":"2026-04-24T13:02:48.566Z","lastSeenAt":"2026-05-18T19:06:09.700Z"}],"details":{"listingId":"47360a50-94cb-4d00-8322-12bf0b179df6","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sruja-ai","slug":"grill-me","github":{"repo":"sruja-ai/sruja","stars":17,"topics":["adr","agent-skills","ai","ai-driven-development","architecture","architecture-as-code","architecture-governance","developer-tools","governance","rust-lang","software-architecture","system-design","wasm"],"license":"apache-2.0","html_url":"https://github.com/sruja-ai/sruja","pushed_at":"2026-05-18T16:26:29Z","description":"Context Engineering and Architecture Intelligence for the AI Era. Machine-readable, continuously validated architecture as code for AI-assisted development.","skill_md_sha":"83fdc2855ff08b9e41bf97595ea5114284db6369","skill_md_path":"skills/grill-me/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sruja-ai/sruja/tree/main/skills/grill-me"},"layout":"multi","source":"github","category":"sruja","frontmatter":{},"skills_sh_url":"https://skills.sh/sruja-ai/sruja/grill-me"},"updatedAt":"2026-05-18T19:06:09.700Z"}}