@geraldmaron/construct 1.0.14 → 1.0.15

package/skills/compliance/license-audit.md

@@ -1,8 +1,7 @@
-<!--
-skills/compliance/license-audit.md (License Audit) Dependency license review and open-source compliance.
-
-Use this skill when auditing dependency licenses, evaluating OSS compliance risk, or preparing license inventories for legal review.
--->
+---
+name: compliance-license-audit
+description: Use this skill when auditing dependency licenses, evaluating OSS compliance risk, or preparing license inventories for legal review.
+---
 # License Audit
 
 Use this skill when auditing dependency licenses, evaluating OSS compliance risk, or preparing license inventories for legal review.

package/skills/compliance/regulatory-review.md

@@ -1,8 +1,7 @@
-<!--
-skills/compliance/regulatory-review.md (Regulatory Review) Pre-ship compliance review checklist and process.
-
-Use this skill when conducting a compliance review before shipping features that handle user data, financial transactions, AI decisions, or regulated content.
--->
+---
+name: compliance-regulatory-review
+description: Use this skill when conducting a compliance review before shipping features that handle user data, financial transactions, AI decisions, or regulated content.
+---
 # Regulatory Review
 
 Use this skill when conducting a compliance review before shipping features that handle user data, financial transactions, AI decisions, or regulated content.

package/skills/development/cpp.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/cpp.md (C/C++ Best Practices) Use this skill when writing, reviewing, or debugging C or C++ code.
-
-Use this skill when writing, reviewing, or debugging C or C++ code. ## Project Structure
--->
+---
+name: development-cpp
+description: Use this skill when writing, reviewing, or debugging C or C++ code.
+---
 # C/C++ Best Practices
 
 Use this skill when writing, reviewing, or debugging C or C++ code.

package/skills/development/go.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/go.md (Go Best Practices) Use this skill when writing, reviewing, or debugging Go code.
-
-Use this skill when writing, reviewing, or debugging Go code. ## Project Structure
--->
+---
+name: development-go
+description: Use this skill when writing, reviewing, or debugging Go code.
+---
 # Go Best Practices
 
 Use this skill when writing, reviewing, or debugging Go code.

package/skills/development/java.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/java.md (Java Best Practices) Use this skill when writing, reviewing, or debugging Java or Kotlin code on the
-
-Use this skill when writing, reviewing, or debugging Java or Kotlin code on the JVM. ## Project Structure
--->
+---
+name: development-java
+description: Use this skill when writing, reviewing, or debugging Java or Kotlin code on the JVM.
+---
 # Java Best Practices
 
 Use this skill when writing, reviewing, or debugging Java or Kotlin code on the JVM.

package/skills/development/kotlin.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/kotlin.md (Kotlin / Android Development) | Scope | Use when |
-
-## Coroutines & Flows ### Coroutine scope discipline
--->
+---
+name: development-kotlin
+description: Patterns, anti-patterns, and reference guidance for Kotlin / Android Development. Use when the task involves kotlin / android development.
+---
 # Kotlin / Android Development
 
 ## Coroutines & Flows

package/skills/development/mobile-crossplatform.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/mobile-crossplatform.md (Mobile Cross-Platform Development) Before choosing a framework, answer:
-
-## Decision Framework: Native vs Cross-Platform Before choosing a framework, answer:
--->
+---
+name: development-mobile-crossplatform
+description: Before choosing a framework, answer:. Use when the task matches the trigger conditions described in the body.
+---
 # Mobile Cross-Platform Development
 
 ## Decision Framework: Native vs Cross-Platform

package/skills/development/python.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/python.md (Python Best Practices) Use this skill when writing, reviewing, or debugging Python code.
-
-Use this skill when writing, reviewing, or debugging Python code. ## Project Structure
--->
+---
+name: development-python
+description: Use this skill when writing, reviewing, or debugging Python code.
+---
 # Python Best Practices
 
 Use this skill when writing, reviewing, or debugging Python code.

