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

modscape-spec-requirements-lite

Generates spec, design, and task documents for minor data model schema changes via the modscape CLI.

Updated Feb 25, 2026
Search Tags:#documentation#data modeling#yaml#dbt#schema change#spec-driven development#modscape
One-click install
npx skills add https://github.com/yujikawa/modscape --skill modscape-spec-requirements-lite-yujikawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: modscape-spec-requirements-lite
Source: https://github.com/yujikawa/modscape/tree/main/src/templates/gemini/modscape-spec-requirements-lite
Command: npx skills add https://github.com/yujikawa/modscape --skill modscape-spec-requirements-lite-yujikawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Making small changes to a YAML-defined data model (adding a column, renaming a table, changing a type) normally requires manually editing model files and writing documentation. This Skill compresses the full spec-driven development cycle into a single guided invocation for minor schema changes. ## Core Features & Use Cases - Lightweight SDD Workflow: Compresses requirements, design, and tasks into one invocation for changes affecting 1-2 tables. - CLI-Driven Mutations: Applies column add/update and table rename/kind changes through modscape CLI commands, then validates the result. - Document Generation: Produces spec.md, design.md, per-table design docs, tasks.md, and a working spec-model.yaml in a dedicated change folder. - Use Case: You need to add a discount_rate column to a fact table. Invoke the skill, answer a few questions, and it extracts the table, applies the mutation, validates the model, and generates all change documentation. ## Quick Start Ask the AI to run the modscape-spec-requirements-lite skill to add a new column to one of your data model tables.

Frequently Asked Questions about modscape-spec-requirements-lite

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

FAQPage Schema
How do I add a column to a YAML data model with modscape?▼

Invoke this skill and provide the target table, column name, and type. It runs modscape extract to create a working spec-model.yaml, applies the change with modscape column add, validates the result, and generates the change documentation.

When should I use requirements-lite vs the full modscape SDD skill?▼

Use requirements-lite for simple changes to 1-2 tables such as column adds, renames, or type changes. Use the full SDD skill for new pipelines, multi-table changes, broad downstream impact, or changes needing stakeholder alignment and acceptance criteria.

What files does the lite spec workflow generate?▼

It creates a folder under .modscape/changes/<name>/ containing spec.md, design.md, per-table design docs, tasks.md, spec-model.yaml, and spec-config.yaml. It then sets the spec phase to tasks so implementation can begin.

Does the skill edit the main model YAML file directly?▼

No. It extracts only the target tables into a separate spec-model.yaml working copy using modscape extract, applies mutations there, and validates that file. The main model YAML is only read through modscape CLI commands.

What target tools does the modscape spec workflow support?▼

The workflow records a target tool of dbt, SQLMesh, Spark SQL, or plain SQL in the generated spec.md. This choice is collected conversationally unless already configured in modscape-spec.custom.md.

Related Skills

Explore More Data & Analytics Skills→
butchersoft-msnbutchersoft-msn

setup-datamodel

Orchestrates Dataverse table, column, and relationship creation via the OData API.

Community
Advanced
AltimateAIAltimateAI
792

pii-audit

Classify PII columns and audit query exposure with risk reports.

Official
Intermediate
apexradiusapexradius

plan

Estimate task complexity and generate plans with three levels of detail.

Official
Advanced
AltimateAIAltimateAI
803

dbt-schema-verify

Validates dbt model columns against schema.yml specifications after builds.

Official
Intermediate