modscape-spec-explore

Explores data model schemas and clarifies change direction before formal requirements gathering.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/yujikawa/modscape --skill modscape-spec-explore-yujikawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: modscape-spec-explore
Source: https://github.com/yujikawa/modscape/tree/main/src/templates/gemini/modscape-spec-explore
Command: npx skills add https://github.com/yujikawa/modscape --skill modscape-spec-explore-yujikawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you know something needs to change in your data model but haven't figured out exactly what, jumping straight into formal requirements is premature. This Skill acts as a thinking partner that investigates your Modscape YAML schema, explores options, and helps you decide whether a change is small (lite requirements) or large (full SDD). ## Core Features & Use Cases - Schema-grounded exploration: Uses modscape CLI commands (summary, table list/get, lineage) to inspect actual tables and downstream impact instead of guessing. - Open-ended thinking partner: Asks clarifying questions, challenges assumptions, brainstorms approaches, and sketches ASCII lineage diagrams without forcing a structured workflow. - Guided handoff: When direction becomes clear, recommends either @modscape-spec-requirements-lite for targeted changes or @modscape-spec-requirements for new pipelines. - Use Case: You suspect your sales fact table lineage is wrong. Invoke the skill, have it pull the table definition and recursive lineage, discuss trade-offs, then get routed to the right requirements workflow. ## Quick Start Ask the AI to explore whether refactoring the sales tables makes sense using @modscape-spec-explore.

Frequently Asked Questions about modscape-spec-explore

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

FAQPage Schema
How do I explore a data model before writing requirements?▼

Invoke @modscape-spec-explore with an optional topic such as a vague idea or concern. It investigates the schema using modscape CLI commands, discusses options conversationally, and recommends the appropriate requirements skill once direction is clear.

What modscape CLI commands inspect tables and lineage?▼

Use modscape summary for a model overview, modscape table list and table get for table inspection, and modscape lineage list with --from and --recursive flags to trace downstream impact of a table.

When should I use spec-explore vs spec-requirements?▼

Use spec-explore when you don't yet know what to build and need open-ended investigation. Use spec-requirements when the change is already understood and you need structured requirements gathering with generated spec files.

Does modscape-spec-explore generate spec or design files?▼

No. It explicitly does not create spec.md, design.md, or tasks.md files. Its output is clarity and a handoff recommendation to either the lite or full requirements skill, which handles file generation.

Why does the skill use modscape CLI instead of reading YAML directly?▼

The skill instructs the AI to use modscape CLI commands rather than grepping or reading YAML files directly, ensuring schema information is parsed consistently and accurately through the tool's own logic.