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

modscape-spec-note

Appends free-form knowledge notes to permanent table spec markdown files.

Updated Feb 25, 2026
Search Tags:#markdown#data modeling#metadata#knowledge capture#data documentation#table specs#modscape
One-click install
npx skills add https://github.com/yujikawa/modscape --skill modscape-spec-note-yujikawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: modscape-spec-note
Source: https://github.com/yujikawa/modscape/tree/main/src/templates/gemini/modscape-spec-note
Command: npx skills add https://github.com/yujikawa/modscape --skill modscape-spec-note-yujikawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Tribal knowledge about data tables — business rules, known data quality issues, and context shared in conversations or Slack — often gets lost instead of being documented. This Skill captures that free-form knowledge and permanently appends it to the correct table spec files. ## Core Features & Use Cases - Automatic Table Detection: Identifies target table IDs (e.g., fct_orders, dim_customers) from free-text input, or accepts an explicit table ID argument. - Smart Section Routing: Maps each piece of knowledge to the appropriate spec section such as Business Rules, Known Issues / Caveats, Business Context, Overview, or Usage Guide. - Confirmation Preview: Shows a preview of all planned updates and waits for user confirmation before writing any file. - Use Case: After a Slack discussion reveals that updated_at values in Q1 2023 are unreliable due to an ETL bug, run the command with the note text and it appends a dated bullet to the Known Issues section of specs/fct_orders/spec.md. ## Quick Start Invoke @modscape-spec-note with a table ID, then paste the knowledge you want recorded when prompted.

Frequently Asked Questions about modscape-spec-note

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

FAQPage Schema
How do I add a note to a table spec file?▼

Run @modscape-spec-note followed by the table ID, then paste the knowledge when prompted. The skill shows a confirmation preview of the target file and section before appending a dated bullet point to the spec markdown.

How do I document knowledge for multiple tables at once?▼

Invoke the command without a table ID and paste text mentioning multiple snake_case table names. The skill detects each table ID, splits the content, and assigns each piece to the appropriate table and section independently.

What happens if no spec file exists for a table?▼

The skill searches .modscape/specs for a file matching the table ID. If none is found, it stops without writing anything and suggests running @modscape-spec-archive first to create the spec.

Which section does a note get added to in the spec file?▼

Content is routed by type: business rules and grain definitions go to Business Rules, data quality concerns to Known Issues / Caveats, background to Business Context, ownership to Overview, and query patterns to Usage Guide.

Can I cancel a spec note update before it writes?▼

Yes. The skill always displays a confirmation preview listing target files, sections, and content before writing. Answering n cancels the update and no files are modified.

Related Skills

Explore More Data & Analytics Skills→
ke-kishimotoke-kishimoto

postgresql-stored-program-tests

Generate Gauge specs and CSV or SQL fixtures for PostgreSQL stored programs.

Community
Advanced
jacob-balslevjacob-balslev
1

taxonomy-design

Design controlled classification taxonomies with category trees and facet governance.

Community
Intermediate
agentscope-aiagentscope-ai
5.4k

sql-analysis

Write, validate, and report SQL queries answering quantitative business questions.

Official
Intermediate
githubgithub
38.5k

update-markdown-file-index

Generates and updates file index tables in markdown documents from folder contents.

Official
Basic