package/skills/development/rust.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/rust.md (Rust Best Practices) Use this skill when writing, reviewing, or debugging Rust code.
-
-Use this skill when writing, reviewing, or debugging Rust code. ## Project Structure
--->
+---
+name: development-rust
+description: Use this skill when writing, reviewing, or debugging Rust code.
+---
 # Rust Best Practices
 
 Use this skill when writing, reviewing, or debugging Rust code.

package/skills/development/shell.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/shell.md (Shell Scripting Best Practices) Use this skill when writing, reviewing, or debugging Bash, Zsh, or POSIX shell s
-
-Use this skill when writing, reviewing, or debugging Bash, Zsh, or POSIX shell scripts. ## Script Header
--->
+---
+name: development-shell
+description: Use this skill when writing, reviewing, or debugging Bash, Zsh, or POSIX shell scripts.
+---
 # Shell Scripting Best Practices
 
 Use this skill when writing, reviewing, or debugging Bash, Zsh, or POSIX shell scripts.

package/skills/development/swift.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/swift.md (Swift / iOS Development) Swift 6 enforces data-race safety at compile time. Annotate isolation boundary e
-
-## Concurrency (Swift 6 Strict Concurrency) Swift 6 enforces data-race safety at compile time. Annotate isolation boundary explicitly:
--->
+---
+name: development-swift
+description: Swift 6 enforces data-race safety at compile time. Annotate isolation boundary explicitly:. Use when the task matches the trigger conditions described in the body.
+---
 # Swift / iOS Development
 
 ## Concurrency (Swift 6 Strict Concurrency)

package/skills/development/typescript.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/typescript.md (TypeScript Best Practices) Use this skill when writing, reviewing, or debugging TypeScript or JavaScript co
-
-Use this skill when writing, reviewing, or debugging TypeScript or JavaScript code. ## Project Structure
--->
+---
+name: development-typescript
+description: Use this skill when writing, reviewing, or debugging TypeScript or JavaScript code.
+---
 # TypeScript Best Practices
 
 Use this skill when writing, reviewing, or debugging TypeScript or JavaScript code.

package/skills/devops/ci-cd.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/ci-cd.md (CI/CD) Use this skill when designing, debugging, or optimizing CI/CD pipelines.
-
-Use this skill when designing, debugging, or optimizing CI/CD pipelines. ## Pipeline Stages
--->
+---
+name: devops-ci-cd
+description: Use this skill when designing, debugging, or optimizing CI/CD pipelines.
+---
 # CI/CD
 
 Use this skill when designing, debugging, or optimizing CI/CD pipelines.

package/skills/devops/containerization.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/containerization.md (Containerization) Use this skill when writing Dockerfiles, optimizing image size, or securing cont
-
-Use this skill when writing Dockerfiles, optimizing image size, or securing container builds. ## Multi-Stage Builds
--->
+---
+name: devops-containerization
+description: Use this skill when writing Dockerfiles, optimizing image size, or securing container builds.
+---
 # Containerization
 
 Use this skill when writing Dockerfiles, optimizing image size, or securing container builds.

package/skills/devops/cost-optimization.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/cost-optimization.md (Cloud Cost Optimization) Use this skill when reducing cloud spend, right-sizing resources, or implementin
-
-Use this skill when reducing cloud spend, right-sizing resources, or implementing FinOps practices. ## Cost Visibility
--->
+---
+name: devops-cost-optimization
+description: Use this skill when reducing cloud spend, right-sizing resources, or implementing FinOps practices.
+---
 # Cloud Cost Optimization
 
 Use this skill when reducing cloud spend, right-sizing resources, or implementing FinOps practices.

package/skills/devops/data-engineering.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/data-engineering.md (Data Engineering) 1. **Idempotency**: pipelines can run multiple times without duplicating data
-
-## Core Principles 1. **Idempotency**: pipelines can run multiple times without duplicating data
--->
+---
+name: devops-data-engineering
+description: "1. **Idempotency**: pipelines can run multiple times without duplicating data 2. **Observability**: every pipeline run logs row counts, latency, and anomalies 3. **Data contracts**: producers and consumers agree on schema and SLAs 4. **Lineage**: know where every column came from and what it feeds. Use when the task matches the trigger conditions described in the body."
+---
 # Data Engineering
 
 ## Core Principles

