feature-diagram

Generates a lint-checked Mermaid flowchart for one feature from the feature inventory.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/MohamedSayedK/omnigrid --skill feature-diagram-mohamedsayedk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: feature-diagram
Source: https://github.com/MohamedSayedK/omnigrid/tree/main/assets/core/skills/feature-diagram
Command: npx skills add https://github.com/MohamedSayedK/omnigrid --skill feature-diagram-mohamedsayedk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a feature inventory into visual documentation is tedious and error-prone when done by hand. This Skill renders a per-feature Mermaid flowchart directly from the inventory's Surfaces data, so architecture diagrams stay consistent, lint-clean, and regenerable instead of drifting out of sync with the source of truth. ## Core Features & Use Cases - Per-feature diagram generation: Selects one feature by kebab-case slug from the feature inventory and maps its Surfaces (entry points, screens, models) into a Mermaid flowchart. - Lint-checked output: Runs the diagram through a shared Node mermaidLint guard (balanced delimiters, recognized header) so artifacts are valid by construction. - Artifact regeneration contract: On re-run, archives the previous diagram to a dated copy and writes the fresh one to the canonical path; footer-less files are treated as hand-owned and never overwritten. - Use Case: After running extract-features and filling in the Surfaces column, run the skill with the slug "checkout" to produce omnigrid/artifacts/features/feature-checkout.md, a footer-signed diagram back-linked to the inventory. ## Quick Start Ask the assistant to run the feature-diagram skill for the checkout feature to generate its Mermaid diagram from the feature inventory.

Frequently Asked Questions about feature-diagram

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

FAQPage Schema
How do I generate a Mermaid diagram for a single feature?▼

Run the feature-diagram command with the feature's kebab-case slug, for example "omnigrid feature-diagram checkout". It reads the feature inventory, maps the feature's Surfaces into a flowchart, lints it, and writes the artifact to omnigrid/artifacts/features/feature-checkout.md.

What do I need before running feature-diagram?▼

You must first run extract-features to produce the feature inventory, then fill in the Surfaces column with the entry points, screens, and models each feature touches, separated by semicolons. The diagram is rendered entirely from those inventory rows.

Why is my generated feature diagram almost empty?▼

A thin diagram means the Surfaces cell for that feature is sparse. Enrich the inventory row with more entry points, screens, or models, then re-run the skill; the inventory is the source of truth and the diagram is generated from it.

What happens when I re-run the diagram for the same feature?▼

On re-run, the previous diagram is archived to a dated copy (feature-<slug>-YYYY-MM-DD.md) and the fresh diagram is written to the canonical path. The --force flag overwrites in place, but a footer-less file is treated as hand-owned and never overwritten.

Can I hand-edit the generated Mermaid diagram?▼

You can, but the diagram must stay lint-clean under the mermaidLint guard, which checks balanced delimiters and a recognized header. Removing the footer marks the file as hand-owned, so the skill will never overwrite it again.