@tydung26/product-kit 0.1.1 → 0.1.3

package/README.md

@@ -1,27 +1,27 @@
 # product-kit
 
-PM skills for Claude Code, Antigravity, and OpenCode AI assistants.
+PM commands for Claude Code, Antigravity, and OpenCode AI assistants.
 
 ## Install
 
 ```bash
-npm install -g product-kit
+npm install -g @tydung26/product-kit
 ```
 
 ## Usage
 
 ```bash
-pkit install              # Interactive: pick tool + skills
-pkit install --yes        # Install all skills to all tools
-pkit list                 # Show available/installed skills
-pkit update               # Update all installed skills
+pkit init              # Interactive: pick tool + commands
+pkit init --yes        # Install all commands to all tools
+pkit list                 # Show available/installed commands
+pkit update               # Update all installed commands
 pkit remove pkit:brainstorm
 pkit config               # View configuration
 pkit config set toolPaths.antigravity /custom/path
 pkit doctor               # Diagnose installation issues
 ```
 
-## Skills
+## Commands
 
 | Slash Command | Purpose |
 |---|---|
@@ -34,8 +34,8 @@ pkit doctor               # Diagnose installation issues
 
 | Tool | Global path |
 |---|---|
-| Claude Code + OpenCode | `~/.claude/skills/` |
-| Antigravity | `~/.gemini/antigravity/skills/` |
+| Claude Code + OpenCode | `~/.claude/commands/pkit/` |
+| Antigravity | `~/.gemini/antigravity/commands/pkit/` |
 
 ## License
 

package/{skills/pkit:brainstorm/SKILL.md → commands/pkit/brainstorm.md}

@@ -1,15 +1,12 @@
 ---
-name: "pkit:brainstorm"
-description: >
-  Use for brainstorming product ideas, feature ideation, exploring solutions,
-  and creative divergent thinking sessions. Triggers on: brainstorm, ideate,
-  explore ideas, what if we, what could we build, idea generation, think through
-  options. Do NOT use for writing PRDs (use pkit:make-prd), roadmaps
-  (use pkit:roadmap-planner), or competitor research (use pkit:competitive-analysis).
-license: MIT
+description: Ideation → clustered themes → top picks with risks and next steps
+argument-hint: <product/feature/problem-space>
 ---
 
-# pkit:brainstorm
+Brainstorm product ideas or solutions for the given topic.
+<task>$ARGUMENTS</task>
+
+---
 
 You are a creative product strategist with experience across B2B SaaS, consumer apps, and enterprise software. Your job is to facilitate structured ideation that's both divergent (many ideas) and useful (grounded in real user needs).
 
@@ -21,7 +18,7 @@ Invoke `/pkit:brainstorm` when you need to:
 - Break out of tunnel vision on a single approach
 - Prepare for a product strategy session
 
-**Do NOT use for:** Writing formal PRDs, building roadmaps, or analyzing competitors — those have dedicated skills.
+**Do NOT use for:** Writing formal PRDs, building roadmaps, or analyzing competitors — those have dedicated commands.
 
 ## Workflow
 

package/{skills/pkit:competitive-analysis/SKILL.md → commands/pkit/competitive-analysis.md}

@@ -1,15 +1,12 @@
 ---
-name: "pkit:competitive-analysis"
-description: >
-  Use for competitive analysis, market research, and understanding the competitive
-  landscape. Triggers on: competitive analysis, analyze competitors, compare to
-  competitors, who else does this, market analysis, competitive landscape, how does
-  X compare to Y. Do NOT use for internal feature comparisons, A/B test decisions,
-  or product roadmaps.
-license: MIT
+description: Competitor profiles → feature matrix → whitespace opportunities
+argument-hint: <product/market> [focus-area]
 ---
 
-# pkit:competitive-analysis
+Run a structured competitive analysis for the given product or market.
+<task>$ARGUMENTS</task>
+
+---
 
 You are a senior product strategist with deep market research experience. You produce structured, actionable competitive analysis — not generic summaries.
 

package/commands/pkit/make-prd.md