package/skills/devops/database.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/database.md (Database Patterns) Use this skill when designing schemas, writing migrations, optimizing queries, o
-
-Use this skill when designing schemas, writing migrations, optimizing queries, or selecting databases. ## Schema Design
--->
+---
+name: devops-database
+description: Use this skill when designing schemas, writing migrations, optimizing queries, or selecting databases.
+---
 # Database Patterns
 
 Use this skill when designing schemas, writing migrations, optimizing queries, or selecting databases.

package/skills/devops/dependency-management.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/dependency-management.md (Dependency Management) Use this skill when managing package upgrades, resolving CVEs, or establishing l
-
-Use this skill when managing package upgrades, resolving CVEs, or establishing lock file and versioning policy. ## Lock File Hygiene
--->
+---
+name: devops-dependency-management
+description: Use this skill when managing package upgrades, resolving CVEs, or establishing lock file and versioning policy.
+---
 # Dependency Management
 
 Use this skill when managing package upgrades, resolving CVEs, or establishing lock file and versioning policy.

package/skills/devops/devsecops.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/devsecops.md (DevSecOps) Use this skill when integrating security into CI/CD pipelines, managing supply c
-
-Use this skill when integrating security into CI/CD pipelines, managing supply chain risk, or automating security scanning. ## Pipeline Security Stages
--->
+---
+name: devops-devsecops
+description: Use this skill when integrating security into CI/CD pipelines, managing supply chain risk, or automating security scanning.
+---
 # DevSecOps
 
 Use this skill when integrating security into CI/CD pipelines, managing supply chain risk, or automating security scanning.

package/skills/devops/git-workflow.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/git-workflow.md (Git Workflow) Use this skill when establishing branching strategies, commit conventions, or co
-
-Use this skill when establishing branching strategies, commit conventions, or code integration practices. ## Branching Strategies
--->
+---
+name: devops-git-workflow
+description: Use this skill when establishing branching strategies, commit conventions, or code integration practices.
+---
 # Git Workflow
 
 Use this skill when establishing branching strategies, commit conventions, or code integration practices.

package/skills/devops/incident-response.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/incident-response.md (Incident Response) | Sev | User impact | Response time | Example |
-
-## Severity Levels | Sev | User impact | Response time | Example |
--->
+---
+name: devops-incident-response
+description: "Define severity in your runbook and assign it early: it determines escalation and comms cadence. Use when the task matches the trigger conditions described in the body."
+---
 # Incident Response
 
 ## Severity Levels

package/skills/devops/monorepo.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/monorepo.md (Monorepo) Use this skill when selecting monorepo tooling, structuring packages, or optimiz
-
-Use this skill when selecting monorepo tooling, structuring packages, or optimizing affected-only builds. ## Tool Selection
--->
+---
+name: devops-monorepo
+description: Use this skill when selecting monorepo tooling, structuring packages, or optimizing affected-only builds.
+---
 # Monorepo
 
 Use this skill when selecting monorepo tooling, structuring packages, or optimizing affected-only builds.

package/skills/devops/observability.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/observability.md (Observability) Use this skill when designing logging, tracing, metrics, or alerting systems.
-
-Use this skill when designing logging, tracing, metrics, or alerting systems. ## Three Pillars
--->
+---
+name: devops-observability
+description: Use this skill when designing logging, tracing, metrics, or alerting systems.
+---
 # Observability
 
 Use this skill when designing logging, tracing, metrics, or alerting systems.

package/skills/devops/performance.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/performance.md (Performance Engineering) Use this skill when profiling, load testing, or optimizing application and infra
-
-Use this skill when profiling, load testing, or optimizing application and infrastructure performance. ## Performance Targets
--->
+---
+name: devops-performance
+description: Use this skill when profiling, load testing, or optimizing application and infrastructure performance.
+---
 # Performance Engineering
 
 Use this skill when profiling, load testing, or optimizing application and infrastructure performance.

