skilldex-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pandemonium Research
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,318 @@
+# Skilldex
+
+**npm, but for Claude skills.**
+
+Skilldex is a package manager and registry for Claude `.skill` packages. It handles installation at the right scope, format validation with compiler-style feedback, quality scoring, and AI-powered skill suggestions — all while integrating natively with Claude Code via MCP.
+
+```bash
+skillpm install forensics-agent --scope project
+skillpm validate ./my-skill
+skillpm list
+```
+
+> **Note:** Skilldex is strictly a distribution and tooling layer. It does not define the skill format — that is Anthropic's responsibility. Skilldex follows and validates against Anthropic's published skill specification.
+
+---
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [CLI Reference](#cli-reference)
+- [Skill Package Format](#skill-package-format)
+- [Scope System](#scope-system)
+- [Format Validation & Scoring](#format-validation--scoring)
+- [Agent Suggestion Loop](#agent-suggestion-loop)
+- [Claude Code Integration (MCP)](#claude-code-integration-mcp)
+- [Documentation](#documentation)
+- [Contributing](#contributing)
+
+---
+
+## Installation
+
+**Requirements:** Node.js 20+
+
+```bash
+# From source (current)
+git clone https://github.com/Pandemonium-Research/Skilldex.git
+cd Skilldex
+npm install
+npm run build
+npm link           # makes skillpm / spm available globally
+
+# Future: npm install -g skilldex
+```
+
+Both `skillpm` and `spm` are identical — `spm` is a convenience alias:
+
+```bash
+skillpm install forensics-agent   # canonical
+spm install forensics-agent       # identical alias
+```
+
+---
+
+## Quick Start
+
+### Validate a skill
+
+```bash
+skillpm validate ./my-skill
+```
+
+```
+  pass    YAML frontmatter valid
+  pass    name field present
+  pass    description meets length requirement (34 words)
+  pass    SKILL.md line count OK (42 lines)
+  error   line 12: references assets/template.docx but assets/template.docx not found
+  pass    Bundled resources in correct subdirectories
+
+Format conformance score: 85/100
+Validated against: skill-format v1.0
+```
+
+### Install a skill
+
+```bash
+# From a local path
+skillpm install ./forensics-agent --scope project
+
+# From a GitHub repo
+skillpm install git+https://github.com/user/forensics-agent --scope project
+
+# From a subdirectory of a repo
+skillpm install git+https://github.com/user/skills-collection/tree/main/forensics-agent
+```
+
+### List installed skills
+
+```bash
+skillpm list
+
+# global scope
+#   (no skills installed)
+#
+# shared scope
+#   (no skills installed)
+#
+# project scope
+#   forensics-agent                score: 91/100  source: community
+```
+
+### Uninstall a skill
+
+```bash
+skillpm uninstall forensics-agent --scope project
+```
+
+### AI-powered skill suggestions
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+skillpm suggest
+```
+
+Skilldex reads your project context (README, package.json, `.claude/` directory) and proposes relevant skills. You approve, reject, or change the scope of each before installation.
+
+---
+
+## CLI Reference
+
+Full reference: [docs/cli.md](docs/cli.md)
+
+| Command | Description |
+|---|---|
+| `skillpm install <source>` | Install from local path or `git+https://` URL |
+| `skillpm uninstall <name>` | Remove a skill from a scope |
+| `skillpm list` | Show all installed skills across scopes |
+| `skillpm validate [path]` | Validate format + show score |
+| `skillpm suggest` | AI-powered suggestion loop |
+| `skillpm publish` | Publish to registry *(coming soon)* |
+
+**Global options:**
+
+| Flag | Description |
+|---|---|
+| `--json` | Machine-readable JSON output |
+| `--no-color` | Disable colored output |
+| `-v, --version` | Print version |
+| `-h, --help` | Show help |
+
+---
+
+## Skill Package Format
+
+Full reference: [docs/skill-format.md](docs/skill-format.md)
+
+A Skilldex package is a folder containing a `SKILL.md` file and optional bundled resources:
+
+```
+my-skill/
+├── SKILL.md          ← required
+├── scripts/          ← executable code (optional)
+├── references/       ← docs loaded into context (optional)
+└── assets/           ← templates, icons, fonts (optional)
+```
+
+**`SKILL.md` structure:**
+
+```markdown
+---
+name: my-skill
+description: A detailed description of what this skill does, when to use it,
+  and what capabilities it provides to the agent. Should be 30+ words.
+version: 1.0.0
+tags: [debugging, analysis]
+author: your-name
+---
+
+## Instructions
+
+Your skill instructions here...
+```
+
+The `name` and `description` fields are required. Everything else is optional.
+
+---
+
+## Scope System
+
+Full reference: [docs/scoping.md](docs/scoping.md)
+
+Skills are installed at one of three levels. **Local-first precedence** — a lower scope always overrides a higher one for the same skill name.
+
+```
+global   → ~/.skilldex/global/     available to all projects
+shared   → ~/.skilldex/shared/     custom skills across multiple projects
+project  → <project>/.skilldex/    skills specific to one project
+```
+
+```bash
+skillpm install my-skill --scope global    # available everywhere
+skillpm install my-skill --scope shared    # available in all projects
+skillpm install my-skill --scope project   # default, this project only
+```
+
+Each scope maintains a `skilldex.json` manifest tracking installed skills, their source, and the spec version they were validated against.
+
+---
+
+## Format Validation & Scoring
+
+Full reference: [docs/validation.md](docs/validation.md)
+
+The quality score measures **format conformance only** — not functionality or usefulness.
+
+> *"The Skilldex quality score reflects conformance to Anthropic's skill format specification. It does not reflect the skill's functionality or usefulness."*
+
+**Scoring breakdown (100 pts total):**
+
+| Check | Points |
+|---|---|
+| YAML frontmatter present and parseable | 25 |
+| `name` field present and non-empty | 10 |
+| `description` field present | 10 |
+| `description` meets 30-word minimum | 10 |
+| `SKILL.md` under 500 lines | 15 |
+| Only allowed subdirectories | 10 |
+| All referenced resources exist | 15 |
+| Bundled resources in correct subdirectories | 5 |
+
+Missing frontmatter is **fatal** — the skill scores 0 and no further checks run. All other failures produce diagnostics but never block installation.
+
+---
+
+## Agent Suggestion Loop
+
+Full reference: [docs/suggest.md](docs/suggest.md)
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+skillpm suggest
+```
+
+Before starting a build, Skilldex can propose skills based on your project:
+
+1. Reads project context (README, package.json, `.claude/` directory)
+2. Calls Claude to propose relevant skills with reasons
+3. You approve, reject, or reassign the scope of each
+4. Approved skills are installed
+
+This checkpoint is intentional. Most agent frameworks skip it and auto-execute. Skilldex makes it explicit.
+
+---
+
+## Claude Code Integration (MCP)
+
+Full reference: [docs/mcp.md](docs/mcp.md)
+
+Skilldex exposes a Model Context Protocol (MCP) server so Claude Code can invoke all operations directly.
+
+**Add to your Claude Code MCP config** (`.mcp.json` in project root or `~/.claude/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "skilldex": {
+      "command": "node",
+      "args": ["/absolute/path/to/Skilldex/dist/mcp/server.js"],
+      "env": {
+        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+Once configured, Claude Code can:
+- Call `skilldex_install` to install a skill mid-session
+- Call `skilldex_list` to see what's available
+- Call `skilldex_validate` to check a skill's format score
+- Call `skilldex_suggest` to get AI proposals for the current project
+
+**Available MCP tools:**
+
+| Tool | Description |
+|---|---|
+| `skilldex_install` | Install a skill from path or git URL |
+| `skilldex_uninstall` | Remove a skill |
+| `skilldex_list` | List installed skills |
+| `skilldex_validate` | Validate and score a skill |
+| `skilldex_suggest` | Generate skill suggestions |
+| `skilldex_search` | Search registry *(stub — coming soon)* |
+
+---
+
+## Documentation
+
+| File | Contents |
+|---|---|
+| [docs/cli.md](docs/cli.md) | Full CLI command reference with all flags and examples |
+| [docs/skill-format.md](docs/skill-format.md) | Skill package format, SKILL.md structure, frontmatter fields |
+| [docs/scoping.md](docs/scoping.md) | Scope hierarchy, resolution rules, manifest format |
+| [docs/validation.md](docs/validation.md) | Scoring system, each check explained, output format |
+| [docs/suggest.md](docs/suggest.md) | Agent suggestion loop, context gathering, interactive flow |
+| [docs/mcp.md](docs/mcp.md) | MCP server setup, tool schemas, Claude Code config |
+| [docs/contributing.md](docs/contributing.md) | Dev setup, architecture, testing guide |
+
+---
+
+## Contributing
+
+See [docs/contributing.md](docs/contributing.md).
+
+```bash
+git clone https://github.com/Pandemonium-Research/Skilldex.git
+cd Skilldex
+npm install
+npm run build
+npm test
+```
+
+---
+
+## License
+
+MIT

package/dist/cli/commands/install-action.d.ts

@@ -0,0 +1,7 @@
+import type { ScopeLevel } from '../../types/scope.js';
+export declare function runInstall(source: string, options: {
+    scope: ScopeLevel;
+    force: boolean;
+    json: boolean;
+}): Promise<void>;
+//# sourceMappingURL=install-action.d.ts.map

package/dist/cli/commands/install-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-action.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install-action.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAItD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC5D,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/cli/commands/install-action.js

@@ -0,0 +1,85 @@
+import ora from 'ora';
+import { installFromPath } from '../../core/installer.js';
+import { printValidationReport, printJson, printError, printSuccess } from '../ui/output.js';
+export async function runInstall(source, options) {
+    const isGitUrl = source.startsWith('git+');
+    if (isGitUrl) {
+        await runGitInstall(source, options);
+        return;
+    }
+    const spinner = options.json ? null : ora(`Validating ${source}...`).start();
+    try {
+        if (spinner)
+            spinner.text = `Validating ${source}...`;
+        const result = await installFromPath(source, {
+            scope: options.scope,
+            force: options.force,
+        });
+        if (spinner)
+            spinner.succeed(`Installed "${result.skillName}" at ${result.scope} scope`);
+        if (options.json) {
+            printJson({
+                installed: true,
+                skillName: result.skillName,
+                scope: result.scope,
+                score: result.validation.score,
+                diagnostics: result.validation.diagnostics,
+            });
+        }
+        else {
+            if (result.validation.warnCount > 0 || result.validation.errorCount > 0) {
+                console.log('');
+                printValidationReport(result.validation);
+            }
+            else {
+                printSuccess(`Score: ${result.validation.score}/100`);
+            }
+        }
+    }
+    catch (e) {
+        if (spinner)
+            spinner.fail();
+        printError(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+}
+async function runGitInstall(gitUrl, options) {
+    const spinner = options.json ? null : ora(`Cloning ${gitUrl}...`).start();
+    try {
+        const { installFromGitUrl } = await import('../../registry/sources/github.js');
+        const { resolveScope } = await import('../../core/resolver.js');
+        const scopeConfig = await resolveScope(options.scope);
+        const result = await installFromGitUrl(gitUrl, scopeConfig, {
+            scope: options.scope,
+            force: options.force,
+            sourceUrl: gitUrl,
+        });
+        if (spinner)
+            spinner.succeed(`Installed "${result.skillName}" at ${result.scope} scope`);
+        if (options.json) {
+            printJson({
+                installed: true,
+                skillName: result.skillName,
+                scope: result.scope,
+                score: result.validation.score,
+                diagnostics: result.validation.diagnostics,
+            });
+        }
+        else {
+            if (result.validation.warnCount > 0 || result.validation.errorCount > 0) {
+                console.log('');
+                printValidationReport(result.validation);
+            }
+            else {
+                printSuccess(`Score: ${result.validation.score}/100`);
+            }
+        }
+    }
+    catch (e) {
+        if (spinner)
+            spinner.fail();
+        printError(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=install-action.js.map

package/dist/cli/commands/install-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-action.js","sourceRoot":"","sources":["../../../src/cli/commands/install-action.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerInstall(program: Command): void;
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAWtD"}

package/dist/cli/commands/install.js

@@ -0,0 +1,13 @@
+export function registerInstall(program) {
+    program
+        .command('install <source>')
+        .description('Install a skill from a local path, git URL, or registry')
+        .option('-s, --scope <scope>', 'Installation scope: global, shared, or project', 'project')
+        .option('-f, --force', 'Overwrite if already installed', false)
+        .option('--json', 'Output as JSON')
+        .action(async (source, options) => {
+        const { runInstall } = await import('./install-action.js');
+        await runInstall(source, options);
+    });
+}
+//# sourceMappingURL=install.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO;SACJ,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,yDAAyD,CAAC;SACtE,MAAM,CAAC,qBAAqB,EAAE,gDAAgD,EAAE,SAAS,CAAC;SAC1F,MAAM,CAAC,aAAa,EAAE,gCAAgC,EAAE,KAAK,CAAC;SAC9D,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,OAA6D,EAAE,EAAE;QAC9F,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAA;QAC1D,MAAM,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/cli/commands/list-action.d.ts

@@ -0,0 +1,6 @@
+import type { ScopeLevel } from '../../types/scope.js';
+export declare function runList(options: {
+    scope?: ScopeLevel;
+    json: boolean;
+}): Promise<void>;
+//# sourceMappingURL=list-action.d.ts.map

package/dist/cli/commands/list-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-action.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list-action.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAMtD,wBAAsB,OAAO,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C3F"}

package/dist/cli/commands/list-action.js

@@ -0,0 +1,46 @@
+import chalk from 'chalk';
+import { resolveAllScopes, resolveScope } from '../../core/resolver.js';
+import { readManifest } from '../../core/manifest.js';
+import { printJson, printError } from '../ui/output.js';
+export async function runList(options) {
+    try {
+        const scopeConfigs = options.scope
+            ? [await resolveScope(options.scope)]
+            : await resolveAllScopes();
+        const results = [];
+        for (const sc of scopeConfigs) {
+            const manifest = await readManifest(sc);
+            results.push({ level: sc.level, manifest });
+        }
+        if (options.json) {
+            printJson(results.map((r) => ({
+                level: r.level,
+                skills: Object.values(r.manifest.skills),
+            })));
+            return;
+        }
+        let totalSkills = 0;
+        for (const { level, manifest } of results) {
+            const skills = Object.values(manifest.skills);
+            totalSkills += skills.length;
+            console.log(chalk.bold(`\n${level} scope`));
+            if (skills.length === 0) {
+                console.log(chalk.dim('  (no skills installed)'));
+            }
+            else {
+                for (const skill of skills) {
+                    const score = skill.score >= 80 ? chalk.green(`${skill.score}`) :
+                        skill.score >= 50 ? chalk.yellow(`${skill.score}`) : chalk.red(`${skill.score}`);
+                    console.log(`  ${chalk.cyan(skill.name.padEnd(30))} score: ${score}/100  source: ${chalk.dim(skill.source)}`);
+                }
+            }
+        }
+        console.log('');
+        console.log(chalk.dim(`${totalSkills} skill(s) installed across ${results.length} scope(s)`));
+    }
+    catch (e) {
+        printError(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=list-action.js.map

package/dist/cli/commands/list-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-action.js","sourceRoot":"","sources":["../../../src/cli/commands/list-action.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerList(program: Command): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUnD"}

package/dist/cli/commands/list.js

@@ -0,0 +1,12 @@
+export function registerList(program) {
+    program
+        .command('list')
+        .description('List installed skills')
+        .option('-s, --scope <scope>', 'Filter by scope: global, shared, or project')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        const { runList } = await import('./list-action.js');
+        await runList(options);
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,uBAAuB,CAAC;SACpC,MAAM,CAAC,qBAAqB,EAAE,6CAA6C,CAAC;SAC5E,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,OAA8C,EAAE,EAAE;QAC/D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;QACpD,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/cli/commands/publish.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerPublish(program: Command): void;
+//# sourceMappingURL=publish.d.ts.map

package/dist/cli/commands/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/publish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQtD"}

package/dist/cli/commands/publish.js

@@ -0,0 +1,10 @@
+export function registerPublish(program) {
+    program
+        .command('publish')
+        .description('Publish a skill to the Skilldex registry (coming soon)')
+        .action(() => {
+        console.error('publish is not yet implemented.');
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=publish.js.map

package/dist/cli/commands/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/cli/commands/publish.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/cli/commands/suggest-action.d.ts

@@ -0,0 +1,6 @@
+export declare function runSuggest(options: {
+    projectPath?: string;
+    yes: boolean;
+    json: boolean;
+}): Promise<void>;
+//# sourceMappingURL=suggest-action.d.ts.map

package/dist/cli/commands/suggest-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-action.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/suggest-action.ts"],"names":[],"mappings":"AAMA,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;CACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDhB"}

package/dist/cli/commands/suggest-action.js

@@ -0,0 +1,51 @@
+import ora from 'ora';
+import chalk from 'chalk';
+import { gatherProjectContext, generateProposals } from '../../core/suggest-agent.js';
+import { findProjectRoot } from '../../core/resolver.js';
+import { printJson, printError } from '../ui/output.js';
+export async function runSuggest(options) {
+    try {
+        const projectRoot = await findProjectRoot(options.projectPath ?? process.cwd());
+        const spinner = options.json ? null : ora('Gathering project context...').start();
+        const context = await gatherProjectContext(projectRoot);
+        if (spinner)
+            spinner.text = 'Generating skill proposals...';
+        const proposals = await generateProposals(context);
+        if (spinner)
+            spinner.stop();
+        if (options.json) {
+            printJson({ proposals });
+            return;
+        }
+        if (proposals.length === 0) {
+            console.log(chalk.dim('No skill suggestions for this project.'));
+            return;
+        }
+        let approved = proposals.map((p) => ({ proposal: p, scope: p.suggestedScope }));
+        if (!options.yes) {
+            const { promptSuggestions } = await import('../ui/prompts.js');
+            approved = await promptSuggestions(proposals);
+        }
+        if (approved.length === 0) {
+            console.log(chalk.dim('No skills approved for installation.'));
+            return;
+        }
+        console.log(`\nInstalling ${approved.length} skill(s)...`);
+        const { installFromPath } = await import('../../core/installer.js');
+        const installed = [];
+        for (const { proposal, scope } of approved) {
+            // Skills from suggest come from the registry — for now we can't actually install
+            // them because they may not exist locally. Mark as pending/future feature.
+            console.log(chalk.dim(`  ⚠ "${proposal.skillName}" — registry install not yet available. ` +
+                `Use: skillpm install git+<url> --scope ${scope}`));
+        }
+        if (options.json) {
+            printJson({ proposals, installed });
+        }
+    }
+    catch (e) {
+        printError(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=suggest-action.js.map

package/dist/cli/commands/suggest-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-action.js","sourceRoot":"","sources":["../../../src/cli/commands/suggest-action.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/suggest.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerSuggest(program: Command): void;
+//# sourceMappingURL=suggest.d.ts.map

package/dist/cli/commands/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/suggest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAWtD"}