skills.rest
yujikawa
yujikawaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

modscape-spec-answer

Answers open questions in questions.md and records design impact for spec changes.

Updated Feb 25, 2026
Search Tags:#markdown#data modeling#requirements clarification#question answering#spec workflow#design impact#modscape
One-click install
npx skills add https://github.com/yujikawa/modscape --skill modscape-spec-answer-yujikawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: modscape-spec-answer
Source: https://github.com/yujikawa/modscape/tree/main/src/templates/gemini/modscape-spec-answer
Command: npx skills add https://github.com/yujikawa/modscape --skill modscape-spec-answer-yujikawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? During spec-driven data modeling, unresolved questions in questions.md block progress. This Skill interactively collects answers, clarifies ambiguity, and records decisions so specs stay consistent and actionable. ## Core Features & Use Cases - Interactive Q&A Resolution: Lists open or assumed questions for a change, asks follow-ups when answers are vague, and records clear answers or assumptions. - Investigation Analysis: Interprets pasted query results from investigation blocks, writes findings, and marks questions answered. - Design Impact Tracking: Updates design.md, spec.md, and glossary.md when answers affect schema, JOIN keys, or acceptance criteria, then suggests the next workflow step. - Use Case: A data analyst working on a monthly-sales-summary spec runs the skill to answer Q-003 about a column's precision, and the skill updates questions.md, adjusts design.md, and points to the next phase. ## Quick Start Ask the AI to answer question Q-001 for the monthly-sales-summary change using the modscape-spec-answer skill.

Frequently Asked Questions about modscape-spec-answer

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

FAQPage Schema
How do I answer open questions in a spec change workflow?▼

Run the skill with the change name and question ID, or omit both to list open questions. It displays the question, collects your free-text answer, asks follow-ups if ambiguous, and records the result in questions.md.

What happens when a spec answer is ambiguous or incomplete?▼

The skill detects hedging language like "probably" or "maybe" and asks one targeted follow-up question at a time. If the answer remains unresolvable, it records an assumption and marks the question with a yellow status instead.

Can the skill analyze investigation query results?▼

Yes. When an investigation.result field is filled or you paste query output, the skill enters investigation analysis mode, interprets the data against the original question, writes a finding, and marks the question answered.

Does answering a question update the design document?▼

Yes. If the answer affects column types, JOIN keys, schema structure, or filter conditions, the skill updates design.md before recording the answer and reports which section changed. Purely contextual answers skip this step.

What are the limitations of the spec answer workflow?▼

It requires an existing change folder under .modscape/changes/ created by the requirements skill, and it only edits the targeted question section rather than rewriting files. It cannot resolve questions without user input or investigation data.

Related Skills

Explore More Data & Analytics Skills→
lee-tolee-to
77

questions

Resolve open milestone questions by updating open-questions.md interactively.

Community
Intermediate
sebasmzgsebasmzg

sdd-tasks

Break down change proposals into phase-structured tasks.md files.

Community
Advanced
sanchezx1sanchezx1

plan-mejoras-tracker

Update task statuses and progress notes in PLAN_MEJORAS.md.

Community
Basic
mrmtsuruyamrmtsuruya

consulting-call-questions

Manage structured question lists for consulting calls in Markdown files.

Community
Intermediate