package/skills/devops/testing.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/testing.md (Testing Strategy) Use this skill when planning test coverage, selecting test types, or establishin
-
-Use this skill when planning test coverage, selecting test types, or establishing testing practices. ## Test Pyramid
--->
+---
+name: devops-testing
+description: Use this skill when planning test coverage, selecting test types, or establishing testing practices.
+---
 # Testing Strategy
 
 Use this skill when planning test coverage, selecting test types, or establishing testing practices.

package/skills/docs/adr-workflow.md

@@ -1,10 +1,7 @@
-<!--
-skills/docs/adr-workflow.md: Workflow for recording an architectural decision as an ADR.
-
-Triggered when cx-architect finalizes a design or a technology choice is made. Writes a
-full ADR to docs/adr/ using the shipped template (user-overridable via .cx/templates/docs/adr.md)
-and a shorter entry to .cx/decisions/ for session context.
--->
+---
+name: docs-adr-workflow
+description: "Use when: an architectural decision is made that affects the system structure, data model, API contracts, or technology choices."
+---
 # ADR Workflow
 
 Use when: an architectural decision is made that affects the system structure, data model, API contracts, or technology choices.

package/skills/docs/backlog-proposal-workflow.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/backlog-proposal-workflow.md: Approval-gated issue tracker proposals.
--->
+---
+name: docs-backlog-proposal-workflow
+description: "Use when: product evidence should create or update Jira, Linear, GitHub Issues, or another tracker."
+---
 # Backlog Proposal Workflow
 
 Use when: product evidence should create or update Jira, Linear, GitHub Issues, or another tracker.

package/skills/docs/customer-profile-workflow.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/customer-profile-workflow.md: Maintain durable customer/account memory for Product Intelligence.
--->
+---
+name: docs-customer-profile-workflow
+description: "Use when: customer evidence should update durable product memory."
+---
 # Customer Profile Workflow
 
 Use when: customer evidence should update durable product memory.

package/skills/docs/document-ingest-workflow.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/document-ingest-workflow.md: Convert source documents into retrieval-ready markdown artifacts.
--->
+---
+name: docs-document-ingest-workflow
+description: "Use when: the user points at a PDF, Word doc, spreadsheet, slide deck, export, or mixed document folder and wants a markdown version that Construct can search efficiently later."
+---
 # Document Ingest Workflow
 
 Use when: the user points at a PDF, Word doc, spreadsheet, slide deck, export, or mixed document folder and wants a markdown version that Construct can search efficiently later.

package/skills/docs/evidence-ingest-workflow.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/evidence-ingest-workflow.md: Normalize raw product evidence into Construct knowledge artifacts.
--->
+---
+name: docs-evidence-ingest-workflow
+description: "Use when: the user pastes customer notes, Slack threads, support tickets, sales notes, research snippets, RFCs, analytics summaries, or competitor signals."
+---
 # Evidence Ingest Workflow
 
 Use when: the user pastes customer notes, Slack threads, support tickets, sales notes, research snippets, RFCs, analytics summaries, or competitor signals.

package/skills/docs/init-docs.md

@@ -1,8 +1,7 @@
-<!--
-skills/docs/init-docs.md (Skill: init-docs) Initialize Project Documentation Structure: `init docs`, `create docs structure`, `set up documentation`, `docs scaffold`, `documentation init`
-
-## Trigger keywords `init docs`, `create docs structure`, `set up documentation`, `docs scaffold`, `documentation init`
--->
+---
+name: docs-init-docs
+description: "`init docs`, `create docs structure`, `set up documentation`, `docs scaffold`, `documentation init`. Use when the task matches the trigger conditions described in the body."
+---
 # Skill: init-docs: Initialize Project Documentation Structure
 
 ## Trigger keywords

package/skills/docs/init-project.md

@@ -1,8 +1,7 @@
-<!--
-skills/docs/init-project.md (Project Initialization) Use when: starting work on a new project or joining an existing one without doc
-
-Use when: starting work on a new project or joining an existing one without doc structure. ## Command
--->
+---
+name: docs-init-project
+description: "Use when: starting work on a new project or joining an existing one without doc structure."
+---
 # Project Initialization
 
 Use when: starting work on a new project or joining an existing one without doc structure.

