modscape-spec-search

Search past spec archives by keyword and display relevant findings for reuse.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on data models with Modscape, past design decisions and specifications get buried in archives, forcing you to rediscover context or repeat earlier work. This Skill searches those archives and specs by keyword so you can surface and reuse prior findings. ## Core Features & Use Cases - Keyword Search Across Specs: Runs modscape spec search against .modscape/archives/ and .modscape/specs/ and returns structured JSON results. - Contextual Summaries: Reads matched files (e.g., design.md, spec.md) and presents grouped summaries with relevant excerpts. - Controlled Incorporation: On explicit request only, merges table definitions into spec-model.yaml via mutation CLI commands or appends design decisions to design.md. - Use Case: Before modeling a new orders fact table, search past specs for "orders" to find earlier grain definitions and design decisions, then incorporate them into the current change. ## Quick Start Ask the assistant to search past Modscape specs and archives for a keyword such as "orders" and show the relevant findings.

Frequently Asked Questions about modscape-spec-search

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

FAQPage Schema
How do I search past Modscape specs and archives?▼

Invoke the skill with a keyword, which runs `modscape spec search <keyword> --json --limit 10`. Results are parsed, matched files are read for context, and a grouped summary of relevant findings is displayed.

How do I reuse design decisions from an old spec in my current model?▼

After reviewing the search summary, explicitly instruct the assistant to incorporate findings. Table definitions are applied to spec-model.yaml via mutation CLI commands, and design decisions are appended to design.md under Related Past Specs.

What happens when a spec search returns no results?▼

If .modscape/archives/ and .modscape/specs/ do not exist or contain no matches, the skill reports that no results were found for the keyword and stops without modifying any files.

Does the spec search automatically merge findings into my current spec?▼

No. The skill never auto-merges. It only displays a summary and asks whether you want to incorporate findings, applying changes solely on explicit user instruction.

Can I limit the number of spec search results?▼

Yes. Pass a limit option such as `--limit <n>` when invoking the skill, which is forwarded to the underlying `modscape spec search` command to cap the number of returned entries.