@@ -0,0 +1,177 @@
+---
+description: Clarifying questions → full PRD → user stories with acceptance criteria
+argument-hint: <feature-name>
+---
+
+Write a Product Requirements Document for the given feature.
+<task>$ARGUMENTS</task>
+
+---
+
+You are a Senior PM at a B2B SaaS company. You write clear, complete PRDs that give engineering and design exactly what they need — no more, no less.
+
+## When to Use
+
+Invoke `/pkit:make-prd` when you need to:
+- Write a PRD for a new feature or product
+- Create a feature spec before engineering kickoff
+- Document requirements for stakeholder alignment
+
+**Do NOT use for:** Roadmap planning, brainstorming ideas, or competitive research.
+
+## Workflow
+
+### Step 1 — Ask Clarifying Questions First (Always)
+
+Before writing anything, ask:
+1. What problem does this feature solve?
+2. Who is the primary user? (role, context, what they're trying to do)
+3. What does success look like? (metric or observable outcome)
+4. Any known constraints? (timeline, tech, dependencies, non-goals)
+5. Do you have any existing mockups, data, or research I should incorporate?
+
+If the user has already provided this, skip to Step 2.
+
+### Step 2 — Write the PRD
+
+Use the PRD template below. Fill in every section — do not leave placeholders empty. If you lack information, flag it as an open question.
+
+### Step 3 — Generate Core User Stories
+
+Write 3–5 user stories covering the primary scenarios:
+- Format: "As a [role], I want to [action] so that [benefit]"
+- INVEST criteria: Independent, Negotiable, Valuable, Estimable, Small, Testable
+- Include acceptance criteria in Given/When/Then format
+- Flag edge cases that engineering needs to handle
+
+### Step 4 — Surface Open Questions
+
+List every decision that still needs to be made before engineering can start:
+- UX decisions not yet resolved
+- Technical approach questions
+- Business rule ambiguities
+- Dependencies on other teams
+
+## Quality Checklist
+
+Before finishing, verify:
+- [ ] Problem statement is user-centric (not solution-centric)
+- [ ] Success metrics are measurable (not vague like "improved UX")
+- [ ] Must Have list is genuinely minimum viable (not a wish list)
+- [ ] Every open question has an owner assigned
+- [ ] No technical implementation details in requirements (that's for engineers)
+
+---
+
+## PRD Template
+
+---
+
+# PRD: [Feature Name]
+
+**Status:** Draft
+**Author:** [Name]
+**Date:** [YYYY-MM-DD]
+**Version:** 1.0
+
+---
+
+## Problem
+
+> What problem are we solving, for whom, and why does it matter now?
+
+[2–3 sentences. Lead with the user pain, not the solution.]
+
+---
+
+## Goals & Success Metrics
+
+| Goal | Metric | Target | Measurement Method |
+|------|--------|--------|--------------------|
+| [e.g. Reduce time-to-value] | [e.g. Time to first action] | [e.g. < 2 min] | [e.g. Analytics event] |
+
+---
+
+## Background & Context
+
+> Why are we building this now? What research, data, or feedback drove this?
+
+- [Key insight / data point]
+- [Customer request / interview finding]
+- [Strategic alignment]
+
+---
+
+## User Stories
+
+### Story 1 — [Primary Scenario]
+
+**As a** [role],
+**I want to** [action],
+**So that** [benefit].
+
+**Acceptance Criteria:**
+- Given [context], when [action], then [expected outcome]
+- Given [edge case], when [action], then [safe fallback]
+
+### Story 2 — [Secondary Scenario]
+
+[same format]
+
+---
+
+## Requirements
+
+### Must Have (MVP)
+- [ ] [Requirement — specific and testable]
+- [ ] [Requirement]
+
+### Should Have (v1.1)
+- [ ] [Requirement]
+
+### Won't Have (this version)
+- [Explicitly out of scope item] — *Reason: [why deferred]*
+
+---
+
+## Out of Scope
+
+> Be explicit. What are we NOT building and why?
+
+- [Item] — deferred because [reason]
+- [Item] — handled by [other team/system]
+
+---
+
+## Design & UX Notes
+
+> Link to mockups, Figma, or describe key UX decisions.
+
+- [Link to designs or description]
+- [Key UX decision and rationale]
+
+---
+
+## Technical Considerations
+
+> High-level notes for engineering — not a technical spec.
+
+- [Known constraint or dependency]
+- [Performance or scale consideration]
+- [Integration point]
+
+---
+
+## Open Questions
+
+| Question | Impact | Owner | Due Date | Status |
+|----------|--------|-------|----------|--------|
+| [Question] | High/Med/Low | [Name] | [Date] | Open |
+
+---
+
+## Appendix
+
+> Supporting data, research links, related tickets.
+
+- [Link or reference]

package/{skills/pkit:roadmap-planner/SKILL.md → commands/pkit/roadmap-planner.md}

@@ -1,15 +1,12 @@
 ---
-name: "pkit:roadmap-planner"
-description: >
-  Use for product roadmap planning, quarterly planning, annual planning, and
-  prioritizing what to build over a time horizon. Triggers on: roadmap, product
-  roadmap, quarterly plan, Q1 plan, H1 plan, annual plan, what should we build
-  next, plan next quarter, roadmap planning session. Do NOT use for single-sprint
-  planning or writing individual PRDs.
-license: MIT
+description: NOW/NEXT/LATER roadmap → risk register → exec narrative
+argument-hint: <team/product> [time-horizon]
 ---
 
-# pkit:roadmap-planner
+Plan a product roadmap for the given team or product.
+<task>$ARGUMENTS</task>
+
+---
 
 You are a senior PM with experience running OKR-driven roadmap planning at high-growth companies. You create roadmaps that are strategic (tied to outcomes), honest (confidence levels included), and usable (different views for different audiences).
 

package/dist/commands/doctor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAkB/B,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,QAqEtC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAiB/B,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,QAoEtC"}

package/dist/commands/doctor/index.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerDoctor = registerDoctor;
 const fs_1 = require("fs");
-const path_1 = require("path");
 const config_1 = require("../../domains/config");
 const installation_1 = require("../../domains/installation");
 const skills_1 = require("../../domains/skills");
@@ -29,22 +28,22 @@ function registerDoctor(cli) {
         const nodeOk = nodeVer[0] >= 18;
         if (!check('Node version', nodeOk, process.version, 'Upgrade Node to >=18'))
             issues++;
-        // 2. Skills bundled in package
-        const skillsOk = (0, fs_1.existsSync)(paths_1.PACKAGE_SKILLS_DIR);
-        if (!check('Package skills dir', skillsOk, paths_1.PACKAGE_SKILLS_DIR, 'Reinstall product-kit'))
+        // 2. Commands bundled in package
+        const commandsOk = (0, fs_1.existsSync)(paths_1.PACKAGE_COMMANDS_DIR);
+        if (!check('Package commands dir', commandsOk, paths_1.PACKAGE_COMMANDS_DIR, 'Reinstall product-kit'))
             issues++;
-        // 3. Claude skills path exists
+        // 3. Claude commands path exists
         const claudeOk = (0, fs_1.existsSync)(config.toolPaths.claude);
-        check('Claude skills dir', claudeOk, config.toolPaths.claude, claudeOk ? undefined : `mkdir -p "${config.toolPaths.claude}"`);
+        check('Claude commands dir', claudeOk, config.toolPaths.claude, claudeOk ? undefined : `mkdir -p "${config.toolPaths.claude}"`);
         if (!claudeOk)
             issues++;
         // 4. Antigravity path (warn only — tool may not be installed)
         const agOk = (0, fs_1.existsSync)(config.toolPaths.antigravity);
         if (agOk) {
-            logger_1.log.success(`Antigravity skills dir: ${config.toolPaths.antigravity}`);
+            logger_1.log.success(`Antigravity commands dir: ${config.toolPaths.antigravity}`);
         }
         else {
-            logger_1.log.warn(`Antigravity skills dir not found: ${config.toolPaths.antigravity} (install Antigravity or set toolPaths.antigravity)`);
+            logger_1.log.warn(`Antigravity commands dir not found: ${config.toolPaths.antigravity} (install Antigravity or set toolPaths.antigravity)`);
         }
         // 5. Manifest exists and is valid JSON
         let manifestOk = false;
@@ -60,23 +59,22 @@ function registerDoctor(cli) {
         }
         if (!check('Manifest file', manifestOk, paths_1.MANIFEST_PATH, `rm "${paths_1.MANIFEST_PATH}" and reinstall`))
             issues++;
-        // 6. Verify each installed skill dir still exists and SKILL.md is valid
+        // 6. Verify each installed command file still exists and has valid frontmatter
         const entries = (0, installation_1.getManifestEntries)();
         for (const entry of entries) {
-            const skillFile = (0, path_1.join)(entry.destPath, 'SKILL.md');
-            const exists = (0, fs_1.existsSync)(skillFile);
+            const exists = (0, fs_1.existsSync)(entry.destPath);
             if (!exists) {
                 logger_1.log.error(`Missing: ${entry.name} at ${entry.destPath} — run: pkit install ${entry.name} --force`);
                 issues++;
             }
             else {
                 try {
-                    const content = (0, fs_1.readFileSync)(skillFile, 'utf8');
-                    (0, skills_1.validateSkillContent)(content, skillFile);
+                    const content = (0, fs_1.readFileSync)(entry.destPath, 'utf8');
+                    (0, skills_1.validateSkillContent)(content, entry.destPath);
                     logger_1.log.success(`${entry.name}: valid`);
                 }
                 catch (err) {
-                    logger_1.log.error(`${entry.name}: invalid SKILL.md — ${err instanceof Error ? err.message : String(err)}`);
+                    logger_1.log.error(`${entry.name}: invalid command file — ${err instanceof Error ? err.message : String(err)}`);
                     issues++;
                 }
             }

package/dist/commands/doctor/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":";;AAiBA,wCAoEC;AApFD,2BAA8C;AAC9C,iDAAiD;AACjD,6DAAgE;AAChE,iDAA4D;AAC5D,8CAAyE;AACzE,gDAA0C;AAE1C,SAAS,KAAK,CAAC,KAAa,EAAE,EAAW,EAAE,MAAc,EAAE,GAAY;IACrE,IAAI,EAAE,EAAE,CAAC;QACP,YAAG,CAAC,OAAO,CAAC,GAAG,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,YAAG,CAAC,KAAK,CAAC,GAAG,KAAK,KAAK,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,cAAc,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,cAAc,CAAC,GAAQ;IACrC,GAAG;SACA,OAAO,CAAC,QAAQ,EAAE,mCAAmC,CAAC;SACtD,MAAM,CAAC,GAAG,EAAE;QACX,YAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;QAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,kBAAkB;QAClB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,sBAAsB,CAAC;YAAE,MAAM,EAAE,CAAC;QAEtF,iCAAiC;QACjC,MAAM,UAAU,GAAG,IAAA,eAAU,EAAC,4BAAoB,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE,UAAU,EAAE,4BAAoB,EAAE,uBAAuB,CAAC;YAAE,MAAM,EAAE,CAAC;QAExG,iCAAiC;QACjC,MAAM,QAAQ,GAAG,IAAA,eAAU,EAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACrD,KAAK,CAAC,qBAAqB,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,EAC5D,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ;YAAE,MAAM,EAAE,CAAC;QAExB,8DAA8D;QAC9D,MAAM,IAAI,GAAG,IAAA,eAAU,EAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,IAAI,EAAE,CAAC;YACT,YAAG,CAAC,OAAO,CAAC,6BAA6B,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3E,CAAC;aAAM,CAAC;YACN,YAAG,CAAC,IAAI,CAAC,uCAAuC,MAAM,CAAC,SAAS,CAAC,WAAW,qDAAqD,CAAC,CAAC;QACrI,CAAC;QAED,uCAAuC;QACvC,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,IAAA,eAAU,EAAC,qBAAa,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC;gBAAC,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,qBAAa,EAAE,MAAM,CAAC,CAAC,CAAC;gBAAC,UAAU,GAAG,IAAI,CAAC;YAAC,CAAC;YAC3E,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,IAAI,CAAC,CAAC,mDAAmD;QACxE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,UAAU,EAAE,qBAAa,EAAE,OAAO,qBAAa,iBAAiB,CAAC;YAAE,MAAM,EAAE,CAAC;QAExG,+EAA+E;QAC/E,MAAM,OAAO,GAAG,IAAA,iCAAkB,GAAE,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAA,eAAU,EAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,YAAG,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,QAAQ,wBAAwB,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC;gBACnG,MAAM,EAAE,CAAC;YACX,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBACrD,IAAA,6BAAoB,EAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;oBAC9C,YAAG,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC;gBACtC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,YAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACvG,MAAM,EAAE,CAAC;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QAED,YAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACd,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjB,YAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,YAAG,CAAC,KAAK,CAAC,GAAG,MAAM,mCAAmC,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/install/index.js

@@ -6,7 +6,7 @@ const installation_1 = require("../../domains/installation");
 const prompts_1 = require("../../domains/ui/prompts");
 function registerInstall(cli) {
     cli
-        .command('install [...skills]', 'Install PM skills to AI coding tools')
+        .command('init [...skills]', 'Install PM commands to AI coding tools')
         .option('--tool <tool>', 'Target tool: claude, antigravity, opencode, all')
         .option('--scope <scope>', 'Scope: global or project', { default: 'global' })
         .option('--force', 'Overwrite existing installations')

package/dist/commands/install/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/install/index.ts"],"names":[],"mappings":";;AAcA,0CA2CC;AAxDD,iDAA2D;AAC3D,6DAA2D;AAC3D,sDAAmG;AAWnG,SAAgB,eAAe,CAAC,GAAQ;IACtC,GAAG;SACA,OAAO,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;SACtE,MAAM,CAAC,eAAe,EAAE,iDAAiD,CAAC;SAC1E,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;SAC5E,MAAM,CAAC,SAAS,EAAE,kCAAkC,CAAC;SACrD,MAAM,CAAC,WAAW,EAAE,6DAA6D,CAAC;SAClF,MAAM,CAAC,KAAK,EAAE,MAAgB,EAAE,IAAiB,EAAE,EAAE;QACpD,IAAA,eAAK,EAAC,4BAA4B,CAAC,CAAC;QAEpC,6DAA6D;QAC7D,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,KAAK,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,MAAM,IAAA,6BAAmB,GAAE,IAAI,SAAS,CAAC;gBAChD,IAAI,CAAC,IAAI;oBAAE,OAAO;YACpB,CAAC;QACH,CAAC;QAED,6DAA6D;QAC7D,IAAI,UAAU,GAAG,MAAM,CAAC;QACxB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,IAAA,4BAAmB,GAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzD,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,UAAU,GAAG,SAAS,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,MAAM,IAAA,8BAAoB,EAAC,SAAS,CAAC,CAAC;gBACvD,IAAI,CAAC,QAAQ;oBAAE,OAAO;gBACtB,UAAU,GAAG,QAAQ,CAAC;YACxB,CAAC;QACH,CAAC;QAED,MAAM,IAAA,4BAAa,EAAC,UAAU,EAAE;YAC9B,KAAK,EAAE,IAAgB;YACvB,KAAK,EAAE,IAAI,CAAC,KAAqB;YACjC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;QAEH,IAAA,eAAK,EAAC,oEAAoE,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/install/index.ts"],"names":[],"mappings":";;AAcA,0CA2CC;AAxDD,iDAA2D;AAC3D,6DAA2D;AAC3D,sDAAmG;AAWnG,SAAgB,eAAe,CAAC,GAAQ;IACtC,GAAG;SACA,OAAO,CAAC,kBAAkB,EAAE,wCAAwC,CAAC;SACrE,MAAM,CAAC,eAAe,EAAE,iDAAiD,CAAC;SAC1E,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;SAC5E,MAAM,CAAC,SAAS,EAAE,kCAAkC,CAAC;SACrD,MAAM,CAAC,WAAW,EAAE,6DAA6D,CAAC;SAClF,MAAM,CAAC,KAAK,EAAE,MAAgB,EAAE,IAAiB,EAAE,EAAE;QACpD,IAAA,eAAK,EAAC,4BAA4B,CAAC,CAAC;QAEpC,6DAA6D;QAC7D,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,KAAK,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,MAAM,IAAA,6BAAmB,GAAE,IAAI,SAAS,CAAC;gBAChD,IAAI,CAAC,IAAI;oBAAE,OAAO;YACpB,CAAC;QACH,CAAC;QAED,6DAA6D;QAC7D,IAAI,UAAU,GAAG,MAAM,CAAC;QACxB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,IAAA,4BAAmB,GAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzD,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,UAAU,GAAG,SAAS,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,MAAM,IAAA,8BAAoB,EAAC,SAAS,CAAC,CAAC;gBACvD,IAAI,CAAC,QAAQ;oBAAE,OAAO;gBACtB,UAAU,GAAG,QAAQ,CAAC;YACxB,CAAC;QACH,CAAC;QAED,MAAM,IAAA,4BAAa,EAAC,UAAU,EAAE;YAC9B,KAAK,EAAE,IAAgB;YACvB,KAAK,EAAE,IAAI,CAAC,KAAqB;YACjC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;QAEH,IAAA,eAAK,EAAC,oEAAoE,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/domains/installation/copy-skill-files.d.ts

@@ -8,5 +8,6 @@ export type CopyResult = {
     status: 'failed';
     error: string;
 };
-export declare function copySkillDir(srcDir: string, destBase: string, force: boolean): Promise<CopyResult>;
+export declare function copyCommandFile(srcFile: string, destBase: string, force: boolean): Promise<CopyResult>;
+export declare const copySkillDir: typeof copyCommandFile;
 //# sourceMappingURL=copy-skill-files.d.ts.map

package/dist/domains/installation/copy-skill-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy-skill-files.d.ts","sourceRoot":"","sources":["../../../src/domains/installation/copy-skill-files.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAIxC,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC,CAqBrB"}
+{"version":3,"file":"copy-skill-files.d.ts","sourceRoot":"","sources":["../../../src/domains/installation/copy-skill-files.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAIxC,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC,CAqBrB;AAGD,eAAO,MAAM,YAAY,wBAAkB,CAAC"}

package/dist/domains/installation/copy-skill-files.js

@@ -1,30 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.copySkillDir = copySkillDir;
+exports.copySkillDir = void 0;
+exports.copyCommandFile = copyCommandFile;
 const fs_1 = require("fs");
 const fs_extra_1 = require("fs-extra");
 const path_1 = require("path");
-// Safely copies a skill directory to destBase/skillName.
+// Safely copies a single command .md file to destBase/filename.md.
 // Validates paths to prevent directory traversal attacks.
-async function copySkillDir(srcDir, destBase, force) {
-    const skillName = (0, path_1.basename)(srcDir);
+async function copyCommandFile(srcFile, destBase, force) {
+    const filename = (0, path_1.basename)(srcFile);
     // Path traversal guard: resolved dest must be inside destBase
-    const destSkillDir = (0, path_1.join)(destBase, skillName);
-    if (!(0, path_1.resolve)(destSkillDir).startsWith((0, path_1.resolve)(destBase))) {
-        return { status: 'failed', error: `Path traversal attempt blocked for: ${skillName}` };
+    const destFile = (0, path_1.join)(destBase, filename);
+    if (!(0, path_1.resolve)(destFile).startsWith((0, path_1.resolve)(destBase))) {
+        return { status: 'failed', error: `Path traversal attempt blocked for: ${filename}` };
     }
-    if ((0, fs_1.existsSync)(destSkillDir) && !force) {
+    if ((0, fs_1.existsSync)(destFile) && !force) {
         return { status: 'skipped', reason: 'already installed (use --force to overwrite)' };
     }
     try {
         await (0, fs_extra_1.ensureDir)(destBase);
-        if ((0, fs_1.existsSync)(destSkillDir) && force)
-            await (0, fs_extra_1.remove)(destSkillDir);
-        await (0, fs_extra_1.copy)(srcDir, destSkillDir, { overwrite: force });
-        return { status: 'installed', destPath: destSkillDir };
+        if ((0, fs_1.existsSync)(destFile) && force)
+            await (0, fs_extra_1.remove)(destFile);
+        await (0, fs_extra_1.copy)(srcFile, destFile, { overwrite: force });
+        return { status: 'installed', destPath: destFile };
     }
     catch (err) {
         return { status: 'failed', error: err instanceof Error ? err.message : String(err) };
     }
 }
+// Legacy alias for any callers using the old name
+exports.copySkillDir = copyCommandFile;
 //# sourceMappingURL=copy-skill-files.js.map

package/dist/domains/installation/copy-skill-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"copy-skill-files.js","sourceRoot":"","sources":["../../../src/domains/installation/copy-skill-files.ts"],"names":[],"mappings":";;AAWA,oCAyBC;AApCD,2BAAgC;AAChC,uCAAmD;AACnD,+BAA+C;AAO/C,yDAAyD;AACzD,0DAA0D;AACnD,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,QAAgB,EAChB,KAAc;IAEd,MAAM,SAAS,GAAG,IAAA,eAAQ,EAAC,MAAM,CAAC,CAAC;IAEnC,8DAA8D;IAC9D,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAA,cAAO,EAAC,YAAY,CAAC,CAAC,UAAU,CAAC,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,uCAAuC,SAAS,EAAE,EAAE,CAAC;IACzF,CAAC;IAED,IAAI,IAAA,eAAU,EAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,8CAA8C,EAAE,CAAC;IACvF,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAA,oBAAS,EAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,IAAA,eAAU,EAAC,YAAY,CAAC,IAAI,KAAK;YAAE,MAAM,IAAA,iBAAM,EAAC,YAAY,CAAC,CAAC;QAClE,MAAM,IAAA,eAAI,EAAC,MAAM,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvF,CAAC;AACH,CAAC"}
+{"version":3,"file":"copy-skill-files.js","sourceRoot":"","sources":["../../../src/domains/installation/copy-skill-files.ts"],"names":[],"mappings":";;;AAWA,0CAyBC;AApCD,2BAAgC;AAChC,uCAAmD;AACnD,+BAA+C;AAO/C,mEAAmE;AACnE,0DAA0D;AACnD,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,QAAgB,EAChB,KAAc;IAEd,MAAM,QAAQ,GAAG,IAAA,eAAQ,EAAC,OAAO,CAAC,CAAC;IAEnC,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,uCAAuC,QAAQ,EAAE,EAAE,CAAC;IACxF,CAAC;IAED,IAAI,IAAA,eAAU,EAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,8CAA8C,EAAE,CAAC;IACvF,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAA,oBAAS,EAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,IAAA,eAAU,EAAC,QAAQ,CAAC,IAAI,KAAK;YAAE,MAAM,IAAA,iBAAM,EAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,IAAA,eAAI,EAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvF,CAAC;AACH,CAAC;AAED,kDAAkD;AACrC,QAAA,YAAY,GAAG,eAAe,CAAC"}

package/dist/domains/installation/index.js

@@ -69,7 +69,7 @@ async function installSkills(names, opts) {
     const pkgVersion = getPkgVersion();
     for (const skill of toInstall) {
         for (const destBase of destPaths) {
-            const result = await (0, copy_skill_files_1.copySkillDir)(skill.dirPath, destBase, opts.force ?? false);
+            const result = await (0, copy_skill_files_1.copyCommandFile)(skill.filePath, destBase, opts.force ?? false);
             if (result.status === 'installed') {
                 logger_1.log.success(`Installed: ${skill.name} → ${result.destPath}`);
                 (0, manifest_manager_1.addManifestEntry)({

package/dist/domains/installation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domains/installation/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domains/installation/index.ts"],"names":[],"mappings":"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"}

package/dist/domains/skills/skill-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/skill-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,wBAAgB,mBAAmB,IAAI,KAAK,EAAE,CAsB7C;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAE/D"}
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/skill-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAQzC,wBAAgB,mBAAmB,IAAI,KAAK,EAAE,CAoB7C;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAE/D"}

package/dist/domains/skills/skill-loader.js

@@ -6,31 +6,32 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const paths_1 = require("../../shared/paths");
 const skill_validator_1 = require("./skill-validator");
-// Loads all skills from the bundled skills/ directory
+// Derives the slash-command name from a filename: "brainstorm.md" → "pkit:brainstorm"
+function fileNameToCommandName(filename) {
+    return `pkit:${(0, path_1.basename)(filename, '.md')}`;
+}
+// Loads all commands from the bundled commands/pkit/ directory
 function loadAvailableSkills() {
-    if (!(0, fs_1.existsSync)(paths_1.PACKAGE_SKILLS_DIR))
+    if (!(0, fs_1.existsSync)(paths_1.PACKAGE_COMMANDS_DIR))
         return [];
     const skills = [];
-    const entries = (0, fs_1.readdirSync)(paths_1.PACKAGE_SKILLS_DIR, { withFileTypes: true });
+    const entries = (0, fs_1.readdirSync)(paths_1.PACKAGE_COMMANDS_DIR, { withFileTypes: true });
     for (const entry of entries) {
-        if (!entry.isDirectory())
-            continue;
-        const skillDir = (0, path_1.join)(paths_1.PACKAGE_SKILLS_DIR, entry.name);
-        const skillFile = (0, path_1.join)(skillDir, 'SKILL.md');
-        if (!(0, fs_1.existsSync)(skillFile))
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
             continue;
+        const filePath = (0, path_1.join)(paths_1.PACKAGE_COMMANDS_DIR, entry.name);
         try {
-            const content = (0, fs_1.readFileSync)(skillFile, 'utf8');
-            const meta = (0, skill_validator_1.validateSkillContent)(content, skillFile);
-            skills.push({ name: entry.name, dirPath: skillDir, meta });
+            const content = (0, fs_1.readFileSync)(filePath, 'utf8');
+            const meta = (0, skill_validator_1.validateSkillContent)(content, filePath);
+            skills.push({ name: fileNameToCommandName(entry.name), filePath, meta });
         }
         catch {
-            // Skip invalid skills silently in production
+            // Skip invalid command files silently in production
         }
     }
     return skills;
 }
-// Find a single skill by name (directory name)
+// Find a single command by name (e.g. "pkit:brainstorm")
 function findSkillByName(name) {
     return loadAvailableSkills().find(s => s.name === name);
 }

package/dist/domains/skills/skill-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-loader.js","sourceRoot":"","sources":["../../../src/domains/skills/skill-loader.ts"],"names":[],"mappings":";;AAOA,kDAsBC;AAGD,0CAEC;AAlCD,2BAA2D;AAC3D,+BAA4B;AAC5B,8CAAwD;AACxD,uDAAyD;AAGzD,sDAAsD;AACtD,SAAgB,mBAAmB;IACjC,IAAI,CAAC,IAAA,eAAU,EAAC,0BAAkB,CAAC;QAAE,OAAO,EAAE,CAAC;IAE/C,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAA,gBAAW,EAAC,0BAAkB,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,0BAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAA,eAAU,EAAC,SAAS,CAAC;YAAE,SAAS;QAErC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,IAAA,sCAAoB,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+CAA+C;AAC/C,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,mBAAmB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"skill-loader.js","sourceRoot":"","sources":["../../../src/domains/skills/skill-loader.ts"],"names":[],"mappings":";;AAYA,kDAoBC;AAGD,0CAEC;AArCD,2BAA2D;AAC3D,+BAAsC;AACtC,8CAA0D;AAC1D,uDAAyD;AAGzD,sFAAsF;AACtF,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,OAAO,QAAQ,IAAA,eAAQ,EAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;AAC7C,CAAC;AAED,+DAA+D;AAC/D,SAAgB,mBAAmB;IACjC,IAAI,CAAC,IAAA,eAAU,EAAC,4BAAoB,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjD,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAA,gBAAW,EAAC,4BAAoB,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC7D,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,4BAAoB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAExD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAA,sCAAoB,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yDAAyD;AACzD,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,mBAAmB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC1D,CAAC"}

package/dist/domains/skills/skill-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-validator.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/skill-validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAmB7C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAejF"}
+{"version":3,"file":"skill-validator.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/skill-validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAkB7C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAajF"}

package/dist/domains/skills/skill-validator.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateSkillContent = validateSkillContent;
 const skill_schema_1 = require("../../schemas/skill-schema");
-// Parses YAML frontmatter from SKILL.md content (simple regex, no yaml dep needed)
+// Parses YAML frontmatter from command .md content (simple regex, no yaml dep needed)
 function parseFrontmatter(content) {
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     if (!match)
@@ -13,27 +13,24 @@ function parseFrontmatter(content) {
         if (colonIdx === -1)
             continue;
         const key = line.slice(0, colonIdx).trim();
-        // Handle multi-line values (>) by collapsing them
         const val = line.slice(colonIdx + 1).trim().replace(/^["']|["']$/g, '').trim();
         if (key && val)
             result[key] = val;
     }
     return result;
 }
-// Validates and returns parsed SKILL.md frontmatter, throws on invalid
+// Validates and returns parsed command frontmatter, throws on invalid
 function validateSkillContent(content, filePath) {
     const raw = parseFrontmatter(content);
     if (!raw)
         throw new Error(`No frontmatter found in ${filePath}`);
-    // For multi-line description (> block), collect continuation lines
-    const descMatch = content.match(/description:\s*>\n([\s\S]*?)(?=\n\w|\n---)/);
-    if (descMatch) {
-        raw['description'] = descMatch[1].replace(/\n\s*/g, ' ').trim();
-    }
-    const parsed = skill_schema_1.SkillSchema.safeParse(raw);
+    const parsed = skill_schema_1.CommandSchema.safeParse(raw);
     if (!parsed.success) {
-        throw new Error(`Invalid SKILL.md at ${filePath}: ${parsed.error.message}`);
+        throw new Error(`Invalid command frontmatter at ${filePath}: ${parsed.error.message}`);
     }
-    return parsed.data;
+    return {
+        description: parsed.data.description,
+        argumentHint: parsed.data['argument-hint'],
+    };
 }
 //# sourceMappingURL=skill-validator.js.map

package/dist/domains/skills/skill-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-validator.js","sourceRoot":"","sources":["../../../src/domains/skills/skill-validator.ts"],"names":[],"mappings":";;AAoBA,oDAeC;AAnCD,6DAAyD;AAGzD,mFAAmF;AACnF,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,SAAS;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,kDAAkD;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/E,IAAI,GAAG,IAAI,GAAG;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uEAAuE;AACvE,SAAgB,oBAAoB,CAAC,OAAe,EAAE,QAAgB;IACpE,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IAEjE,mEAAmE;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC9E,IAAI,SAAS,EAAE,CAAC;QACd,GAAG,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,0BAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}
+{"version":3,"file":"skill-validator.js","sourceRoot":"","sources":["../../../src/domains/skills/skill-validator.ts"],"names":[],"mappings":";;AAmBA,oDAaC;AAhCD,6DAA2D;AAG3D,sFAAsF;AACtF,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,SAAS;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/E,IAAI,GAAG,IAAI,GAAG;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sEAAsE;AACtE,SAAgB,oBAAoB,CAAC,OAAe,EAAE,QAAgB;IACpE,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAG,4BAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW;QACpC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/dist/schemas/skill-schema.d.ts

@@ -1,8 +1,12 @@
 import { z } from 'zod';
+export declare const CommandSchema: z.ZodObject<{
+    description: z.ZodString;
+    'argument-hint': z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CommandFrontmatter = z.infer<typeof CommandSchema>;
 export declare const SkillSchema: z.ZodObject<{
-    name: z.ZodString;
     description: z.ZodString;
-    license: z.ZodOptional<z.ZodString>;
+    'argument-hint': z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type SkillFrontmatter = z.infer<typeof SkillSchema>;
+export type SkillFrontmatter = CommandFrontmatter;
 //# sourceMappingURL=skill-schema.d.ts.map

package/dist/schemas/skill-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/skill-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,WAAW;;;;iBAQtB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}
+{"version":3,"file":"skill-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/skill-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,aAAa;;;iBAGxB,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAG/D,eAAO,MAAM,WAAW;;;iBAAgB,CAAC;AACzC,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,CAAC"}

package/dist/schemas/skill-schema.js

@@ -1,16 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SkillSchema = void 0;
+exports.SkillSchema = exports.CommandSchema = void 0;
 const zod_1 = require("zod");
-// Validates SKILL.md YAML frontmatter per agentskills.io spec
-// Name: 1-64 chars, lowercase alphanumeric + hyphens + colons (pkit:name pattern)
-exports.SkillSchema = zod_1.z.object({
-    name: zod_1.z
-        .string()
-        .min(1)
-        .max(64)
-        .regex(/^[a-z0-9:]+([:-][a-z0-9]+)*$/, 'Name must be lowercase alphanumeric with hyphens/colons'),
-    description: zod_1.z.string().min(1).max(1024),
-    license: zod_1.z.string().optional(),
+// Validates command .md YAML frontmatter (Claude Code commands format)
+// description: required, 1-256 chars
+// argument-hint: optional usage hint shown in slash command picker
+exports.CommandSchema = zod_1.z.object({
+    description: zod_1.z.string().min(1).max(256),
+    'argument-hint': zod_1.z.string().optional(),
 });
+// Legacy alias kept for test backward compatibility
+exports.SkillSchema = exports.CommandSchema;
 //# sourceMappingURL=skill-schema.js.map

package/dist/schemas/skill-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-schema.js","sourceRoot":"","sources":["../../src/schemas/skill-schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,8DAA8D;AAC9D,kFAAkF;AACrE,QAAA,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,KAAK,CAAC,8BAA8B,EAAE,yDAAyD,CAAC;IACnG,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACxC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC"}
+{"version":3,"file":"skill-schema.js","sourceRoot":"","sources":["../../src/schemas/skill-schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,uEAAuE;AACvE,qCAAqC;AACrC,mEAAmE;AACtD,QAAA,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAIH,oDAAoD;AACvC,QAAA,WAAW,GAAG,qBAAa,CAAC"}

package/dist/shared/paths.d.ts

@@ -1,4 +1,4 @@
-export declare const PACKAGE_SKILLS_DIR: string;
+export declare const PACKAGE_COMMANDS_DIR: string;
 export declare const CONFIG_DIR: string;
 export declare const MANIFEST_PATH: string;
 export declare const CONFIG_PATH: string;

package/dist/shared/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,kBAAkB,QAAwC,CAAC;AAGxE,eAAO,MAAM,UAAU,QAAuC,CAAC;AAC/D,eAAO,MAAM,aAAa,QAAoC,CAAC;AAC/D,eAAO,MAAM,WAAW,QAAkC,CAAC;AAG3D,eAAO,MAAM,kBAAkB;;;;CAOrB,CAAC;AAGX,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,oBAAoB,QAAkD,CAAC;AAGpF,eAAO,MAAM,UAAU,QAAuC,CAAC;AAC/D,eAAO,MAAM,aAAa,QAAoC,CAAC;AAC/D,eAAO,MAAM,WAAW,QAAkC,CAAC;AAG3D,eAAO,MAAM,kBAAkB;;;;CAOrB,CAAC;AAGX,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC"}

package/dist/shared/paths.js

@@ -1,28 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROJECT_TOOL_SEGMENTS = exports.DEFAULT_TOOL_PATHS = exports.CONFIG_PATH = exports.MANIFEST_PATH = exports.CONFIG_DIR = exports.PACKAGE_SKILLS_DIR = void 0;
+exports.PROJECT_TOOL_SEGMENTS = exports.DEFAULT_TOOL_PATHS = exports.CONFIG_PATH = exports.MANIFEST_PATH = exports.CONFIG_DIR = exports.PACKAGE_COMMANDS_DIR = void 0;
 const os_1 = require("os");
 const path_1 = require("path");
 const home = (0, os_1.homedir)();
-// Absolute path to the skills/ directory bundled in this npm package
-exports.PACKAGE_SKILLS_DIR = (0, path_1.join)(__dirname, '..', '..', 'skills');
+// Absolute path to the commands/pkit/ directory bundled in this npm package
+exports.PACKAGE_COMMANDS_DIR = (0, path_1.join)(__dirname, '..', '..', 'commands', 'pkit');
 // Manifest + config storage
 exports.CONFIG_DIR = (0, path_1.join)(home, '.config', 'product-kit');
 exports.MANIFEST_PATH = (0, path_1.join)(exports.CONFIG_DIR, 'manifest.json');
 exports.CONFIG_PATH = (0, path_1.join)(exports.CONFIG_DIR, 'config.json');
-// Default install paths per tool (global scope)
+// Default install paths per tool (global scope) — commands go into commands/pkit/
 exports.DEFAULT_TOOL_PATHS = {
-    // Claude Code + OpenCode both read ~/.claude/skills/
-    claude: (0, path_1.join)(home, '.claude', 'skills'),
-    // OpenCode also reads ~/.claude/skills — same path, no duplicate copy needed
-    opencode: (0, path_1.join)(home, '.claude', 'skills'),
+    // Claude Code + OpenCode both read ~/.claude/commands/
+    claude: (0, path_1.join)(home, '.claude', 'commands', 'pkit'),
+    // OpenCode shares the same path as Claude Code
+    opencode: (0, path_1.join)(home, '.claude', 'commands', 'pkit'),
     // Antigravity uses a separate path (configurable)
-    antigravity: (0, path_1.join)(home, '.gemini', 'antigravity', 'skills'),
+    antigravity: (0, path_1.join)(home, '.gemini', 'antigravity', 'commands', 'pkit'),
 };
 // Project-scope path segments (joined with cwd at runtime in resolve-paths.ts)
 exports.PROJECT_TOOL_SEGMENTS = {
-    claude: (0, path_1.join)('.claude', 'skills'),
-    opencode: (0, path_1.join)('.opencode', 'skills'),
-    antigravity: (0, path_1.join)('.agent', 'skills'),
+    claude: (0, path_1.join)('.claude', 'commands', 'pkit'),
+    opencode: (0, path_1.join)('.claude', 'commands', 'pkit'),
+    antigravity: (0, path_1.join)('.agent', 'commands', 'pkit'),
 };
 //# sourceMappingURL=paths.js.map

package/dist/shared/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":";;;AAAA,2BAA6B;AAC7B,+BAA4B;AAG5B,MAAM,IAAI,GAAG,IAAA,YAAO,GAAE,CAAC;AAEvB,qEAAqE;AACxD,QAAA,kBAAkB,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAExE,4BAA4B;AACf,QAAA,UAAU,GAAG,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AAClD,QAAA,aAAa,GAAG,IAAA,WAAI,EAAC,kBAAU,EAAE,eAAe,CAAC,CAAC;AAClD,QAAA,WAAW,GAAG,IAAA,WAAI,EAAC,kBAAU,EAAE,aAAa,CAAC,CAAC;AAE3D,gDAAgD;AACnC,QAAA,kBAAkB,GAAG;IAChC,qDAAqD;IACrD,MAAM,EAAE,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC;IACvC,6EAA6E;IAC7E,QAAQ,EAAE,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC;IACzC,kDAAkD;IAClD,WAAW,EAAE,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC;CACnD,CAAC;AAEX,+EAA+E;AAClE,QAAA,qBAAqB,GAAG;IACnC,MAAM,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,QAAQ,CAAC;IACjC,QAAQ,EAAE,IAAA,WAAI,EAAC,WAAW,EAAE,QAAQ,CAAC;IACrC,WAAW,EAAE,IAAA,WAAI,EAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":";;;AAAA,2BAA6B;AAC7B,+BAA4B;AAE5B,MAAM,IAAI,GAAG,IAAA,YAAO,GAAE,CAAC;AAEvB,4EAA4E;AAC/D,QAAA,oBAAoB,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAEpF,4BAA4B;AACf,QAAA,UAAU,GAAG,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AAClD,QAAA,aAAa,GAAG,IAAA,WAAI,EAAC,kBAAU,EAAE,eAAe,CAAC,CAAC;AAClD,QAAA,WAAW,GAAG,IAAA,WAAI,EAAC,kBAAU,EAAE,aAAa,CAAC,CAAC;AAE3D,kFAAkF;AACrE,QAAA,kBAAkB,GAAG;IAChC,uDAAuD;IACvD,MAAM,EAAE,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;IACjD,+CAA+C;IAC/C,QAAQ,EAAE,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;IACnD,kDAAkD;IAClD,WAAW,EAAE,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC;CAC7D,CAAC;AAEX,+EAA+E;AAClE,QAAA,qBAAqB,GAAG;IACnC,MAAM,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;IAC3C,QAAQ,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;IAC7C,WAAW,EAAE,IAAA,WAAI,EAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC;CACvC,CAAC"}

package/dist/types/index.d.ts

@@ -1,13 +1,12 @@
 export type ToolName = 'claude' | 'antigravity' | 'opencode' | 'all';
 export type InstallScope = 'global' | 'project';
 export interface SkillMeta {
-    name: string;
     description: string;
-    license?: string;
+    argumentHint?: string;
 }
 export interface Skill {
     name: string;
-    dirPath: string;
+    filePath: string;
     meta: SkillMeta;
 }
 export interface InstallOptions {

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,KAAK,CAAC;AAGrE,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAGhD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;CACjB;AAGD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,KAAK,CAAC;AAGrE,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAGhD,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;CACjB;AAGD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tydung26/product-kit",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "🧠 Product management skills kit",
   "bin": {
     "pkit": "bin/pkit.js"
@@ -18,7 +18,7 @@
   },
   "files": [
     "dist/",
-    "skills/",
+    "commands/",
     "bin/",
     "README.md"
   ],

package/skills/pkit:make-prd/SKILL.md

@@ -1,69 +0,0 @@
----
-name: "pkit:make-prd"
-description: >
-  Use for writing Product Requirement Documents (PRDs), feature specs, and
-  requirements documents. Triggers on: write a PRD, make a PRD, create a PRD,
-  product requirements, feature spec, spec out this feature, draft requirements,
-  requirements document. Do NOT use for roadmap planning (use pkit:roadmap-planner)
-  or brainstorming (use pkit:brainstorm).
-license: MIT
----
-
-# pkit:make-prd
-
-You are a Senior PM at a B2B SaaS company. You write clear, complete PRDs that give engineering and design exactly what they need — no more, no less.
-
-## When to Use
-
-Invoke `/pkit:make-prd` when you need to:
-- Write a PRD for a new feature or product
-- Create a feature spec before engineering kickoff
-- Document requirements for stakeholder alignment
-
-**Do NOT use for:** Roadmap planning, brainstorming ideas, or competitive research.
-
-## Workflow
-
-### Step 1 — Ask Clarifying Questions First (Always)
-
-Before writing anything, ask:
-1. What problem does this feature solve?
-2. Who is the primary user? (role, context, what they're trying to do)
-3. What does success look like? (metric or observable outcome)
-4. Any known constraints? (timeline, tech, dependencies, non-goals)
-5. Do you have any existing mockups, data, or research I should incorporate?
-
-If the user has already provided this, skip to Step 2.
-
-### Step 2 — Write the PRD
-
-Use the template in `templates/prd-template.md`. Fill in every section — do not leave placeholders empty. If you lack information, flag it as an open question.
-
-### Step 3 — Generate Core User Stories
-
-Write 3–5 user stories covering the primary scenarios:
-- Format: "As a [role], I want to [action] so that [benefit]"
-- INVEST criteria: Independent, Negotiable, Valuable, Estimable, Small, Testable
-- Include acceptance criteria in Given/When/Then format
-- Flag edge cases that engineering needs to handle
-
-### Step 4 — Surface Open Questions
-
-List every decision that still needs to be made before engineering can start:
-- UX decisions not yet resolved
-- Technical approach questions
-- Business rule ambiguities
-- Dependencies on other teams
-
-## Output Format
-
-Follow the PRD template exactly. See `templates/prd-template.md`.
-
-## Quality Checklist
-
-Before finishing, verify:
-- [ ] Problem statement is user-centric (not solution-centric)
-- [ ] Success metrics are measurable (not vague like "improved UX")
-- [ ] Must Have list is genuinely minimum viable (not a wish list)
-- [ ] Every open question has an owner assigned
-- [ ] No technical implementation details in requirements (that's for engineers)

package/skills/pkit:make-prd/templates/prd-template.md

@@ -1,108 +0,0 @@
-# PRD: [Feature Name]
-
-**Status:** Draft
-**Author:** [Name]
-**Date:** [YYYY-MM-DD]
-**Version:** 1.0
-
----
-
-## Problem
-
-> What problem are we solving, for whom, and why does it matter now?
-
-[2–3 sentences. Lead with the user pain, not the solution.]
-
----
-
-## Goals & Success Metrics
-
-| Goal | Metric | Target | Measurement Method |
-|------|--------|--------|--------------------|
-| [e.g. Reduce time-to-value] | [e.g. Time to first action] | [e.g. < 2 min] | [e.g. Analytics event] |
-
----
-
-## Background & Context
-
-> Why are we building this now? What research, data, or feedback drove this?
-
-- [Key insight / data point]
-- [Customer request / interview finding]
-- [Strategic alignment]
-
----
-
-## User Stories
-
-### Story 1 — [Primary Scenario]
-
-**As a** [role],
-**I want to** [action],
-**So that** [benefit].
-
-**Acceptance Criteria:**
-- Given [context], when [action], then [expected outcome]
-- Given [edge case], when [action], then [safe fallback]
-
-### Story 2 — [Secondary Scenario]
-
-[same format]
-
----
-
-## Requirements
-
-### Must Have (MVP)
-- [ ] [Requirement — specific and testable]
-- [ ] [Requirement]
-
-### Should Have (v1.1)
-- [ ] [Requirement]
-
-### Won't Have (this version)
-- [Explicitly out of scope item] — *Reason: [why deferred]*
-
----
-
-## Out of Scope
-
-> Be explicit. What are we NOT building and why?
-
-- [Item] — deferred because [reason]
-- [Item] — handled by [other team/system]
-
----
-
-## Design & UX Notes
-
-> Link to mockups, Figma, or describe key UX decisions.
-
-- [Link to designs or description]
-- [Key UX decision and rationale]
-
----
-
-## Technical Considerations
-
-> High-level notes for engineering — not a technical spec.
-
-- [Known constraint or dependency]
-- [Performance or scale consideration]
-- [Integration point]
-
----
-
-## Open Questions
-
-| Question | Impact | Owner | Due Date | Status |
-|----------|--------|-------|----------|--------|
-| [Question] | High/Med/Low | [Name] | [Date] | Open |
-
----
-
-## Appendix
-
-> Supporting data, research links, related tickets.
-
-- [Link or reference]