package/skills/docs/prd-workflow.md

@@ -1,10 +1,7 @@
-<!--
-skills/docs/prd-workflow.md: Workflow for producing a PRD and connecting it to workflow task packets.
-
-Guides cx-product-manager through requirements gathering, user research, and writing a PRD
-to docs/prd/. Once approved, the PRD feeds /plan feature to create bead packets in
-.cx/workflow.json: closing the loop from discovery to execution.
--->
+---
+name: docs-prd-workflow
+description: "Use when: the user asks to create a PRD, platform spec, business case, RFC, or requirements document."
+---
 # PRD Workflow
 
 Use when: the user asks to create a PRD, platform spec, business case, RFC, or requirements document.

package/skills/docs/prfaq-workflow.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/prfaq-workflow.md: Working-backwards PRFAQ generation from PRDs or evidence.
--->
+---
+name: docs-prfaq-workflow
+description: "Use when: the user asks for a PRFAQ, working-backwards doc, launch narrative, or FAQ grounded in product evidence."
+---
 # PRFAQ Workflow
 
 Use when: the user asks for a PRFAQ, working-backwards doc, launch narrative, or FAQ grounded in product evidence.

package/skills/docs/product-intelligence-review.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/product-intelligence-review.md: Evaluate Product Intelligence artifacts before they become docs of record.
--->
+---
+name: docs-product-intelligence-review
+description: "Use when: reviewing PRDs, Meta PRDs, PRFAQs, evidence briefs, signal briefs, customer profiles, or backlog proposals."
+---
 # Product Intelligence Review
 
 Use when: reviewing PRDs, Meta PRDs, PRFAQs, evidence briefs, signal briefs, customer profiles, or backlog proposals.

package/skills/docs/product-intelligence-workflow.md

@@ -1,9 +1,7 @@
-<!--
-skills/docs/product-intelligence-workflow.md: Native Construct workflow for product evidence, synthesis, and product docs.
-
-Use this to move from raw product evidence to PRDs, Meta PRDs, PRFAQs, signal briefs,
-customer profiles, and backlog proposals without creating a separate sidecar system.
--->
+---
+name: docs-product-intelligence-workflow
+description: "Use when: the request involves customer evidence, PM synthesis, product requirements, PRDs, PRFAQs, customer profiles, product signals, or backlog proposals."
+---
 # Product Intelligence Workflow
 
 Use when: the request involves customer evidence, PM synthesis, product requirements, PRDs, PRFAQs, customer profiles, product signals, or backlog proposals.

package/skills/docs/product-signal-workflow.md

@@ -1,8 +1,7 @@
-<!--
-skills/docs/product-signal-workflow.md: Synthesize product signals from evidence into the right artifact.
-Confidence rubric, contradiction resolution, artifact decision tree, and storage are all defined here.
-Follow rules/common/research.md for source-handling policy.
--->
+---
+name: docs-product-signal-workflow
+description: "Use when: the user asks what customers are asking for, what themes are emerging, whether evidence is strong enough, or what should become a PRD."
+---
 # Product Signal Workflow
 
 Use when: the user asks what customers are asking for, what themes are emerging, whether evidence is strong enough, or what should become a PRD.

package/skills/docs/research-workflow.md

@@ -1,8 +1,7 @@
-<!--
-skills/docs/research-workflow.md (Research Workflow) Use when: the user asks to research a topic, investigate a question, or gather e
-
-Use when: the user asks to research a topic, investigate a question, or gather evidence for a decision. ## Steps
--->
+---
+name: docs-research-workflow
+description: "Use when: the user asks to research a topic, investigate a question, or gather evidence for a decision."
+---
 # Research Workflow
 
 Use when: the user asks to research a topic, investigate a question, or gather evidence for a decision.

package/skills/docs/runbook-workflow.md

