diff --git a/.github/skills/core-meeting/SKILL.md b/.github/skills/core-meeting/SKILL.md index 0140f7f..63c6308 100644 --- a/.github/skills/core-meeting/SKILL.md +++ b/.github/skills/core-meeting/SKILL.md @@ -1,6 +1,9 @@ --- name: meeting -description: Analyze meeting transcripts — extract decisions, action items, and create SSOT documents. Use when processing standup notes, stakeholder reviews, or sprint meetings. +description: | + Analyze meeting transcripts — extract decisions, action items, and create SSOT + documents. Use when processing standup notes, stakeholder reviews, or sprint + meetings. --- # /meeting Command diff --git a/.github/skills/core-memory/SKILL.md b/.github/skills/core-memory/SKILL.md index 464f729..c2617f3 100644 --- a/.github/skills/core-memory/SKILL.md +++ b/.github/skills/core-memory/SKILL.md @@ -1,6 +1,8 @@ --- name: memory -description: Save valuable insights from the current session to storage. Use when you've discovered decisions, patterns, or gotchas worth remembering across sessions. +description: | + Save valuable insights from the current session to storage. Use when you've + discovered decisions, patterns, or gotchas worth remembering across sessions. --- # Memory Command diff --git a/.github/skills/core-readme-maker/SKILL.md b/.github/skills/core-readme-maker/SKILL.md index 54de63d..261107a 100644 --- a/.github/skills/core-readme-maker/SKILL.md +++ b/.github/skills/core-readme-maker/SKILL.md @@ -1,6 +1,9 @@ --- name: readme-maker -description: Generate comprehensive, production-ready README.md by analyzing codebase with explorer + documenter agents. Use when creating or updating project documentation. +description: | + Generate comprehensive, production-ready README.md by analyzing codebase with + explorer + documenter agents. Use when creating or updating project + documentation. --- # README Maker Command diff --git a/.github/skills/core-sync-context/SKILL.md b/.github/skills/core-sync-context/SKILL.md index abd704f..2d9242c 100644 --- a/.github/skills/core-sync-context/SKILL.md +++ b/.github/skills/core-sync-context/SKILL.md @@ -1,6 +1,9 @@ --- name: sync-context -description: Sync project context to copilot-instructions.md by analyzing codebase patterns and conventions. Use after adding agents, commands, or significant architecture changes. +description: | + Sync project context to copilot-instructions.md by analyzing codebase patterns + and conventions. Use after adding agents, commands, or significant + architecture changes. --- # Sync Context Command diff --git a/.github/skills/data-engineering-ai-pipeline/SKILL.md b/.github/skills/data-engineering-ai-pipeline/SKILL.md index a197298..87a3cde 100644 --- a/.github/skills/data-engineering-ai-pipeline/SKILL.md +++ b/.github/skills/data-engineering-ai-pipeline/SKILL.md @@ -1,6 +1,9 @@ --- name: ai-pipeline -description: RAG/embedding pipeline scaffolding — delegates to de-ai-data-engineer agent. Use when building RAG pipelines, embedding workflows, feature stores, or text-to-SQL systems. +description: | + RAG/embedding pipeline scaffolding — delegates to de-ai-data-engineer agent. + Use when building RAG pipelines, embedding workflows, feature stores, or text- + to-SQL systems. --- # AI Pipeline Command diff --git a/.github/skills/data-engineering-data-contract/SKILL.md b/.github/skills/data-engineering-data-contract/SKILL.md index 14714c2..2fd53be 100644 --- a/.github/skills/data-engineering-data-contract/SKILL.md +++ b/.github/skills/data-engineering-data-contract/SKILL.md @@ -1,6 +1,9 @@ --- name: data-contract -description: Data contract authoring (ODCS) — delegates to test-data-contracts-engineer agent. Use when defining producer-consumer agreements, SLAs, or schema governance rules. +description: | + Data contract authoring (ODCS) — delegates to test-data-contracts-engineer + agent. Use when defining producer-consumer agreements, SLAs, or schema + governance rules. --- # Data Contract Command diff --git a/.github/skills/data-engineering-data-quality/SKILL.md b/.github/skills/data-engineering-data-quality/SKILL.md index f724e06..655a0b6 100644 --- a/.github/skills/data-engineering-data-quality/SKILL.md +++ b/.github/skills/data-engineering-data-quality/SKILL.md @@ -1,6 +1,9 @@ --- name: data-quality -description: Data quality rules generation — delegates to test-data-quality-analyst agent. Use when generating Great Expectations suites, dbt tests, or SQL quality assertions for your data models. +description: | + Data quality rules generation — delegates to test-data-quality-analyst agent. + Use when generating Great Expectations suites, dbt tests, or SQL quality + assertions for your data models. --- # Data Quality Command diff --git a/.github/skills/data-engineering-lakehouse/SKILL.md b/.github/skills/data-engineering-lakehouse/SKILL.md index 1b4e62f..3af372a 100644 --- a/.github/skills/data-engineering-lakehouse/SKILL.md +++ b/.github/skills/data-engineering-lakehouse/SKILL.md @@ -1,6 +1,9 @@ --- name: lakehouse -description: Table format and catalog guidance — delegates to architect-lakehouse agent. Use when working with Iceberg, Delta Lake, catalogs, or migrating from legacy table formats. +description: | + Table format and catalog guidance — delegates to architect-lakehouse agent. + Use when working with Iceberg, Delta Lake, catalogs, or migrating from legacy + table formats. --- # Lakehouse Command diff --git a/.github/skills/data-engineering-migrate/SKILL.md b/.github/skills/data-engineering-migrate/SKILL.md index 8f4d0eb..b7e9c11 100644 --- a/.github/skills/data-engineering-migrate/SKILL.md +++ b/.github/skills/data-engineering-migrate/SKILL.md @@ -1,6 +1,9 @@ --- name: migrate -description: Legacy ETL migration — delegates to de-dbt-specialist and de-spark-engineer agents. Use when converting stored procedures, SSIS packages, or Informatica workflows to modern stack. +description: | + Legacy ETL migration — delegates to de-dbt-specialist and de-spark-engineer + agents. Use when converting stored procedures, SSIS packages, or Informatica + workflows to modern stack. --- # Migrate Command diff --git a/.github/skills/data-engineering-pipeline/SKILL.md b/.github/skills/data-engineering-pipeline/SKILL.md index 22739d5..24b5dd4 100644 --- a/.github/skills/data-engineering-pipeline/SKILL.md +++ b/.github/skills/data-engineering-pipeline/SKILL.md @@ -1,6 +1,8 @@ --- name: pipeline -description: DAG/pipeline scaffolding — delegates to architect-pipeline agent. Use when scaffolding Airflow or Dagster pipelines with best-practice patterns. +description: | + DAG/pipeline scaffolding — delegates to architect-pipeline agent. Use when + scaffolding Airflow or Dagster pipelines with best-practice patterns. --- # Pipeline Command diff --git a/.github/skills/data-engineering-schema/SKILL.md b/.github/skills/data-engineering-schema/SKILL.md index f266199..4f71881 100644 --- a/.github/skills/data-engineering-schema/SKILL.md +++ b/.github/skills/data-engineering-schema/SKILL.md @@ -1,6 +1,9 @@ --- name: schema -description: Interactive schema design — delegates to architect-schema-designer agent. Use when designing star schemas, Data Vault models, SCD strategies, or DDL for any target platform. +description: | + Interactive schema design — delegates to architect-schema-designer agent. Use + when designing star schemas, Data Vault models, SCD strategies, or DDL for any + target platform. --- # Schema Command diff --git a/.github/skills/data-engineering-sql-review/SKILL.md b/.github/skills/data-engineering-sql-review/SKILL.md index 918db99..0068432 100644 --- a/.github/skills/data-engineering-sql-review/SKILL.md +++ b/.github/skills/data-engineering-sql-review/SKILL.md @@ -1,6 +1,9 @@ --- name: sql-review -description: SQL-specific code review — delegates to de-sql-optimizer + python-code-reviewer agents. Use when reviewing SQL for anti-patterns, performance issues, or cross-dialect correctness. +description: | + SQL-specific code review — delegates to de-sql-optimizer + python-code- + reviewer agents. Use when reviewing SQL for anti-patterns, performance issues, + or cross-dialect correctness. --- # SQL Review Command diff --git a/.github/skills/data-scientist-eda/SKILL.md b/.github/skills/data-scientist-eda/SKILL.md index 98b730c..abad6b0 100644 --- a/.github/skills/data-scientist-eda/SKILL.md +++ b/.github/skills/data-scientist-eda/SKILL.md @@ -1,6 +1,9 @@ --- -name: ds-eda -description: Exploratory data analysis for data scientists — delegates to ds-eda-analyst agent. Use when profiling datasets, visualizing distributions, checking correlations, or detecting missing data and outliers. +name: eda +description: | + Exploratory data analysis for data scientists — delegates to ds-eda-analyst + agent. Use when profiling datasets, visualizing distributions, checking + correlations, or detecting missing data and outliers. --- # EDA Command diff --git a/.github/skills/data-scientist-experiment-tracking/SKILL.md b/.github/skills/data-scientist-experiment-tracking/SKILL.md index cde48ae..82381f3 100644 --- a/.github/skills/data-scientist-experiment-tracking/SKILL.md +++ b/.github/skills/data-scientist-experiment-tracking/SKILL.md @@ -1,6 +1,10 @@ --- -name: ds-experiment-tracking -description: Experiment tracking and ML deployment for data scientists — delegates to ds-experiment-tracker and ds-ml-deployer agents. Use when logging MLflow runs, comparing experiments, registering models, promoting to production, serving via API, or running batch inference. +name: experiment-tracking +description: | + Experiment tracking and ML deployment for data scientists — delegates to ds- + experiment-tracker and ds-ml-deployer agents. Use when logging MLflow runs, + comparing experiments, registering models, promoting to production, serving + via API, or running batch inference. --- # Experiment Tracking Command diff --git a/.github/skills/data-scientist-feature-engineering/SKILL.md b/.github/skills/data-scientist-feature-engineering/SKILL.md index 1be5efd..8d802e0 100644 --- a/.github/skills/data-scientist-feature-engineering/SKILL.md +++ b/.github/skills/data-scientist-feature-engineering/SKILL.md @@ -1,6 +1,10 @@ --- -name: ds-feature-engineering -description: Feature engineering for data scientists — delegates to ds-feature-engineer agent. Use when building scikit-learn Pipelines, encoding categoricals, imputing missing values, scaling features, or creating lag/rolling features for time series. +name: feature-engineering +description: | + Feature engineering for data scientists — delegates to ds-feature-engineer + agent. Use when building scikit-learn Pipelines, encoding categoricals, + imputing missing values, scaling features, or creating lag/rolling features + for time series. --- # Feature Engineering Command diff --git a/.github/skills/data-scientist-model-evaluation/SKILL.md b/.github/skills/data-scientist-model-evaluation/SKILL.md index f863d22..5ef35b4 100644 --- a/.github/skills/data-scientist-model-evaluation/SKILL.md +++ b/.github/skills/data-scientist-model-evaluation/SKILL.md @@ -1,6 +1,10 @@ --- -name: ds-model-evaluation -description: Model evaluation for data scientists — delegates to ds-model-evaluator agent. Use when computing classification or regression metrics, plotting ROC/PR curves, calibrating probabilities, tuning decision thresholds, or comparing models statistically. +name: model-evaluation +description: | + Model evaluation for data scientists — delegates to ds-model-evaluator agent. + Use when computing classification or regression metrics, plotting ROC/PR + curves, calibrating probabilities, tuning decision thresholds, or comparing + models statistically. --- # Model Evaluation Command diff --git a/.github/skills/data-scientist-model-training/SKILL.md b/.github/skills/data-scientist-model-training/SKILL.md index bb27aec..a83391f 100644 --- a/.github/skills/data-scientist-model-training/SKILL.md +++ b/.github/skills/data-scientist-model-training/SKILL.md @@ -1,6 +1,9 @@ --- -name: ds-model-training -description: Model training for data scientists — delegates to ds-model-trainer agent. Use when training classification or regression models, tuning hyperparameters with Optuna, running cross-validation, or comparing multiple algorithms. +name: model-training +description: | + Model training for data scientists — delegates to ds-model-trainer agent. Use + when training classification or regression models, tuning hyperparameters with + Optuna, running cross-validation, or comparing multiple algorithms. --- # Model Training Command diff --git a/.github/skills/excalidraw-diagram/SKILL.md b/.github/skills/excalidraw-diagram/SKILL.md index b6f810d..fb614e7 100644 --- a/.github/skills/excalidraw-diagram/SKILL.md +++ b/.github/skills/excalidraw-diagram/SKILL.md @@ -1,6 +1,8 @@ --- name: diagram -description: Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, architectures, or concepts. +description: | + Create Excalidraw diagram JSON files that make visual arguments. Use when the + user wants to visualize workflows, architectures, or concepts. --- # Excalidraw Diagram Creator diff --git a/.github/skills/knowledge-create-kb/SKILL.md b/.github/skills/knowledge-create-kb/SKILL.md index f33f410..9efe4d9 100644 --- a/.github/skills/knowledge-create-kb/SKILL.md +++ b/.github/skills/knowledge-create-kb/SKILL.md @@ -1,6 +1,8 @@ --- name: create-kb -description: Create a complete KB domain from scratch with MCP validation. Use when adding a new knowledge base domain for a technology, library, or concept. +description: | + Create a complete KB domain from scratch with MCP validation. Use when adding + a new knowledge base domain for a technology, library, or concept. --- # Create Knowledge Base Command diff --git a/.github/skills/review-code/SKILL.md b/.github/skills/review-code/SKILL.md index 5679012..1471db7 100644 --- a/.github/skills/review-code/SKILL.md +++ b/.github/skills/review-code/SKILL.md @@ -1,6 +1,9 @@ --- name: code -description: Dual AI code review with CodeRabbit + Claude Code for maximum coverage. Use when reviewing changes before a PR, or for deep architectural analysis of committed code. +description: | + Dual AI code review with CodeRabbit + Claude Code for maximum coverage. Use + when reviewing changes before a PR, or for deep architectural analysis of + committed code. --- # Review Command diff --git a/.github/skills/visual-explainer-diff-review/SKILL.md b/.github/skills/visual-explainer-diff-review/SKILL.md index 0aa36d6..a58efb4 100644 --- a/.github/skills/visual-explainer-diff-review/SKILL.md +++ b/.github/skills/visual-explainer-diff-review/SKILL.md @@ -1,6 +1,9 @@ --- name: diff-review -description: Generate a visual HTML diff review — before/after architecture comparison with code review analysis. Use when visualizing code changes, comparing branches, or reviewing PRs visually. +description: | + Generate a visual HTML diff review — before/after architecture comparison with + code review analysis. Use when visualizing code changes, comparing branches, + or reviewing PRs visually. --- Load the visual-explainer skill, then generate a comprehensive visual diff review as a self-contained HTML page. diff --git a/.github/skills/visual-explainer-fact-check/SKILL.md b/.github/skills/visual-explainer-fact-check/SKILL.md index 9c4ae3e..d799045 100644 --- a/.github/skills/visual-explainer-fact-check/SKILL.md +++ b/.github/skills/visual-explainer-fact-check/SKILL.md @@ -1,6 +1,9 @@ --- name: fact-check -description: Verify the factual accuracy of a document against the actual codebase, correct inaccuracies in place. Use when validating HTML review pages, plan documents, or any document making claims about code. +description: | + Verify the factual accuracy of a document against the actual codebase, correct + inaccuracies in place. Use when validating HTML review pages, plan documents, + or any document making claims about code. --- Load the visual-explainer skill, then verify the factual accuracy of a document that makes claims about a codebase. Read the file, extract every verifiable claim, check each against the actual code and git history, correct inaccuracies in place, and add a verification summary. diff --git a/.github/skills/visual-explainer-generate-slides/SKILL.md b/.github/skills/visual-explainer-generate-slides/SKILL.md index 07633e9..145dace 100644 --- a/.github/skills/visual-explainer-generate-slides/SKILL.md +++ b/.github/skills/visual-explainer-generate-slides/SKILL.md @@ -1,6 +1,9 @@ --- name: generate-slides -description: Generate a stunning magazine-quality slide deck as a self-contained HTML page. Use when creating presentations, stakeholder decks, or visual storytelling for any technical topic. +description: | + Generate a stunning magazine-quality slide deck as a self-contained HTML page. + Use when creating presentations, stakeholder decks, or visual storytelling for + any technical topic. --- Load the visual-explainer skill, then generate a slide deck for: $@ diff --git a/.github/skills/visual-explainer-generate-visual-plan/SKILL.md b/.github/skills/visual-explainer-generate-visual-plan/SKILL.md index f793ffc..4257660 100644 --- a/.github/skills/visual-explainer-generate-visual-plan/SKILL.md +++ b/.github/skills/visual-explainer-generate-visual-plan/SKILL.md @@ -1,6 +1,9 @@ --- name: generate-visual-plan -description: Generate a visual HTML implementation plan — detailed feature specification with state machines, code snippets, and edge cases. Use when planning a feature implementation with architectural depth. +description: | + Generate a visual HTML implementation plan — detailed feature specification + with state machines, code snippets, and edge cases. Use when planning a + feature implementation with architectural depth. --- Load the visual-explainer skill, then generate a comprehensive visual implementation plan for `$@` as a self-contained HTML page. diff --git a/.github/skills/visual-explainer-generate-web-diagram/SKILL.md b/.github/skills/visual-explainer-generate-web-diagram/SKILL.md index a5fdfe9..500d1af 100644 --- a/.github/skills/visual-explainer-generate-web-diagram/SKILL.md +++ b/.github/skills/visual-explainer-generate-web-diagram/SKILL.md @@ -1,6 +1,9 @@ --- name: generate-web-diagram -description: Generate a beautiful standalone HTML diagram and open it in the browser. Use when visualizing workflows, architectures, systems, or any concept that benefits from a rich visual page. +description: | + Generate a beautiful standalone HTML diagram and open it in the browser. Use + when visualizing workflows, architectures, systems, or any concept that + benefits from a rich visual page. --- Load the visual-explainer skill, then generate an HTML diagram for: $@ diff --git a/.github/skills/visual-explainer-plan-review/SKILL.md b/.github/skills/visual-explainer-plan-review/SKILL.md index f11deba..e02192f 100644 --- a/.github/skills/visual-explainer-plan-review/SKILL.md +++ b/.github/skills/visual-explainer-plan-review/SKILL.md @@ -1,6 +1,9 @@ --- name: plan-review -description: Generate a visual HTML plan review — current codebase state vs. proposed implementation plan. Use when evaluating a spec, RFC, or design document against the actual codebase. +description: | + Generate a visual HTML plan review — current codebase state vs. proposed + implementation plan. Use when evaluating a spec, RFC, or design document + against the actual codebase. --- Load the visual-explainer skill, then generate a comprehensive visual plan review as a self-contained HTML page, comparing the current codebase against a proposed implementation plan. diff --git a/.github/skills/visual-explainer-project-recap/SKILL.md b/.github/skills/visual-explainer-project-recap/SKILL.md index a37eac5..a8ba2d2 100644 --- a/.github/skills/visual-explainer-project-recap/SKILL.md +++ b/.github/skills/visual-explainer-project-recap/SKILL.md @@ -1,6 +1,9 @@ --- name: project-recap -description: Generate a visual HTML project recap — rebuild mental model of a project's current state, recent decisions, and cognitive debt hotspots. Use when re-entering a project or summarizing recent activity. +description: | + Generate a visual HTML project recap — rebuild mental model of a project's + current state, recent decisions, and cognitive debt hotspots. Use when re- + entering a project or summarizing recent activity. --- Load the visual-explainer skill, then generate a comprehensive visual project recap as a self-contained HTML page. diff --git a/.github/skills/visual-explainer-share/SKILL.md b/.github/skills/visual-explainer-share/SKILL.md index 2fa99a2..a3a4b5d 100644 --- a/.github/skills/visual-explainer-share/SKILL.md +++ b/.github/skills/visual-explainer-share/SKILL.md @@ -1,6 +1,9 @@ --- name: share -description: Share a visual explainer HTML file instantly via Vercel — returns a live URL with no authentication required. Use when sharing diagrams, reviews, or slide decks with others. +description: | + Share a visual explainer HTML file instantly via Vercel — returns a live URL + with no authentication required. Use when sharing diagrams, reviews, or slide + decks with others. --- # Share Visual Explainer Page diff --git a/.github/skills/visual-explainer/SKILL.md b/.github/skills/visual-explainer/SKILL.md index f00aca8..febbdb5 100644 --- a/.github/skills/visual-explainer/SKILL.md +++ b/.github/skills/visual-explainer/SKILL.md @@ -1,11 +1,14 @@ --- name: visual-explainer -description: Generate beautiful, self-contained HTML pages that visually explain systems, code changes, plans, and data. Use when the user asks for a diagram, architecture overview, diff review, plan review, project recap, comparison table, or any visual explanation of technical concepts. Also use proactively when you are about to render a complex ASCII table (4+ rows or 3+ columns) — present it as a styled HTML page instead. -license: MIT -compatibility: Requires a browser to view generated HTML files. Optional surf-cli for AI image generation. -metadata: - author: nicobailon - version: "0.5.1" +description: | + Generate beautiful, self-contained HTML pages that visually explain systems, + code changes, plans, and data. Use when the user asks for a diagram, + architecture overview, diff review, plan review, project recap, comparison + table, or any visual explanation of technical concepts. Also use proactively + when you are about to render a complex ASCII table (4+ rows or 3+ columns) — + present it as a styled HTML page instead. license: MIT compatibility: Requires + a browser to view generated HTML files. Optional surf-cli for AI image + generation. metadata: author: nicobailon version: "0.5.1" --- # Visual Explainer diff --git a/.github/skills/workflow-brainstorm/SKILL.md b/.github/skills/workflow-brainstorm/SKILL.md index 82c4c51..b7abd39 100644 --- a/.github/skills/workflow-brainstorm/SKILL.md +++ b/.github/skills/workflow-brainstorm/SKILL.md @@ -1,6 +1,9 @@ --- name: brainstorm -description: Explore ideas through collaborative dialogue before requirements capture (Phase 0). Use when the user wants to brainstorm a feature, explore an idea, or hasn't defined requirements yet. +description: | + Explore ideas through collaborative dialogue before requirements capture + (Phase 0). Use when the user wants to brainstorm a feature, explore an idea, + or hasn't defined requirements yet. --- # Brainstorm Command diff --git a/.github/skills/workflow-build/SKILL.md b/.github/skills/workflow-build/SKILL.md index 9a9b426..e5ce3a1 100644 --- a/.github/skills/workflow-build/SKILL.md +++ b/.github/skills/workflow-build/SKILL.md @@ -1,6 +1,9 @@ --- name: build -description: Execute implementation with on-the-fly task generation from a DESIGN document (Phase 3). Use when the user wants to implement a feature that has a completed DESIGN document. +description: | + Execute implementation with on-the-fly task generation from a DESIGN document + (Phase 3). Use when the user wants to implement a feature that has a completed + DESIGN document. --- # Build Command diff --git a/.github/skills/workflow-create-pr/SKILL.md b/.github/skills/workflow-create-pr/SKILL.md index 36b7f43..4450b7b 100644 --- a/.github/skills/workflow-create-pr/SKILL.md +++ b/.github/skills/workflow-create-pr/SKILL.md @@ -1,8 +1,8 @@ --- name: create-pr -description: Create a pull request with conventional commits and a structured description. Use when the user wants to open a PR, commit changes, or submit work for review. -allowed-tools: shell ---- +dedescription: | + Create a pull request with conventional commits and a structured description. + Use when the user wants to open a PR, commit changes, or submit work for review. # Create PR Command diff --git a/.github/skills/workflow-define/SKILL.md b/.github/skills/workflow-define/SKILL.md index eacd254..b41b8f0 100644 --- a/.github/skills/workflow-define/SKILL.md +++ b/.github/skills/workflow-define/SKILL.md @@ -1,6 +1,9 @@ --- name: define -description: Capture and validate requirements in one pass (Phase 1). Use when the user wants to extract requirements from notes, emails, a BRAINSTORM document, or a direct request. +description: | + Capture and validate requirements in one pass (Phase 1). Use when the user + wants to extract requirements from notes, emails, a BRAINSTORM document, or a + direct request. --- # Define Command diff --git a/.github/skills/workflow-design/SKILL.md b/.github/skills/workflow-design/SKILL.md index 61c6eb2..9d496be 100644 --- a/.github/skills/workflow-design/SKILL.md +++ b/.github/skills/workflow-design/SKILL.md @@ -1,6 +1,9 @@ --- name: design -description: Create architecture and technical specification from a DEFINE document (Phase 2). Use when the user wants to design a solution, create an architecture, or plan implementation after requirements are captured. +description: | + Create architecture and technical specification from a DEFINE document (Phase + 2). Use when the user wants to design a solution, create an architecture, or + plan implementation after requirements are captured. --- # Design Command diff --git a/.github/skills/workflow-iterate/SKILL.md b/.github/skills/workflow-iterate/SKILL.md index 3fbddf2..66826f6 100644 --- a/.github/skills/workflow-iterate/SKILL.md +++ b/.github/skills/workflow-iterate/SKILL.md @@ -1,6 +1,9 @@ --- name: iterate -description: Update any SDD phase document when requirements or design change (Cross-Phase). Use when the user needs to modify a BRAINSTORM, DEFINE, or DESIGN document mid-stream and wants cascade awareness. +description: | + Update any SDD phase document when requirements or design change (Cross- + Phase). Use when the user needs to modify a BRAINSTORM, DEFINE, or DESIGN + document mid-stream and wants cascade awareness. --- # Iterate Command diff --git a/.github/skills/workflow-ship/SKILL.md b/.github/skills/workflow-ship/SKILL.md index a4c985a..3f96693 100644 --- a/.github/skills/workflow-ship/SKILL.md +++ b/.github/skills/workflow-ship/SKILL.md @@ -1,6 +1,9 @@ --- name: ship -description: Archive a completed feature with lessons learned (Phase 4). Use when the build is done, all tests pass, and the user wants to finalize and archive the feature. +description: | + Archive a completed feature with lessons learned (Phase 4). Use when the build + is done, all tests pass, and the user wants to finalize and archive the + feature. --- # Ship Command diff --git a/plugin-copilot/copilot-instructions.md b/plugin-copilot/copilot-instructions.md deleted file mode 100644 index f91a88b..0000000 --- a/plugin-copilot/copilot-instructions.md +++ /dev/null @@ -1,209 +0,0 @@ -# AgentSpec Copilot CLI — Copilot Instructions - -AgentSpec is a GitHub Copilot CLI extension that provides a 5-phase Spec-Driven Development (SDD) workflow with 66 specialized agents, 41 skills, and 30 KB domains for data engineering and data science. - ---- - -## Build - -```bash -# Linux / macOS -./build-copilot.sh - -# Windows (PowerShell) -.\build-copilot.ps1 - -# Validate the build output -cat plugin-copilot/manifest.yaml -``` - -Both scripts package `${COPILOT_PLUGIN_ROOT}/` → `plugin-copilot/` with identical logic: clean the output directory, copy all components, rewrite `${COPILOT_PLUGIN_ROOT}/` → `${COPILOT_PLUGIN_ROOT}/`, and restore workspace paths (`sdd/features/`, `sdd/reports/`, `sdd/archive/`). - -The CI workflow (`${COPILOT_PLUGIN_ROOT}/workflows/plugin-validate.yml`) runs `build-plugin.sh` (Claude Code variant) and checks agent count (≥50), skill count (≥4), KB domain count (≥20), and JSON/plugin manifest validity. - ---- - -## Architecture - -### Two Parallel Distributions - -This repo ships AgentSpec for **two platforms**: - -| Platform | Source of Truth | Build Script | Output | -|---|---|---|---| -| GitHub Copilot CLI | `${COPILOT_PLUGIN_ROOT}/` | `build-copilot.sh` | `plugin-copilot/` | -| Claude Code | `.claude/` | `build-plugin.sh` | `plugin/` | - -**Never edit `plugin-copilot/` or `plugin/` directly** — they are generated artifacts. All content changes go into `${COPILOT_PLUGIN_ROOT}/` (Copilot CLI) or `.claude/` (Claude Code). - -### Source Structure (`${COPILOT_PLUGIN_ROOT}/`) - -``` -${COPILOT_PLUGIN_ROOT}/ -├── agents/ # 66 *.agent.md files — flat directory, no subdirectories -├── skills/ # 41 skill directories, each containing SKILL.md -├── kb/ # 30 KB domain directories + _index.yaml registry -│ ├── _index.yaml # Machine-readable domain registry (entry point for agents) -│ ├── _templates/ # 7 templates for new domains -│ └── / # index.md, quick-reference.md, concepts/, patterns/ -├── sdd/ -│ ├── architecture/ # WORKFLOW_CONTRACTS.yaml + ARCHITECTURE.md (read-only reference) -│ ├── templates/ # 5 phase document templates -│ ├── features/ # Active WIP documents (BRAINSTORM_*, DEFINE_*, DESIGN_*) -│ ├── reports/ # BUILD_REPORT_* files -│ └── archive/ # Shipped features -└── manifest.yaml # Plugin manifest -``` - -### Path Rewriting During Build - -`build-copilot.sh` / `build-copilot.ps1` rewrites `${COPILOT_PLUGIN_ROOT}/` → `${COPILOT_PLUGIN_ROOT}/` in all `.md`, `.yaml`, `.yml`, `.json` files inside `plugin-copilot/`. - -**Exception — workspace output paths are preserved as-is:** -- `.github/sdd/features/` -- `.github/sdd/reports/` -- `.github/sdd/archive/` - -If you add new internal references in agent or skill files, use `${COPILOT_PLUGIN_ROOT}//` paths — the build will rewrite them. - -### 5-Phase SDD Workflow - -``` -Phase 0: /brainstorm → BRAINSTORM_{FEATURE}.md (optional) -Phase 1: /define → DEFINE_{FEATURE}.md -Phase 2: /design → DESIGN_{FEATURE}.md -Phase 3: /build → Code + BUILD_REPORT_{FEATURE}.md -Phase 4: /ship → archive/{FEATURE}/SHIPPED_{DATE}.md -Cross: /iterate → Updates any phase 0-2 doc with cascade awareness -``` - -All phase documents live in `.github/sdd/features/` while active. - ---- - -## Key Conventions - -### Agent Files (`*.agent.md`) - -All 66 agents live as a **flat list** in `${COPILOT_PLUGIN_ROOT}/agents/` — no subdirectories. Category is encoded in the filename prefix: - -| Prefix | Category | Count | Examples | -|---|---|---|---| -| `workflow-` | SDD pipeline | 6 | `workflow-brainstorm`, `workflow-build`, `workflow-ship` | -| `architect-` | System design | 8 | `architect-schema-designer`, `architect-pipeline`, `architect-the-planner` | -| `cloud-` | AWS / GCP / CI-CD | 10 | `cloud-aws-data-architect`, `cloud-gcp-data-architect`, `cloud-ci-cd-specialist` | -| `fabric-` | Microsoft Fabric | 6 | `fabric-architect`, `fabric-pipeline-developer`, `fabric-security-specialist` | -| `python-` | Python & code quality | 6 | `python-code-reviewer`, `python-code-cleaner`, `python-developer` | -| `test-` | QA & contracts | 3 | `test-generator`, `test-data-quality-analyst`, `test-data-contracts-engineer` | -| `de-` | Data engineering | 15 | `de-spark-engineer`, `de-dbt-specialist`, `de-airflow-specialist`, `de-lakeflow-*` | -| `ds-` | Data science & ML | 8 | `ds-eda-analyst`, `ds-model-trainer`, `ds-experiment-tracker`, `ds-statistician` | -| `dev-` | Developer tools | 4 | `dev-codebase-explorer`, `dev-meeting-analyst`, `dev-prompt-crafter`, `dev-shell-script-specialist` | - -Every agent file follows this structure: - -```markdown ---- -name: -description: | - - - - Context: - user: "" - assistant: "" - -model: claude-sonnet-4.6 # or gpt-5-mini / gpt-5.3-codex / claude-opus-4.6 per routing strategy -tools: - - read - - edit - - execute - - search ---- - -# Agent Title - -## Identity -> **Identity:** ... -> **Domain:** ... -> **Threshold:** 0.90 - -## Knowledge Resolution -... - -## Capabilities -... -``` - -Required front-matter fields: `name`, `description` (with ≥1 `` block), `model`, `tools`. - -Data engineering agents must include a `kb_domains` field listing relevant KB domains. Agents follow **KB-first resolution**: read `_index.yaml` → load relevant domain files → apply patterns. - -### KB Domain Structure - -30 domains live under `${COPILOT_PLUGIN_ROOT}/kb/`. Each domain must have exactly: -``` -/ -├── index.md # Domain overview -├── quick-reference.md # Cheat sheet (≤100 lines) -├── concepts/ # 3–6 concept files (≤150 lines each) -└── patterns/ # 3–6 pattern files with code examples (≤200 lines each) -``` - -**Available domains:** `ai-data-engineering`, `airflow`, `aws`, `cloud-platforms`, `data-modeling`, `data-quality`, `data-visualization`, `dbt`, `gcp`, `genai`, `lakeflow`, `lakehouse`, `medallion`, `microsoft-fabric`, `mlflow`, `modern-stack`, `pandas`, `prompt-engineering`, `pydantic`, `python`, `scikit-learn`, `spark`, `sql-patterns`, `statistical-analysis`, `streaming`, `supabase`, `terraform`, `testing`, `time-series`, `xgboost` - -Register new domains in `${COPILOT_PLUGIN_ROOT}/kb/_index.yaml` before writing any domain files. - -### Skill Files - -Each skill is a directory containing a single `SKILL.md` file (41 skills total). Skill names use kebab-case with a category prefix: - -| Prefix | Skills | -|---|---| -| `workflow-` | `brainstorm`, `build`, `create-pr`, `define`, `design`, `iterate`, `ship` | -| `visual-explainer` / `visual-explainer-*` | base + `diff-review`, `fact-check`, `generate-slides`, `generate-visual-plan`, `generate-web-diagram`, `plan-review`, `project-recap`, `share` | -| `data-engineering-*` | `ai-pipeline`, `data-contract`, `data-quality`, `guide`, `lakehouse`, `migrate`, `pipeline`, `schema`, `sql-review` | -| `data-scientist-*` | `eda`, `experiment-tracking`, `feature-engineering`, `model-evaluation`, `model-training` | -| `core-*` | `meeting`, `memory`, `readme-maker`, `status`, `sync-context` | -| `knowledge-*` | `create-kb` | -| standalone | `agent-router`, `excalidraw-diagram`, `review-code`, `review-judge`, `sdd-workflow` | - -### SDD Templates - -When creating SDD phase documents, always use the corresponding template from `${COPILOT_PLUGIN_ROOT}/sdd/templates/`: -- `BRAINSTORM_TEMPLATE.md` -- `DEFINE_TEMPLATE.md` -- `DESIGN_TEMPLATE.md` -- `BUILD_REPORT_TEMPLATE.md` -- `SHIPPED_TEMPLATE.md` - -### Markdown Standards - -- ATX-style headers (`#`, `##`, `###`) — no underline-style -- Fenced code blocks always include a language identifier -- Tables are properly aligned - -### Confidence Scoring - -Agents use confidence thresholds to decide actions: - -| Score | Action | -|---|---| -| ≥ 0.90 | Proceed with recommendation | -| 0.80–0.89 | Suggest with adaptation notes | -| 0.70–0.79 | Present multiple options, ask user | -| < 0.70 | Escalate or ask for clarification | - ---- - -## Using AgentSpec to Develop AgentSpec - -This repo uses its own SDD workflow for feature development: - -```bash -gh copilot suggest "Use agentspec:brainstorm-agent to explore 'add new KB domain for Redis'" -gh copilot suggest "Use agentspec:define-agent to capture requirements from BRAINSTORM_REDIS_KB.md" -gh copilot suggest "Use agentspec:build-agent to implement DESIGN_REDIS_KB.md" -``` - -Active WIP docs are in `.github/sdd/features/`. Check there before starting new work to avoid duplicating in-flight features. - diff --git a/plugin-copilot/skills/core-meeting/SKILL.md b/plugin-copilot/skills/core-meeting/SKILL.md index 0140f7f..63c6308 100644 --- a/plugin-copilot/skills/core-meeting/SKILL.md +++ b/plugin-copilot/skills/core-meeting/SKILL.md @@ -1,6 +1,9 @@ --- name: meeting -description: Analyze meeting transcripts — extract decisions, action items, and create SSOT documents. Use when processing standup notes, stakeholder reviews, or sprint meetings. +description: | + Analyze meeting transcripts — extract decisions, action items, and create SSOT + documents. Use when processing standup notes, stakeholder reviews, or sprint + meetings. --- # /meeting Command diff --git a/plugin-copilot/skills/core-memory/SKILL.md b/plugin-copilot/skills/core-memory/SKILL.md index 464f729..c2617f3 100644 --- a/plugin-copilot/skills/core-memory/SKILL.md +++ b/plugin-copilot/skills/core-memory/SKILL.md @@ -1,6 +1,8 @@ --- name: memory -description: Save valuable insights from the current session to storage. Use when you've discovered decisions, patterns, or gotchas worth remembering across sessions. +description: | + Save valuable insights from the current session to storage. Use when you've + discovered decisions, patterns, or gotchas worth remembering across sessions. --- # Memory Command diff --git a/plugin-copilot/skills/core-readme-maker/SKILL.md b/plugin-copilot/skills/core-readme-maker/SKILL.md index 54de63d..261107a 100644 --- a/plugin-copilot/skills/core-readme-maker/SKILL.md +++ b/plugin-copilot/skills/core-readme-maker/SKILL.md @@ -1,6 +1,9 @@ --- name: readme-maker -description: Generate comprehensive, production-ready README.md by analyzing codebase with explorer + documenter agents. Use when creating or updating project documentation. +description: | + Generate comprehensive, production-ready README.md by analyzing codebase with + explorer + documenter agents. Use when creating or updating project + documentation. --- # README Maker Command diff --git a/plugin-copilot/skills/core-sync-context/SKILL.md b/plugin-copilot/skills/core-sync-context/SKILL.md index cd7ea92..cc981f0 100644 --- a/plugin-copilot/skills/core-sync-context/SKILL.md +++ b/plugin-copilot/skills/core-sync-context/SKILL.md @@ -1,6 +1,9 @@ --- name: sync-context -description: Sync project context to copilot-instructions.md by analyzing codebase patterns and conventions. Use after adding agents, commands, or significant architecture changes. +description: | + Sync project context to copilot-instructions.md by analyzing codebase patterns + and conventions. Use after adding agents, commands, or significant + architecture changes. --- # Sync Context Command diff --git a/plugin-copilot/skills/data-engineering-ai-pipeline/SKILL.md b/plugin-copilot/skills/data-engineering-ai-pipeline/SKILL.md index a197298..87a3cde 100644 --- a/plugin-copilot/skills/data-engineering-ai-pipeline/SKILL.md +++ b/plugin-copilot/skills/data-engineering-ai-pipeline/SKILL.md @@ -1,6 +1,9 @@ --- name: ai-pipeline -description: RAG/embedding pipeline scaffolding — delegates to de-ai-data-engineer agent. Use when building RAG pipelines, embedding workflows, feature stores, or text-to-SQL systems. +description: | + RAG/embedding pipeline scaffolding — delegates to de-ai-data-engineer agent. + Use when building RAG pipelines, embedding workflows, feature stores, or text- + to-SQL systems. --- # AI Pipeline Command diff --git a/plugin-copilot/skills/data-engineering-data-contract/SKILL.md b/plugin-copilot/skills/data-engineering-data-contract/SKILL.md index 14714c2..2fd53be 100644 --- a/plugin-copilot/skills/data-engineering-data-contract/SKILL.md +++ b/plugin-copilot/skills/data-engineering-data-contract/SKILL.md @@ -1,6 +1,9 @@ --- name: data-contract -description: Data contract authoring (ODCS) — delegates to test-data-contracts-engineer agent. Use when defining producer-consumer agreements, SLAs, or schema governance rules. +description: | + Data contract authoring (ODCS) — delegates to test-data-contracts-engineer + agent. Use when defining producer-consumer agreements, SLAs, or schema + governance rules. --- # Data Contract Command diff --git a/plugin-copilot/skills/data-engineering-data-quality/SKILL.md b/plugin-copilot/skills/data-engineering-data-quality/SKILL.md index f724e06..655a0b6 100644 --- a/plugin-copilot/skills/data-engineering-data-quality/SKILL.md +++ b/plugin-copilot/skills/data-engineering-data-quality/SKILL.md @@ -1,6 +1,9 @@ --- name: data-quality -description: Data quality rules generation — delegates to test-data-quality-analyst agent. Use when generating Great Expectations suites, dbt tests, or SQL quality assertions for your data models. +description: | + Data quality rules generation — delegates to test-data-quality-analyst agent. + Use when generating Great Expectations suites, dbt tests, or SQL quality + assertions for your data models. --- # Data Quality Command diff --git a/plugin-copilot/skills/data-engineering-lakehouse/SKILL.md b/plugin-copilot/skills/data-engineering-lakehouse/SKILL.md index 1b4e62f..3af372a 100644 --- a/plugin-copilot/skills/data-engineering-lakehouse/SKILL.md +++ b/plugin-copilot/skills/data-engineering-lakehouse/SKILL.md @@ -1,6 +1,9 @@ --- name: lakehouse -description: Table format and catalog guidance — delegates to architect-lakehouse agent. Use when working with Iceberg, Delta Lake, catalogs, or migrating from legacy table formats. +description: | + Table format and catalog guidance — delegates to architect-lakehouse agent. + Use when working with Iceberg, Delta Lake, catalogs, or migrating from legacy + table formats. --- # Lakehouse Command diff --git a/plugin-copilot/skills/data-engineering-migrate/SKILL.md b/plugin-copilot/skills/data-engineering-migrate/SKILL.md index 8f4d0eb..b7e9c11 100644 --- a/plugin-copilot/skills/data-engineering-migrate/SKILL.md +++ b/plugin-copilot/skills/data-engineering-migrate/SKILL.md @@ -1,6 +1,9 @@ --- name: migrate -description: Legacy ETL migration — delegates to de-dbt-specialist and de-spark-engineer agents. Use when converting stored procedures, SSIS packages, or Informatica workflows to modern stack. +description: | + Legacy ETL migration — delegates to de-dbt-specialist and de-spark-engineer + agents. Use when converting stored procedures, SSIS packages, or Informatica + workflows to modern stack. --- # Migrate Command diff --git a/plugin-copilot/skills/data-engineering-pipeline/SKILL.md b/plugin-copilot/skills/data-engineering-pipeline/SKILL.md index 22739d5..24b5dd4 100644 --- a/plugin-copilot/skills/data-engineering-pipeline/SKILL.md +++ b/plugin-copilot/skills/data-engineering-pipeline/SKILL.md @@ -1,6 +1,8 @@ --- name: pipeline -description: DAG/pipeline scaffolding — delegates to architect-pipeline agent. Use when scaffolding Airflow or Dagster pipelines with best-practice patterns. +description: | + DAG/pipeline scaffolding — delegates to architect-pipeline agent. Use when + scaffolding Airflow or Dagster pipelines with best-practice patterns. --- # Pipeline Command diff --git a/plugin-copilot/skills/data-engineering-schema/SKILL.md b/plugin-copilot/skills/data-engineering-schema/SKILL.md index f266199..4f71881 100644 --- a/plugin-copilot/skills/data-engineering-schema/SKILL.md +++ b/plugin-copilot/skills/data-engineering-schema/SKILL.md @@ -1,6 +1,9 @@ --- name: schema -description: Interactive schema design — delegates to architect-schema-designer agent. Use when designing star schemas, Data Vault models, SCD strategies, or DDL for any target platform. +description: | + Interactive schema design — delegates to architect-schema-designer agent. Use + when designing star schemas, Data Vault models, SCD strategies, or DDL for any + target platform. --- # Schema Command diff --git a/plugin-copilot/skills/data-engineering-sql-review/SKILL.md b/plugin-copilot/skills/data-engineering-sql-review/SKILL.md index 918db99..0068432 100644 --- a/plugin-copilot/skills/data-engineering-sql-review/SKILL.md +++ b/plugin-copilot/skills/data-engineering-sql-review/SKILL.md @@ -1,6 +1,9 @@ --- name: sql-review -description: SQL-specific code review — delegates to de-sql-optimizer + python-code-reviewer agents. Use when reviewing SQL for anti-patterns, performance issues, or cross-dialect correctness. +description: | + SQL-specific code review — delegates to de-sql-optimizer + python-code- + reviewer agents. Use when reviewing SQL for anti-patterns, performance issues, + or cross-dialect correctness. --- # SQL Review Command diff --git a/plugin-copilot/skills/data-scientist-eda/SKILL.md b/plugin-copilot/skills/data-scientist-eda/SKILL.md index 98b730c..abad6b0 100644 --- a/plugin-copilot/skills/data-scientist-eda/SKILL.md +++ b/plugin-copilot/skills/data-scientist-eda/SKILL.md @@ -1,6 +1,9 @@ --- -name: ds-eda -description: Exploratory data analysis for data scientists — delegates to ds-eda-analyst agent. Use when profiling datasets, visualizing distributions, checking correlations, or detecting missing data and outliers. +name: eda +description: | + Exploratory data analysis for data scientists — delegates to ds-eda-analyst + agent. Use when profiling datasets, visualizing distributions, checking + correlations, or detecting missing data and outliers. --- # EDA Command diff --git a/plugin-copilot/skills/data-scientist-experiment-tracking/SKILL.md b/plugin-copilot/skills/data-scientist-experiment-tracking/SKILL.md index cde48ae..82381f3 100644 --- a/plugin-copilot/skills/data-scientist-experiment-tracking/SKILL.md +++ b/plugin-copilot/skills/data-scientist-experiment-tracking/SKILL.md @@ -1,6 +1,10 @@ --- -name: ds-experiment-tracking -description: Experiment tracking and ML deployment for data scientists — delegates to ds-experiment-tracker and ds-ml-deployer agents. Use when logging MLflow runs, comparing experiments, registering models, promoting to production, serving via API, or running batch inference. +name: experiment-tracking +description: | + Experiment tracking and ML deployment for data scientists — delegates to ds- + experiment-tracker and ds-ml-deployer agents. Use when logging MLflow runs, + comparing experiments, registering models, promoting to production, serving + via API, or running batch inference. --- # Experiment Tracking Command diff --git a/plugin-copilot/skills/data-scientist-feature-engineering/SKILL.md b/plugin-copilot/skills/data-scientist-feature-engineering/SKILL.md index 1be5efd..8d802e0 100644 --- a/plugin-copilot/skills/data-scientist-feature-engineering/SKILL.md +++ b/plugin-copilot/skills/data-scientist-feature-engineering/SKILL.md @@ -1,6 +1,10 @@ --- -name: ds-feature-engineering -description: Feature engineering for data scientists — delegates to ds-feature-engineer agent. Use when building scikit-learn Pipelines, encoding categoricals, imputing missing values, scaling features, or creating lag/rolling features for time series. +name: feature-engineering +description: | + Feature engineering for data scientists — delegates to ds-feature-engineer + agent. Use when building scikit-learn Pipelines, encoding categoricals, + imputing missing values, scaling features, or creating lag/rolling features + for time series. --- # Feature Engineering Command diff --git a/plugin-copilot/skills/data-scientist-model-evaluation/SKILL.md b/plugin-copilot/skills/data-scientist-model-evaluation/SKILL.md index f863d22..5ef35b4 100644 --- a/plugin-copilot/skills/data-scientist-model-evaluation/SKILL.md +++ b/plugin-copilot/skills/data-scientist-model-evaluation/SKILL.md @@ -1,6 +1,10 @@ --- -name: ds-model-evaluation -description: Model evaluation for data scientists — delegates to ds-model-evaluator agent. Use when computing classification or regression metrics, plotting ROC/PR curves, calibrating probabilities, tuning decision thresholds, or comparing models statistically. +name: model-evaluation +description: | + Model evaluation for data scientists — delegates to ds-model-evaluator agent. + Use when computing classification or regression metrics, plotting ROC/PR + curves, calibrating probabilities, tuning decision thresholds, or comparing + models statistically. --- # Model Evaluation Command diff --git a/plugin-copilot/skills/data-scientist-model-training/SKILL.md b/plugin-copilot/skills/data-scientist-model-training/SKILL.md index bb27aec..a83391f 100644 --- a/plugin-copilot/skills/data-scientist-model-training/SKILL.md +++ b/plugin-copilot/skills/data-scientist-model-training/SKILL.md @@ -1,6 +1,9 @@ --- -name: ds-model-training -description: Model training for data scientists — delegates to ds-model-trainer agent. Use when training classification or regression models, tuning hyperparameters with Optuna, running cross-validation, or comparing multiple algorithms. +name: model-training +description: | + Model training for data scientists — delegates to ds-model-trainer agent. Use + when training classification or regression models, tuning hyperparameters with + Optuna, running cross-validation, or comparing multiple algorithms. --- # Model Training Command diff --git a/plugin-copilot/skills/excalidraw-diagram/SKILL.md b/plugin-copilot/skills/excalidraw-diagram/SKILL.md index 560656c..0729c36 100644 --- a/plugin-copilot/skills/excalidraw-diagram/SKILL.md +++ b/plugin-copilot/skills/excalidraw-diagram/SKILL.md @@ -1,6 +1,8 @@ --- name: diagram -description: Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, architectures, or concepts. +description: | + Create Excalidraw diagram JSON files that make visual arguments. Use when the + user wants to visualize workflows, architectures, or concepts. --- # Excalidraw Diagram Creator diff --git a/plugin-copilot/skills/knowledge-create-kb/SKILL.md b/plugin-copilot/skills/knowledge-create-kb/SKILL.md index 511f148..4d10de3 100644 --- a/plugin-copilot/skills/knowledge-create-kb/SKILL.md +++ b/plugin-copilot/skills/knowledge-create-kb/SKILL.md @@ -1,6 +1,8 @@ --- name: create-kb -description: Create a complete KB domain from scratch with MCP validation. Use when adding a new knowledge base domain for a technology, library, or concept. +description: | + Create a complete KB domain from scratch with MCP validation. Use when adding + a new knowledge base domain for a technology, library, or concept. --- # Create Knowledge Base Command diff --git a/plugin-copilot/skills/review-code/SKILL.md b/plugin-copilot/skills/review-code/SKILL.md index c90d70f..089c9f6 100644 --- a/plugin-copilot/skills/review-code/SKILL.md +++ b/plugin-copilot/skills/review-code/SKILL.md @@ -1,6 +1,9 @@ --- name: code -description: Dual AI code review with CodeRabbit + Claude Code for maximum coverage. Use when reviewing changes before a PR, or for deep architectural analysis of committed code. +description: | + Dual AI code review with CodeRabbit + Claude Code for maximum coverage. Use + when reviewing changes before a PR, or for deep architectural analysis of + committed code. --- # Review Command diff --git a/plugin-copilot/skills/visual-explainer-diff-review/SKILL.md b/plugin-copilot/skills/visual-explainer-diff-review/SKILL.md index 0aa36d6..a58efb4 100644 --- a/plugin-copilot/skills/visual-explainer-diff-review/SKILL.md +++ b/plugin-copilot/skills/visual-explainer-diff-review/SKILL.md @@ -1,6 +1,9 @@ --- name: diff-review -description: Generate a visual HTML diff review — before/after architecture comparison with code review analysis. Use when visualizing code changes, comparing branches, or reviewing PRs visually. +description: | + Generate a visual HTML diff review — before/after architecture comparison with + code review analysis. Use when visualizing code changes, comparing branches, + or reviewing PRs visually. --- Load the visual-explainer skill, then generate a comprehensive visual diff review as a self-contained HTML page. diff --git a/plugin-copilot/skills/visual-explainer-fact-check/SKILL.md b/plugin-copilot/skills/visual-explainer-fact-check/SKILL.md index 9c4ae3e..d799045 100644 --- a/plugin-copilot/skills/visual-explainer-fact-check/SKILL.md +++ b/plugin-copilot/skills/visual-explainer-fact-check/SKILL.md @@ -1,6 +1,9 @@ --- name: fact-check -description: Verify the factual accuracy of a document against the actual codebase, correct inaccuracies in place. Use when validating HTML review pages, plan documents, or any document making claims about code. +description: | + Verify the factual accuracy of a document against the actual codebase, correct + inaccuracies in place. Use when validating HTML review pages, plan documents, + or any document making claims about code. --- Load the visual-explainer skill, then verify the factual accuracy of a document that makes claims about a codebase. Read the file, extract every verifiable claim, check each against the actual code and git history, correct inaccuracies in place, and add a verification summary. diff --git a/plugin-copilot/skills/visual-explainer-generate-slides/SKILL.md b/plugin-copilot/skills/visual-explainer-generate-slides/SKILL.md index 07633e9..145dace 100644 --- a/plugin-copilot/skills/visual-explainer-generate-slides/SKILL.md +++ b/plugin-copilot/skills/visual-explainer-generate-slides/SKILL.md @@ -1,6 +1,9 @@ --- name: generate-slides -description: Generate a stunning magazine-quality slide deck as a self-contained HTML page. Use when creating presentations, stakeholder decks, or visual storytelling for any technical topic. +description: | + Generate a stunning magazine-quality slide deck as a self-contained HTML page. + Use when creating presentations, stakeholder decks, or visual storytelling for + any technical topic. --- Load the visual-explainer skill, then generate a slide deck for: $@ diff --git a/plugin-copilot/skills/visual-explainer-generate-visual-plan/SKILL.md b/plugin-copilot/skills/visual-explainer-generate-visual-plan/SKILL.md index f793ffc..4257660 100644 --- a/plugin-copilot/skills/visual-explainer-generate-visual-plan/SKILL.md +++ b/plugin-copilot/skills/visual-explainer-generate-visual-plan/SKILL.md @@ -1,6 +1,9 @@ --- name: generate-visual-plan -description: Generate a visual HTML implementation plan — detailed feature specification with state machines, code snippets, and edge cases. Use when planning a feature implementation with architectural depth. +description: | + Generate a visual HTML implementation plan — detailed feature specification + with state machines, code snippets, and edge cases. Use when planning a + feature implementation with architectural depth. --- Load the visual-explainer skill, then generate a comprehensive visual implementation plan for `$@` as a self-contained HTML page. diff --git a/plugin-copilot/skills/visual-explainer-generate-web-diagram/SKILL.md b/plugin-copilot/skills/visual-explainer-generate-web-diagram/SKILL.md index a5fdfe9..500d1af 100644 --- a/plugin-copilot/skills/visual-explainer-generate-web-diagram/SKILL.md +++ b/plugin-copilot/skills/visual-explainer-generate-web-diagram/SKILL.md @@ -1,6 +1,9 @@ --- name: generate-web-diagram -description: Generate a beautiful standalone HTML diagram and open it in the browser. Use when visualizing workflows, architectures, systems, or any concept that benefits from a rich visual page. +description: | + Generate a beautiful standalone HTML diagram and open it in the browser. Use + when visualizing workflows, architectures, systems, or any concept that + benefits from a rich visual page. --- Load the visual-explainer skill, then generate an HTML diagram for: $@ diff --git a/plugin-copilot/skills/visual-explainer-plan-review/SKILL.md b/plugin-copilot/skills/visual-explainer-plan-review/SKILL.md index f11deba..e02192f 100644 --- a/plugin-copilot/skills/visual-explainer-plan-review/SKILL.md +++ b/plugin-copilot/skills/visual-explainer-plan-review/SKILL.md @@ -1,6 +1,9 @@ --- name: plan-review -description: Generate a visual HTML plan review — current codebase state vs. proposed implementation plan. Use when evaluating a spec, RFC, or design document against the actual codebase. +description: | + Generate a visual HTML plan review — current codebase state vs. proposed + implementation plan. Use when evaluating a spec, RFC, or design document + against the actual codebase. --- Load the visual-explainer skill, then generate a comprehensive visual plan review as a self-contained HTML page, comparing the current codebase against a proposed implementation plan. diff --git a/plugin-copilot/skills/visual-explainer-project-recap/SKILL.md b/plugin-copilot/skills/visual-explainer-project-recap/SKILL.md index a37eac5..a8ba2d2 100644 --- a/plugin-copilot/skills/visual-explainer-project-recap/SKILL.md +++ b/plugin-copilot/skills/visual-explainer-project-recap/SKILL.md @@ -1,6 +1,9 @@ --- name: project-recap -description: Generate a visual HTML project recap — rebuild mental model of a project's current state, recent decisions, and cognitive debt hotspots. Use when re-entering a project or summarizing recent activity. +description: | + Generate a visual HTML project recap — rebuild mental model of a project's + current state, recent decisions, and cognitive debt hotspots. Use when re- + entering a project or summarizing recent activity. --- Load the visual-explainer skill, then generate a comprehensive visual project recap as a self-contained HTML page. diff --git a/plugin-copilot/skills/visual-explainer-share/SKILL.md b/plugin-copilot/skills/visual-explainer-share/SKILL.md index da4c735..02ded5b 100644 --- a/plugin-copilot/skills/visual-explainer-share/SKILL.md +++ b/plugin-copilot/skills/visual-explainer-share/SKILL.md @@ -1,6 +1,9 @@ --- name: share -description: Share a visual explainer HTML file instantly via Vercel — returns a live URL with no authentication required. Use when sharing diagrams, reviews, or slide decks with others. +description: | + Share a visual explainer HTML file instantly via Vercel — returns a live URL + with no authentication required. Use when sharing diagrams, reviews, or slide + decks with others. --- # Share Visual Explainer Page diff --git a/plugin-copilot/skills/visual-explainer/SKILL.md b/plugin-copilot/skills/visual-explainer/SKILL.md index c591955..b5212d2 100644 --- a/plugin-copilot/skills/visual-explainer/SKILL.md +++ b/plugin-copilot/skills/visual-explainer/SKILL.md @@ -1,11 +1,14 @@ --- name: visual-explainer -description: Generate beautiful, self-contained HTML pages that visually explain systems, code changes, plans, and data. Use when the user asks for a diagram, architecture overview, diff review, plan review, project recap, comparison table, or any visual explanation of technical concepts. Also use proactively when you are about to render a complex ASCII table (4+ rows or 3+ columns) — present it as a styled HTML page instead. -license: MIT -compatibility: Requires a browser to view generated HTML files. Optional surf-cli for AI image generation. -metadata: - author: nicobailon - version: "0.5.1" +description: | + Generate beautiful, self-contained HTML pages that visually explain systems, + code changes, plans, and data. Use when the user asks for a diagram, + architecture overview, diff review, plan review, project recap, comparison + table, or any visual explanation of technical concepts. Also use proactively + when you are about to render a complex ASCII table (4+ rows or 3+ columns) — + present it as a styled HTML page instead. license: MIT compatibility: Requires + a browser to view generated HTML files. Optional surf-cli for AI image + generation. metadata: author: nicobailon version: "0.5.1" --- # Visual Explainer diff --git a/plugin-copilot/skills/workflow-brainstorm/SKILL.md b/plugin-copilot/skills/workflow-brainstorm/SKILL.md index 0db931a..b5fdc35 100644 --- a/plugin-copilot/skills/workflow-brainstorm/SKILL.md +++ b/plugin-copilot/skills/workflow-brainstorm/SKILL.md @@ -1,6 +1,9 @@ --- name: brainstorm -description: Explore ideas through collaborative dialogue before requirements capture (Phase 0). Use when the user wants to brainstorm a feature, explore an idea, or hasn't defined requirements yet. +description: | + Explore ideas through collaborative dialogue before requirements capture + (Phase 0). Use when the user wants to brainstorm a feature, explore an idea, + or hasn't defined requirements yet. --- # Brainstorm Command diff --git a/plugin-copilot/skills/workflow-build/SKILL.md b/plugin-copilot/skills/workflow-build/SKILL.md index 03afd8f..bfa0a8d 100644 --- a/plugin-copilot/skills/workflow-build/SKILL.md +++ b/plugin-copilot/skills/workflow-build/SKILL.md @@ -1,6 +1,9 @@ --- name: build -description: Execute implementation with on-the-fly task generation from a DESIGN document (Phase 3). Use when the user wants to implement a feature that has a completed DESIGN document. +description: | + Execute implementation with on-the-fly task generation from a DESIGN document + (Phase 3). Use when the user wants to implement a feature that has a completed + DESIGN document. --- # Build Command diff --git a/plugin-copilot/skills/workflow-create-pr/SKILL.md b/plugin-copilot/skills/workflow-create-pr/SKILL.md index 65bb933..8e2a3df 100644 --- a/plugin-copilot/skills/workflow-create-pr/SKILL.md +++ b/plugin-copilot/skills/workflow-create-pr/SKILL.md @@ -1,7 +1,9 @@ --- name: create-pr -description: Create a pull request with conventional commits and a structured description. Use when the user wants to open a PR, commit changes, or submit work for review. -allowed-tools: shell +description: | + Create a pull request with conventional commits and a structured description. + Use when the user wants to open a PR, commit changes, or submit work for + review. allowed-tools: shell --- # Create PR Command diff --git a/plugin-copilot/skills/workflow-define/SKILL.md b/plugin-copilot/skills/workflow-define/SKILL.md index b7d4a5f..c5e12ef 100644 --- a/plugin-copilot/skills/workflow-define/SKILL.md +++ b/plugin-copilot/skills/workflow-define/SKILL.md @@ -1,6 +1,9 @@ --- name: define -description: Capture and validate requirements in one pass (Phase 1). Use when the user wants to extract requirements from notes, emails, a BRAINSTORM document, or a direct request. +description: | + Capture and validate requirements in one pass (Phase 1). Use when the user + wants to extract requirements from notes, emails, a BRAINSTORM document, or a + direct request. --- # Define Command diff --git a/plugin-copilot/skills/workflow-design/SKILL.md b/plugin-copilot/skills/workflow-design/SKILL.md index 8dc57c2..23a4003 100644 --- a/plugin-copilot/skills/workflow-design/SKILL.md +++ b/plugin-copilot/skills/workflow-design/SKILL.md @@ -1,6 +1,9 @@ --- name: design -description: Create architecture and technical specification from a DEFINE document (Phase 2). Use when the user wants to design a solution, create an architecture, or plan implementation after requirements are captured. +description: | + Create architecture and technical specification from a DEFINE document (Phase + 2). Use when the user wants to design a solution, create an architecture, or + plan implementation after requirements are captured. --- # Design Command diff --git a/plugin-copilot/skills/workflow-iterate/SKILL.md b/plugin-copilot/skills/workflow-iterate/SKILL.md index 98ded66..dbded2c 100644 --- a/plugin-copilot/skills/workflow-iterate/SKILL.md +++ b/plugin-copilot/skills/workflow-iterate/SKILL.md @@ -1,6 +1,9 @@ --- name: iterate -description: Update any SDD phase document when requirements or design change (Cross-Phase). Use when the user needs to modify a BRAINSTORM, DEFINE, or DESIGN document mid-stream and wants cascade awareness. +description: | + Update any SDD phase document when requirements or design change (Cross- + Phase). Use when the user needs to modify a BRAINSTORM, DEFINE, or DESIGN + document mid-stream and wants cascade awareness. --- # Iterate Command diff --git a/plugin-copilot/skills/workflow-ship/SKILL.md b/plugin-copilot/skills/workflow-ship/SKILL.md index 9fa4aa8..e241308 100644 --- a/plugin-copilot/skills/workflow-ship/SKILL.md +++ b/plugin-copilot/skills/workflow-ship/SKILL.md @@ -1,6 +1,9 @@ --- name: ship -description: Archive a completed feature with lessons learned (Phase 4). Use when the build is done, all tests pass, and the user wants to finalize and archive the feature. +description: | + Archive a completed feature with lessons learned (Phase 4). Use when the build + is done, all tests pass, and the user wants to finalize and archive the + feature. --- # Ship Command diff --git a/scripts/fix_skill_descriptions.py b/scripts/fix_skill_descriptions.py new file mode 100644 index 0000000..03cf12d --- /dev/null +++ b/scripts/fix_skill_descriptions.py @@ -0,0 +1,30 @@ +"""Convert inline skill descriptions to YAML block scalar format (description: |).""" +import re +import textwrap +from pathlib import Path + +skills_dir = Path(".github/skills") +changed = [] + +for skill_file in sorted(skills_dir.glob("*/SKILL.md")): + content = skill_file.read_text(encoding="utf-8") + # Only match inline descriptions (not already block scalar with |) + m = re.match(r'^(---\nname: .+\n)description: (?!\|)(.+?)(\n---)', content, re.DOTALL) + if not m: + continue + prefix = m.group(1) + desc = m.group(2).strip() + suffix = m.group(3) + rest = content[m.end():] + + # Word-wrap to 78 chars (80 - 2 indent), indent each line with 2 spaces for YAML block scalar + wrapped = textwrap.fill(desc, width=78) + indented = "\n".join(" " + line for line in wrapped.split("\n")) + + new_content = f"{prefix}description: |\n{indented}{suffix}{rest}" + skill_file.write_text(new_content, encoding="utf-8") + changed.append(skill_file.name) + +print(f"Updated {len(changed)} files:") +for f in changed: + print(f" {f}")