@kynetic-ai/spec 0.7.0 → 0.8.0

package/templates/skills/plan/SKILL.md

@@ -8,7 +8,7 @@ Translate approved plans into specs and tasks. Plans are durable artifacts — t
 - Creating specs for new features or multi-spec capabilities
 - Translating design documents into the spec hierarchy
 
-**Not for:** Raw ideas (use `kspec inbox add`), single spec creation (use `/kspec:writing-specs`), or triage (use `/kspec:triage`).
+**Not for:** Raw ideas (use `kspec inbox add`), single spec creation (use `{skill:writing-specs}`), or triage (use `{skill:triage}`).
 
 ## Two Paths
 
@@ -330,7 +330,7 @@ kspec validate --alignment
 
 ## Integration
 
-- **`/kspec:writing-specs`** — Spec authoring details (types, AC format, traits)
-- **`/kspec:task-work`** — After specs are created, work on derived tasks
-- **`/kspec:triage`** — Inbox items may trigger plan creation
-- **`/kspec:observations`** — Friction during planning becomes observations
+- **`{skill:writing-specs}`** — Spec authoring details (types, AC format, traits)
+- **`{skill:task-work}`** — After specs are created, work on derived tasks
+- **`{skill:triage}`** — Inbox items may trigger plan creation
+- **`{skill:observations}`** — Friction during planning becomes observations

package/templates/skills/reflect/SKILL.md

@@ -150,6 +150,6 @@ kspec workflow resume         # Resume
 
 ## Integration
 
-- Observations created during reflection feed into `/kspec:triage observations`
+- Observations created during reflection feed into `{skill:triage} observations`
 - Friction observations may be promoted to tasks via `kspec meta promote @ref`
 - Success patterns may inform AGENTS.md or convention updates

package/templates/skills/review/SKILL.md

@@ -218,6 +218,6 @@ Project-specific gates to add in your own review skill:
 
 ## Integration
 
-- **`/kspec:task-work`** — Run review before submitting tasks
-- **`/kspec:writing-specs`** — If review reveals spec gaps, update specs first
+- **`{skill:task-work}`** — Run review before submitting tasks
+- **`{skill:writing-specs}`** — If review reveals spec gaps, update specs first
 - **`kspec validate`** — Automated validation complements manual review

package/templates/skills/task-work/SKILL.md

@@ -8,7 +8,7 @@ Structured workflow for working on tasks. Full lifecycle from start through PR m
 - Continuing in-progress or needs_work tasks
 - Ensuring consistent task lifecycle with notes and audit trail
 
-**Not for:** Spec creation (use `/kspec:writing-specs`), plan translation (use `/kspec:plan`), or triage (use `/kspec:triage`).
+**Not for:** Spec creation (use `{skill:writing-specs}`), plan translation (use `{skill:plan}`), or triage (use `{skill:triage}`).
 
 ## Inherit Existing Work First
 
@@ -305,8 +305,8 @@ kspec session start
 
 ## Integration
 
-- **`/kspec:writing-specs`** — Create specs before deriving tasks
-- **`/kspec:plan`** — Plans create specs that become tasks
-- **`/kspec:review`** — Review checks AC coverage and code quality
-- **`/kspec:observations`** — Capture friction found during task work
-- **`/kspec:reflect`** — Session reflection after completing tasks
+- **`{skill:writing-specs}`** — Create specs before deriving tasks
+- **`{skill:plan}`** — Plans create specs that become tasks
+- **`{skill:review}`** — Review checks AC coverage and code quality
+- **`{skill:observations}`** — Capture friction found during task work
+- **`{skill:reflect}`** — Session reflection after completing tasks

package/templates/skills/triage/SKILL.md

@@ -178,7 +178,7 @@ kspec batch --commands '[
 ]'
 ```
 
-Use `--dry-run` to preview. See `/kspec:help` for full batch documentation.
+Use `--dry-run` to preview. See `{skill:help}` for full batch documentation.
 
 ## Key Principles
 

package/templates/skills/triage/docs/inbox.md

@@ -120,7 +120,7 @@ kspec batch --commands '[
 ]'
 ```
 
-Use `--dry-run` to preview. See `/kspec:help` for full batch documentation.
+Use `--dry-run` to preview. See `{skill:help}` for full batch documentation.
 
 ## Common Patterns
 

package/templates/skills/triage/docs/observations.md

@@ -64,7 +64,7 @@ kspec batch --commands '[
 ]'
 ```
 
-Use `--dry-run` to preview. See `/kspec:help` for full batch documentation.
+Use `--dry-run` to preview. See `{skill:help}` for full batch documentation.
 
 ## Common Patterns
 

package/templates/skills/triage-automation/SKILL.md

@@ -129,6 +129,6 @@ kspec tasks ready --needs-review           # Tasks needing human triage
 
 ## Integration
 
-- **`/kspec:triage-inbox`** — Inbox triage may promote items to tasks needing assessment
+- **`{skill:triage-inbox}`** — Inbox triage may promote items to tasks needing assessment
 - **`kspec tasks ready --eligible`** — Used by task-work loop to find automatable work
 - **Ralph loop** — Consumes eligible tasks; automation assessment feeds the pipeline

package/templates/skills/triage-inbox/SKILL.md

@@ -186,7 +186,7 @@ kspec batch --commands '[
 ]'
 ```
 
-Use `--dry-run` to preview. See `/kspec:help` for full batch documentation.
+Use `--dry-run` to preview. See `{skill:help}` for full batch documentation.
 
 ## Common Patterns
 
@@ -220,6 +220,6 @@ At session end, provide summary:
 
 ## Integration
 
-- **`/kspec:reflect`** — Session reflection may generate inbox items for triage
-- **`/kspec:observations`** — Captures systemic patterns found during triage
+- **`{skill:reflect}`** — Session reflection may generate inbox items for triage
+- **`{skill:observations}`** — Captures systemic patterns found during triage
 - **`kspec session start`** — Shows inbox count for triage awareness

package/templates/skills/writing-specs/SKILL.md

@@ -10,7 +10,7 @@ Create and maintain specification items — the source of truth for what to buil
 - Organizing specs under the right module/parent
 - Reviewing spec quality before deriving tasks
 
-**Not for:** Task management (use `/kspec:task-work`), plan-to-spec translation (use `/kspec:plan`), or triage (use `/kspec:triage`).
+**Not for:** Task management (use `{skill:task-work}`), plan-to-spec translation (use `{skill:plan}`), or triage (use `{skill:triage}`).
 
 ## Finding Things
 
@@ -340,8 +340,8 @@ The derived task gets `spec_ref: @feature-slug` automatically.
 
 ## Integration
 
-- **`/kspec:plan`** — Plans create specs via import or manual creation
-- **`/kspec:task-work`** — Tasks reference specs; AC guides implementation
-- **`/kspec:triage`** — Inbox items may reveal spec gaps
-- **`/kspec:observations`** — Friction may indicate missing specs
-- **`/kspec:review`** — Reviews check AC coverage
+- **`{skill:plan}`** — Plans create specs via import or manual creation
+- **`{skill:task-work}`** — Tasks reference specs; AC guides implementation
+- **`{skill:triage}`** — Inbox items may reveal spec gaps
+- **`{skill:observations}`** — Friction may indicate missing specs
+- **`{skill:review}`** — Reviews check AC coverage