@@ -1,8 +1,7 @@
-<!--
-skills/docs/runbook-workflow.md (Runbook Workflow) Use when: creating operational procedures for services, alerts, or recurring ope
-
-Use when: creating operational procedures for services, alerts, or recurring operations. ## Steps
--->
+---
+name: docs-runbook-workflow
+description: "Use when: creating operational procedures for services, alerts, or recurring operations."
+---
 # Runbook Workflow
 
 Use when: creating operational procedures for services, alerts, or recurring operations.

package/skills/docs/strategy-workflow.md

@@ -1,8 +1,7 @@
-<!--
-skills/docs/strategy-workflow.md: Read, update, and reason about the product strategy.
-Canonical store: ~/.cx/strategy.md (user-global) or .cx/strategy.md (project-local, committed).
-Template: templates/docs/strategy.md.
--->
+---
+name: docs-strategy-workflow
+description: "Use when: the user asks about product direction, strategic bets, what to prioritize, whether a signal aligns with strategy, or wants to update the strategy."
+---
 # Strategy Workflow
 
 Use when: the user asks about product direction, strategic bets, what to prioritize, whether a signal aligns with strategy, or wants to update the strategy.

package/skills/exploration/dependency-graph-reading.md

@@ -1,10 +1,7 @@
-<!--
-skills/exploration/dependency-graph-reading.md (Dependency Graph Reading)
-Use when auditing a project's supply chain risk, evaluating upgrade paths,
-or assessing the risk surface of a new codebase. Covers npm/cargo/maven
-lockfile interpretation, transitive dependency patterns, and risk signals.
--->
-
+---
+name: exploration-dependency-graph-reading
+description: Use when assessing the risk surface of a project's dependencies, planning upgrades, or evaluating a new codebase's supply chain posture.
+---
 # Dependency Graph Reading
 
 Use when assessing the risk surface of a project's dependencies, planning upgrades, or evaluating a new codebase's supply chain posture.

package/skills/exploration/repo-map.md

@@ -1,8 +1,7 @@
-<!--
-skills/exploration/repo-map.md (Repo Exploration) Codebase Mapping Playbook: Use this skill when entering an unfamiliar codebase, doing deep investigation wo
-
-Use this skill when entering an unfamiliar codebase, doing deep investigation work, or producing a `.cx/codebase-map.md` artifact for future sessions. Agents: `
--->
+---
+name: exploration-repo-map
+description: Use this skill when entering an unfamiliar codebase, doing deep investigation work, or producing a `.cx/codebase-map.md` artifact for future sessions.
+---
 # Repo Exploration: Codebase Mapping Playbook
 
 Use this skill when entering an unfamiliar codebase, doing deep investigation work, or producing a `.cx/codebase-map.md` artifact for future sessions.

package/skills/exploration/tracer-bullet-method.md

@@ -1,10 +1,7 @@
-<!--
-skills/exploration/tracer-bullet-method.md (Tracer Bullet Method)
-Use when starting implementation in an unfamiliar or complex system.
-A tracer bullet is a minimal end-to-end path through the system,
-real code, real infrastructure, real calls, before any deep work begins.
--->
-
+---
+name: exploration-tracer-bullet-method
+description: Use when beginning implementation in a new system, new integration, or new architectural layer. A tracer bullet is not a prototype; it is the thinnest possible complete path through the real system.
+---
 # Tracer Bullet Method
 
 Use when beginning implementation in a new system, new integration, or new architectural layer. A tracer bullet is not a prototype; it is the thinnest possible complete path through the real system.

package/skills/exploration/unknown-codebase-onboarding.md

@@ -1,10 +1,7 @@
-<!--
-skills/exploration/unknown-codebase-onboarding.md (Unknown Codebase Onboarding)
-Use when a specialist is operating in a new or unfamiliar codebase and
-needs a systematic path from zero context to productive contribution.
-Covers first-hour, first-day, and first-week checkpoints.
--->
-
+---
+name: exploration-unknown-codebase-onboarding
+description: Use when entering an unfamiliar codebase for the first time, or when the task requires understanding a system you haven't touched before.
+---
 # Unknown Codebase Onboarding
 
 Use when entering an unfamiliar codebase for the first time, or when the task requires understanding a system you haven't touched before.