modscape-spec-investigate

Investigate repository files and record findings in design.md.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on a data modeling change, you often need to verify how existing specs, YAML models, or SQL files actually behave before deciding on a fix. This Skill reads the relevant repository files for a named change and records structured findings directly into design.md, so investigation results are never lost. ## Core Features & Use Cases - Targeted file reading: Prioritizes spec-model.yaml, design.md, spec.md, referenced table specs, and SQL/dbt model files relevant to the request. - Structured finding reports: Produces a summary with files read, findings, impact, and a recommended next action. - Persistent findings log: Appends dated findings to a ## Findings section in design.md for the active change. - Use Case: While implementing a dbt model change, you suspect a column mismatch between spec-model.yaml and the SQL file. Run the investigation, and the Skill documents the discrepancy and recommends whether to fix inline, re-run design, or update the spec. ## Quick Start Ask the assistant to investigate why the column names in spec-model.yaml differ from the dbt model for the current change and record the finding in design.md.

Frequently Asked Questions about modscape-spec-investigate

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

FAQPage Schema
How do I investigate a data model spec before implementing changes?▼

Run the investigation with a change name and a free-text question. The Skill reads spec-model.yaml, design.md, spec.md, and related SQL or dbt files, then writes a structured finding with impact and recommended action into design.md.

How are investigation findings recorded in design.md?▼

Findings are appended under a `## Findings` section in .modscape/changes/<name>/design.md, created if absent. Each entry includes the date, request summary, files read, the finding, its impact, and the next action.

What files does the spec investigation read first?▼

It prioritizes spec-model.yaml, design.md, and spec.md inside the change directory, then referenced table specs under .modscape/specs, matching SQL or dbt model files, and finally the main model.yaml if needed.

What happens after an investigation finds a logic error?▼

The Skill maps findings to next steps: logic errors in implemented files route to the implement skill for an inline fix, model structure changes route to the design skill, and AC contradictions require updating spec.md first.

Can the investigation handle multiple active changes?▼

If multiple active changes exist and no name is given, the Skill asks the user to specify which change to investigate rather than guessing. A single active change is auto-detected.