skillops-cli 1.3.1 → 1.3.2

package/README.md

@@ -1,6 +1,6 @@
 # SkillOps (`npx skillops-cli@latest`)
 
-> **The Zero-API Framework & Benchmark-Verified Library for High-End AI Coding Skills & Context-Isolated Subagents (`v1.3.1`)**  
+> **The Zero-API Framework & Benchmark-Verified Library for High-End AI Coding Skills & Context-Isolated Subagents (`v1.3.2`)**  
 > *Explore, search, inspect, and install benchmark-verified AI Coding Skills and Context-Isolated Subagents in 10 seconds (`npx skillops-cli@latest quickstart`), scaffold and certify your own custom Skills & Subagents (`npx skillops-cli@latest create skill <name>`), enforce Startup Token Tax budgets (`npx skillops-cli@latest budget`), and transpile natively across the Top 20 AI coding agents & IDEs — 100% offline with zero API keys.*
 
 [![CI Governance](https://img.shields.io/badge/governance-1%20Issue%20%3D%201%20PR-blue.svg)](./AGENTS.md)
@@ -47,24 +47,27 @@ npx skillops-cli@latest eval --strict
 
 As engineering teams adopt the **Top 20 AI Coding Agents, IDEs, and CLI Harnesses** (**Claude Code**, **Antigravity / Gemini CLI**, **Cursor**, **OpenAI Codex CLI**, **GitHub Copilot**, **Windsurf**, **Cline**, **Roo Code**, **Kilo Code**, **Zed AI**, **Continue.dev**, **Aider**, **OpenHands**, **Sourcegraph Amp**, **OpenCode**, **Block Goose**, **AWS Kiro**, **Trae IDE**, **JetBrains Junie**, and **Amazon Q Developer**), two systemic failure modes documented in 2026 empirical AI research break production workflows:
 
-1. **Implicit Routing Collapse (*Lost in Implicit Routing*, `arXiv:2610.18522`):**  
+1. **Implicit Routing Collapse (_Lost in Implicit Routing_, `arXiv:2610.18522`):**  
    Dumping 50–100+ skills with overlapping natural-language descriptions into an agent's workspace causes **semantic routing recall to collapse from `73.6%` to `27.4%`**, while burning **8,000–15,000+ context tokens** before the developer writes a single prompt.
-2. **Skill-Induced Regressions & Startup Token Tax (*Agent Skills Can Be Harmful*, `arXiv:2608.11888`):**  
+2. **Skill-Induced Regressions & Startup Token Tax (_Agent Skills Can Be Harmful_, `arXiv:2608.11888`):**  
    Static, prose-heavy `SKILL.md` files without deterministic verification scripts or comparative `with_skill` vs. `without_skill` benchmarks frequently **degrade pass rates** on complex engineering tasks while inflating token overhead by **30%–200%**.
 
 **SkillOps** solves both problems by uniting **three pillars** in a single 100% offline, zero-API Node.js 20+ / TypeScript engine:
 
 ### 📚 Pillar 1 — The Benchmark-Verified Library of Skills & Subagents
+
 - **10 Hybrid Executable Skills (`catalog/<track>/<name>/`):** Every skill pairs a concise `<= 250`-line `SKILL.md` (`40–110` word L1 trigger description) with a zero-hallucination **Python 3.12+ Level 3 CLI tool (`scripts/*.py --json`)** and a **deterministic TDD evaluation suite (`evals/evals.json` + `evals/benchmark.json`)** proving `CERTIFIED_IMPROVEMENT` ($\Delta\text{PassRate} \ge +15\%$).
 - **9 Context-Isolated Subagents (`catalog/subagents/` & `.github/agents/`):** Specialized read-only scouts and auditors that execute heavy AST/codebase exploration in an isolated context window and return a strict `<= 400`-token structured digest (`INV-SKILL-04`) to the parent agent.
 - **Interactive Library Explorer:** Discover, filter, inspect, and install artifacts via `skillops list`, `skillops search <query>`, `skillops info <name>`, `skillops recommend`, and `skillops install <name>`.
 
 ### 🛠️ Pillar 2 — The Framework for Building Custom Skills & Subagents
+
 - **1-Command Scaffolder (`skillops create skill|subagent <name>`):** Generates contract-compliant `SKILL.md` manifests (automatically meeting `INV-SKILL-01..04` word and token budgets), executable Python 3.12+ `--json` Level 3 AST/CLI scripts, and `with_skill` vs. `without_skill` TDD evaluation suites (`evals/evals.json`), or context-isolated `SUBAGENT.md` manifests (`max_output_tokens: 400`).
 - **Zero-API Semantic Collision & Budget Linter (`skillops audit`):** Computes TF-IDF + char-trigram cosine similarity and MinHash Jaccard across your catalog to catch routing collisions (`>= 0.72` warning, `>= 0.85` error) and enforce 3-level progressive disclosure budgets before deployment.
 - **Deterministic TDD Evaluation Runner (`skillops eval`):** Executes comparative `with_skill` vs. `without_skill` evaluations offline and generates `table`, `markdown`, `json`, or interactive `html` benchmark dashboards.
 
 ### ⚙️ Pillar 3 — Universal Multi-Runtime Sync, Token Economy & MCP Engine
+
 - **Universal Top-20 AI Harness Transpiler (`skillops quickstart`, `sync`, `install`, `uninstall`, `clean`):** Transpiles Skills and Subagents into the native progressive-disclosure or scoped rule formats of all 20 AI coding agents with `.skillops-lock.json` SHA-256 drift protection.
 - **Startup Token Tax Analyzer (`skillops budget` / `tokens`):** Audits 22 always-on instruction files (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.windsurfrules`, `.clinerules`, `.goosehints`, `CONVENTIONS.md`, etc.) and 13 MCP config formats against a strict `<= 2,500`-token startup budget.
 - **Local JSON-RPC 2.0 Stdio MCP Server (`skillops mcp-setup` & `mcp`):** Exposes 8 native tools (`audit_catalog`, `analyze_repo_tokens`, `route_repo_skills`, `run_skill_script`, `get_skill_benchmark`, `list_catalog_items`, `diagnose_repo`, `list_supported_harnesses`) across 13 MCP-capable IDEs and CLI agents.
@@ -106,63 +109,63 @@ flowchart LR
 
 ### 📚 1. Library Commands (Explore, Search, Recommend & Install)
 
-| Command | Aliases | Purpose & Key Flags |
-| :--- | :--- | :--- |
-| **`npx skillops-cli quickstart`** | `setup` | **1-Command Onboarding:** Auto-detects repo stack & active AI harnesses, routes optimal collision-free Skills + Subagents, transpiles runtime files, registers MCP, and prints how to invoke them (`--project <dir>`, `--harness <list\|auto\|all>`, `--dry-run`). |
-| **`npx skillops-cli list`** | `ls` | Lists all catalog Skills and Context-Isolated Subagents with a visual L1 Token Budget Meter (`--type skill\|subagent`, `--format table\|json`). |
-| **`npx skillops-cli search <query>`** | `find` | Searches the Library by keyword, domain tag, track, or trigger phrase (`--type skill\|subagent`, `--format table\|json\|markdown`). |
-| **`npx skillops-cli info <name>`** | `show`, `inspect` | Renders a detailed TUI inspection card for a Skill or Subagent: L1/L2 token metrics, Level 3 scripts, TDD benchmark lift, and **how to invoke it in your AI IDE**. |
-| **`npx skillops-cli install <name...>`** | `add`, `i` | Installs one or more Skills or Subagents into your active AI coding harnesses (`--harness claude,cursor,windsurf`, `--dry-run`, `--force`). |
-| **`npx skillops-cli uninstall <name...>`** | `remove`, `rm` | Surgically removes synced Skills or Subagents from active AI harnesses while respecting `.skillops-lock.json` SHA-256 drift protection. |
-| **`npx skillops-cli recommend`** | `route` | Fingerprints your repository (`package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `Dockerfile`, AST) and recommends an optimal `<= 12` Skill bundle (`--task "<prompt>"`, `--top <n>`). |
+| Command                                    | Aliases           | Purpose & Key Flags                                                                                                                                                                                                                                                |
+| :----------------------------------------- | :---------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`npx skillops-cli quickstart`**          | `setup`           | **1-Command Onboarding:** Auto-detects repo stack & active AI harnesses, routes optimal collision-free Skills + Subagents, transpiles runtime files, registers MCP, and prints how to invoke them (`--project <dir>`, `--harness <list\|auto\|all>`, `--dry-run`). |
+| **`npx skillops-cli list`**                | `ls`              | Lists all catalog Skills and Context-Isolated Subagents with a visual L1 Token Budget Meter (`--type skill\|subagent`, `--format table\|json`).                                                                                                                    |
+| **`npx skillops-cli search <query>`**      | `find`            | Searches the Library by keyword, domain tag, track, or trigger phrase (`--type skill\|subagent`, `--format table\|json\|markdown`).                                                                                                                                |
+| **`npx skillops-cli info <name>`**         | `show`, `inspect` | Renders a detailed TUI inspection card for a Skill or Subagent: L1/L2 token metrics, Level 3 scripts, TDD benchmark lift, and **how to invoke it in your AI IDE**.                                                                                                 |
+| **`npx skillops-cli install <name...>`**   | `add`, `i`        | Installs one or more Skills or Subagents into your active AI coding harnesses (`--harness claude,cursor,windsurf`, `--dry-run`, `--force`).                                                                                                                        |
+| **`npx skillops-cli uninstall <name...>`** | `remove`, `rm`    | Surgically removes synced Skills or Subagents from active AI harnesses while respecting `.skillops-lock.json` SHA-256 drift protection.                                                                                                                            |
+| **`npx skillops-cli recommend`**           | `route`           | Fingerprints your repository (`package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `Dockerfile`, AST) and recommends an optimal `<= 12` Skill bundle (`--task "<prompt>"`, `--top <n>`).                                                                      |
 
 ### 🛠️ 2. Framework Commands (Scaffold, Audit & Certify Custom Skills/Subagents)
 
-| Command | Aliases | Purpose & Key Flags |
-| :--- | :--- | :--- |
-| **`npx skillops-cli create <type> <name>`** | `new` | Scaffolds a contract-compliant custom **Skill** (`create skill <name> --track <track>`) with `SKILL.md`, `scripts/<name>_check.py --json`, and `evals/evals.json`, or a **Context-Isolated Subagent** (`create subagent <name>`). |
-| **`npx skillops-cli audit`** | — | Audits any catalog for pairwise TF-IDF/MinHash semantic routing collisions (`< 0.72` / `< 0.85`), 3-level progressive disclosure token budgets, and subagent `max_output_tokens <= 400` (`--strict`, `--require-layout`, `--format table\|json\|markdown\|github`). |
-| **`npx skillops-cli eval`** | — | Runs 100% offline deterministic `with_skill` vs. `without_skill` AST & subprocess TDD evaluations and enforces $\Delta\text{PassRate} \ge +15\%$ (`--skill <name>`, `--output <path>`, `--format table\|json\|markdown\|html\|github`). |
-| **`npx skillops-cli init`** | — | Initializes a declarative `.skillops.yml` workspace configuration and empty `catalog/` tracks (`ai-engineering`, `python-backend`, `arch-quality`, `subagents`). |
+| Command                                     | Aliases | Purpose & Key Flags                                                                                                                                                                                                                                                 |
+| :------------------------------------------ | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **`npx skillops-cli create <type> <name>`** | `new`   | Scaffolds a contract-compliant custom **Skill** (`create skill <name> --track <track>`) with `SKILL.md`, `scripts/<name>_check.py --json`, and `evals/evals.json`, or a **Context-Isolated Subagent** (`create subagent <name>`).                                   |
+| **`npx skillops-cli audit`**                | —       | Audits any catalog for pairwise TF-IDF/MinHash semantic routing collisions (`< 0.72` / `< 0.85`), 3-level progressive disclosure token budgets, and subagent `max_output_tokens <= 400` (`--strict`, `--require-layout`, `--format table\|json\|markdown\|github`). |
+| **`npx skillops-cli eval`**                 | —       | Runs 100% offline deterministic `with_skill` vs. `without_skill` AST & subprocess TDD evaluations and enforces $\Delta\text{PassRate} \ge +15\%$ (`--skill <name>`, `--output <path>`, `--format table\|json\|markdown\|html\|github`).                             |
+| **`npx skillops-cli init`**                 | —       | Initializes a declarative `.skillops.yml` workspace configuration and empty `catalog/` tracks (`ai-engineering`, `python-backend`, `arch-quality`, `subagents`).                                                                                                    |
 
 ### ⚙️ 3. Universal Runtime Sync, Token Economy & Diagnostics
 
-| Command | Aliases | Purpose & Key Flags |
-| :--- | :--- | :--- |
-| **`npx skillops-cli budget`** | `tokens` | Audits repository Startup Token Tax across 22 always-on instruction files (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.windsurfrules`, `.clinerules`, etc.) and 13 MCP server configs with a visual budget meter (`--budget 2500`, `--strict`). |
-| **`npx skillops-cli sync`** | — | Fingerprints the repository and transpiles the full routed Skill + Subagent bundle across selected harnesses (`--harness auto\|all\|core\|<list>`, `--task "<prompt>"`, `--dry-run`, `--force`). |
-| **`npx skillops-cli clean`** | — | Removes all SkillOps-managed runtime artifacts tracked in `.skillops-lock.json` across all 20 harnesses and cleans managed index blocks. |
-| **`npx skillops-cli doctor`** | `status` | Diagnoses Node.js/Python runtimes, `.skillops.yml` schema validity, `.skillops-lock.json` SHA-256 artifact drift (`healthy`, `drifted`, `missing`), Startup Token Tax, and detected AI harnesses. |
-| **`npx skillops-cli harnesses`** | — | Lists all 20 supported AI coding agents with auto-detection status, target directories, and MCP support (`--format table\|json\|markdown`). |
-| **`npx skillops-cli mcp-setup`** | — | Idempotently registers the `skillops` stdio MCP server across all 13 MCP-capable IDEs and CLI agents (`--harness auto\|all\|<list>`, `--dry-run`). |
-| **`npx skillops-cli mcp`** | — | Starts the local JSON-RPC 2.0 `stdio` Model Context Protocol server exposing 8 SkillOps tools. |
+| Command                          | Aliases  | Purpose & Key Flags                                                                                                                                                                                                                          |
+| :------------------------------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`npx skillops-cli budget`**    | `tokens` | Audits repository Startup Token Tax across 22 always-on instruction files (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.windsurfrules`, `.clinerules`, etc.) and 13 MCP server configs with a visual budget meter (`--budget 2500`, `--strict`). |
+| **`npx skillops-cli sync`**      | —        | Fingerprints the repository and transpiles the full routed Skill + Subagent bundle across selected harnesses (`--harness auto\|all\|core\|<list>`, `--task "<prompt>"`, `--dry-run`, `--force`).                                             |
+| **`npx skillops-cli clean`**     | —        | Removes all SkillOps-managed runtime artifacts tracked in `.skillops-lock.json` across all 20 harnesses and cleans managed index blocks.                                                                                                     |
+| **`npx skillops-cli doctor`**    | `status` | Diagnoses Node.js/Python runtimes, `.skillops.yml` schema validity, `.skillops-lock.json` SHA-256 artifact drift (`healthy`, `drifted`, `missing`), Startup Token Tax, and detected AI harnesses.                                            |
+| **`npx skillops-cli harnesses`** | —        | Lists all 20 supported AI coding agents with auto-detection status, target directories, and MCP support (`--format table\|json\|markdown`).                                                                                                  |
+| **`npx skillops-cli mcp-setup`** | —        | Idempotently registers the `skillops` stdio MCP server across all 13 MCP-capable IDEs and CLI agents (`--harness auto\|all\|<list>`, `--dry-run`).                                                                                           |
+| **`npx skillops-cli mcp`**       | —        | Starts the local JSON-RPC 2.0 `stdio` Model Context Protocol server exposing 8 SkillOps tools.                                                                                                                                               |
 
 ---
 
 ## 🌐 Universal Top-20 AI Coding Agents & Harnesses Matrix
 
-| # | Target ID | AI Coding Agent / IDE | Category | Native Transpiled Skill / Rule Output | Native Subagent Output | Project MCP Config (`mcp-setup`) |
-| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
-| 1 | `claude` | **Claude Code (Anthropic)** | CLI Agent | `.claude/skills/<name>/SKILL.md` | `.claude/agents/<name>.md` | `.mcp.json` |
-| 2 | `antigravity` | **Google Antigravity / Gemini CLI** | Agentic IDE | `.agent/skills/<name>/SKILL.md` | `.agent/agents/<name>.md` | `.gemini/settings.json` |
-| 3 | `cursor` | **Cursor IDE** | AI IDE | `.cursor/rules/<name>.mdc` | `.cursor/rules/agent-<name>.mdc` | `.cursor/mcp.json` |
-| 4 | `codex` | **OpenAI Codex CLI** | CLI Agent | `.codex/skills/<name>/SKILL.md` + `AGENTS.md` | `.codex/agents/<name>.md` | `.codex/config.toml` |
-| 5 | `copilot` | **GitHub Copilot (VS Code)** | IDE Extension | `.github/instructions/<name>.instructions.md` | `.github/agents/<name>.agent.md` | `.vscode/mcp.json` |
-| 6 | `windsurf` | **Windsurf (Codeium Cascade)** | AI IDE | `.windsurf/rules/<name>.md` (`trigger: model_decision`) | `.windsurf/workflows/agent-<name>.md` | — |
-| 7 | `cline` | **Cline** | IDE Extension | `.clinerules/<name>.md` | `.clinerules/workflows/agent-<name>.md` | — |
-| 8 | `roocode` | **Roo Code** | IDE Extension | `.roo/rules/<name>.md` | `.roo/rules-architect/agent-<name>.md` | `.roo/mcp.json` |
-| 9 | `kilocode` | **Kilo Code** | IDE Extension | `.kilocode/rules/<name>.md` | `.kilocode/workflows/agent-<name>.md` | `.kilocode/mcp.json` |
-| 10 | `zed` | **Zed AI** | AI IDE | `.zed/rules/<name>.md` + `.rules` | `.zed/prompts/agent-<name>.md` | `.zed/settings.json` |
-| 11 | `continue` | **Continue.dev** | IDE Extension | `.continue/rules/<name>.md` | `.continue/prompts/agent-<name>.prompt` | `.continue/mcpServers/skillops.yaml` |
-| 12 | `aider` | **Aider CLI** | CLI Agent | `.aider/skills/<name>/SKILL.md` + `CONVENTIONS.md` | `.aider/agents/<name>.md` | — |
-| 13 | `openhands` | **OpenHands (All Hands AI)** | Autonomous Agent | `.openhands/microagents/<name>.md` | `.openhands/microagents/agent-<name>.md` | — |
-| 14 | `amp` | **Sourcegraph Amp** | CLI Agent | `.amp/skills/<name>/SKILL.md` | `.amp/agents/<name>.md` | `.amp/settings.json` |
-| 15 | `opencode` | **OpenCode CLI** | CLI Agent | `.opencode/skills/<name>/SKILL.md` | `.opencode/agent/<name>.md` | `opencode.json` |
-| 16 | `goose` | **Block Goose** | CLI Agent | `.goose/skills/<name>/SKILL.md` + `.goosehints` | `.goose/agents/<name>.md` | — |
-| 17 | `kiro` | **AWS Kiro IDE** | AI IDE | `.kiro/steering/<name>.md` (`inclusion: fileMatch`) | `.kiro/agents/<name>.md` | `.kiro/settings/mcp.json` |
-| 18 | `trae` | **Trae IDE (ByteDance)** | AI IDE | `.trae/rules/<name>.md` | `.trae/agents/<name>.md` | — |
-| 19 | `junie` | **JetBrains Junie** | IDE Extension | `.junie/skills/<name>/SKILL.md` + `.junie/guidelines.md` | `.junie/agents/<name>.md` | — |
-| 20 | `amazonq` | **Amazon Q Developer** | IDE Extension | `.amazonq/rules/<name>.md` | `.amazonq/cli-agents/<name>.md` | `.amazonq/mcp.json` |
+| #   | Target ID     | AI Coding Agent / IDE               | Category         | Native Transpiled Skill / Rule Output                    | Native Subagent Output                   | Project MCP Config (`mcp-setup`)     |
+| :-- | :------------ | :---------------------------------- | :--------------- | :------------------------------------------------------- | :--------------------------------------- | :----------------------------------- |
+| 1   | `claude`      | **Claude Code (Anthropic)**         | CLI Agent        | `.claude/skills/<name>/SKILL.md`                         | `.claude/agents/<name>.md`               | `.mcp.json`                          |
+| 2   | `antigravity` | **Google Antigravity / Gemini CLI** | Agentic IDE      | `.agent/skills/<name>/SKILL.md`                          | `.agent/agents/<name>.md`                | `.gemini/settings.json`              |
+| 3   | `cursor`      | **Cursor IDE**                      | AI IDE           | `.cursor/rules/<name>.mdc`                               | `.cursor/rules/agent-<name>.mdc`         | `.cursor/mcp.json`                   |
+| 4   | `codex`       | **OpenAI Codex CLI**                | CLI Agent        | `.codex/skills/<name>/SKILL.md` + `AGENTS.md`            | `.codex/agents/<name>.md`                | `.codex/config.toml`                 |
+| 5   | `copilot`     | **GitHub Copilot (VS Code)**        | IDE Extension    | `.github/instructions/<name>.instructions.md`            | `.github/agents/<name>.agent.md`         | `.vscode/mcp.json`                   |
+| 6   | `windsurf`    | **Windsurf (Codeium Cascade)**      | AI IDE           | `.windsurf/rules/<name>.md` (`trigger: model_decision`)  | `.windsurf/workflows/agent-<name>.md`    | —                                    |
+| 7   | `cline`       | **Cline**                           | IDE Extension    | `.clinerules/<name>.md`                                  | `.clinerules/workflows/agent-<name>.md`  | —                                    |
+| 8   | `roocode`     | **Roo Code**                        | IDE Extension    | `.roo/rules/<name>.md`                                   | `.roo/rules-architect/agent-<name>.md`   | `.roo/mcp.json`                      |
+| 9   | `kilocode`    | **Kilo Code**                       | IDE Extension    | `.kilocode/rules/<name>.md`                              | `.kilocode/workflows/agent-<name>.md`    | `.kilocode/mcp.json`                 |
+| 10  | `zed`         | **Zed AI**                          | AI IDE           | `.zed/rules/<name>.md` + `.rules`                        | `.zed/prompts/agent-<name>.md`           | `.zed/settings.json`                 |
+| 11  | `continue`    | **Continue.dev**                    | IDE Extension    | `.continue/rules/<name>.md`                              | `.continue/prompts/agent-<name>.prompt`  | `.continue/mcpServers/skillops.yaml` |
+| 12  | `aider`       | **Aider CLI**                       | CLI Agent        | `.aider/skills/<name>/SKILL.md` + `CONVENTIONS.md`       | `.aider/agents/<name>.md`                | —                                    |
+| 13  | `openhands`   | **OpenHands (All Hands AI)**        | Autonomous Agent | `.openhands/microagents/<name>.md`                       | `.openhands/microagents/agent-<name>.md` | —                                    |
+| 14  | `amp`         | **Sourcegraph Amp**                 | CLI Agent        | `.amp/skills/<name>/SKILL.md`                            | `.amp/agents/<name>.md`                  | `.amp/settings.json`                 |
+| 15  | `opencode`    | **OpenCode CLI**                    | CLI Agent        | `.opencode/skills/<name>/SKILL.md`                       | `.opencode/agent/<name>.md`              | `opencode.json`                      |
+| 16  | `goose`       | **Block Goose**                     | CLI Agent        | `.goose/skills/<name>/SKILL.md` + `.goosehints`          | `.goose/agents/<name>.md`                | —                                    |
+| 17  | `kiro`        | **AWS Kiro IDE**                    | AI IDE           | `.kiro/steering/<name>.md` (`inclusion: fileMatch`)      | `.kiro/agents/<name>.md`                 | `.kiro/settings/mcp.json`            |
+| 18  | `trae`        | **Trae IDE (ByteDance)**            | AI IDE           | `.trae/rules/<name>.md`                                  | `.trae/agents/<name>.md`                 | —                                    |
+| 19  | `junie`       | **JetBrains Junie**                 | IDE Extension    | `.junie/skills/<name>/SKILL.md` + `.junie/guidelines.md` | `.junie/agents/<name>.md`                | —                                    |
+| 20  | `amazonq`     | **Amazon Q Developer**              | IDE Extension    | `.amazonq/rules/<name>.md`                               | `.amazonq/cli-agents/<name>.md`          | `.amazonq/mcp.json`                  |
 
 ---
 

package/dist/cli.js

@@ -10,7 +10,7 @@ import YAML6 from "yaml";
 import fs from "fs";
 import YAML from "yaml";
 import { z } from "zod";
-var SKILLOPS_VERSION = "1.3.1";
+var SKILLOPS_VERSION = "1.3.2";
 var SKILL_NAME_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var SEMVER_REGEX = /^\d+\.\d+\.\d+$/;
 var FRONTMATTER_REGEX = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
@@ -5113,45 +5113,52 @@ function renderGlobalHelp(version, colorEnabled) {
   const c = colorEnabled;
   const bar = style.dim("\u2502", c);
   const banner = renderHeaderBanner(
-    "Framework & Library for AI Skills & Subagents",
+    "Skills & Agents Library for AI Coding IDEs",
     {
       version,
       colorEnabled: c
     }
   );
-  const formatCmdSection = (pillar) => {
-    const specs = COMMAND_HELP_SPECS.filter((s) => s.pillar === pillar);
-    return specs.map((s) => {
-      const aliasPart = s.aliases.length > 0 ? style.dim(` (${s.aliases.join(", ")})`, c) : "";
-      const cmdCol = padVisible(
-        `${style.bold(style.cyan(s.name, c), c)}${aliasPart}`,
-        23,
-        "left"
-      );
-      return `${bar}  ${cmdCol}${s.summary}`;
-    }).join("\n");
-  };
+  const coreCmds = [
+    {
+      cmd: "add [name...]",
+      desc: "Import Skills or Agents (interactive if no name given)"
+    },
+    {
+      cmd: "list [query]",
+      desc: "List or filter available Skills & Agents in catalog"
+    },
+    {
+      cmd: "info <name>",
+      desc: "View details and how to use a Skill or Agent"
+    },
+    {
+      cmd: "remove <name>",
+      desc: "Remove an imported Skill or Agent from your project"
+    },
+    {
+      cmd: "init",
+      desc: "Auto-detect stack & IDE and import recommended bundle"
+    }
+  ];
+  const cmdRows = coreCmds.map(
+    (item) => `${bar}  ${padVisible(style.bold(style.cyan(item.cmd, c), c), 18, "left")}${item.desc}`
+  ).join("\n");
   return [
     banner,
-    `${bar}  Usage: npx skillops-cli <command> [options]`,
-    renderSectionHeader("Quickstart (Library + Framework)", c),
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.green("npx skillops-cli quickstart", c), c)}          ${style.dim("\u2014 Detect stack, sync Skills & MCP", c)}`,
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.cyan("npx skillops-cli info <name>", c), c)}         ${style.dim("\u2014 Inspect Skill/Subagent & usage", c)}`,
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.magenta("npx skillops-cli create skill <name>", c), c)} ${style.dim("\u2014 Scaffold a custom Skill", c)}`,
-    renderSectionHeader("1. Library of High-End Skills & Subagents", c),
-    formatCmdSection("library"),
-    renderSectionHeader(
-      "2. Framework for Building Custom Skills & Subagents",
-      c
-    ),
-    formatCmdSection("framework"),
-    renderSectionHeader(
-      "3. Universal Runtime Sync, Token Economy & Diagnostics",
-      c
-    ),
-    formatCmdSection("runtime"),
+    `${bar}  Usage: skillops <command> [options]`,
+    renderSectionHeader("Commands", c),
+    cmdRows,
+    renderSectionHeader("Options", c),
+    `${bar}  ${padVisible(style.cyan("-t, --target <ide>", c), 22, "left")}AI IDE (cursor, claude, copilot, windsurf, auto)`,
+    `${bar}  ${padVisible(style.cyan("-p, --project <dir>", c), 22, "left")}Project folder (default: current directory)`,
+    `${bar}  ${padVisible(style.cyan("--all", c), 22, "left")}Import all 10 Skills & 9 Agents`,
+    renderSectionHeader("Examples", c),
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops add", c)}                                  ${style.dim("\u2014 Interactive selector", c)}`,
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops add bug-reproducer-tdd red-team-breaker", c)} ${style.dim("\u2014 Direct import", c)}`,
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops list", c)}                                 ${style.dim("\u2014 Browse catalog", c)}`,
     bar,
-    `${style.dim("\u2570\u2500", c)} ${style.bold("Global Flags:", c)} ${style.cyan("-p <dir>", c)} \xB7 ${style.cyan("-t <harnesses>", c)} \xB7 ${style.cyan("-f <table|json|md>", c)} \xB7 ${style.cyan("-h <cmd>", c)}`
+    `${style.dim("\u2570\u2500", c)} ${style.dim("Run", c)} ${style.cyan("skillops <cmd> -h", c)} ${style.dim("for command options.", c)}`
   ].join("\n");
 }
 function renderCommandHelp(spec, version, colorEnabled) {
@@ -5176,6 +5183,194 @@ function renderCommandHelp(spec, version, colorEnabled) {
   return [headerLines, optionsSection, examplesSection].filter(Boolean).join("\n");
 }
 
+// src/ui/prompt.ts
+function createMultiSelectState(options) {
+  const initial = /* @__PURE__ */ new Set();
+  for (const opt of options) {
+    if (opt.initialSelected) {
+      initial.add(opt.value);
+    }
+  }
+  return {
+    options,
+    cursor: 0,
+    selected: initial,
+    status: "active"
+  };
+}
+function applyMultiSelectKey(state, key) {
+  if (state.status !== "active" || state.options.length === 0) {
+    return state;
+  }
+  const count = state.options.length;
+  if (key === "" || key === "\x1B" || key === "q" || key === "Q") {
+    return {
+      ...state,
+      status: "cancelled"
+    };
+  }
+  if (key === "\r" || key === "\n") {
+    return {
+      ...state,
+      status: "submitted"
+    };
+  }
+  if (key === "\x1B[A" || key === "\x1BOA" || key === "k" || key === "K") {
+    const nextCursor = (state.cursor - 1 + count) % count;
+    return {
+      ...state,
+      cursor: nextCursor
+    };
+  }
+  if (key === "\x1B[B" || key === "\x1BOB" || key === "j" || key === "J") {
+    const nextCursor = (state.cursor + 1) % count;
+    return {
+      ...state,
+      cursor: nextCursor
+    };
+  }
+  if (key === " ") {
+    const currentOpt = state.options[state.cursor];
+    if (!currentOpt) {
+      return state;
+    }
+    const nextSelected = new Set(state.selected);
+    if (nextSelected.has(currentOpt.value)) {
+      nextSelected.delete(currentOpt.value);
+    } else {
+      nextSelected.add(currentOpt.value);
+    }
+    return {
+      ...state,
+      selected: nextSelected
+    };
+  }
+  if (key === "a" || key === "A") {
+    const allSelected = state.selected.size === count;
+    const nextSelected = /* @__PURE__ */ new Set();
+    if (!allSelected) {
+      for (const opt of state.options) {
+        nextSelected.add(opt.value);
+      }
+    }
+    return {
+      ...state,
+      selected: nextSelected
+    };
+  }
+  return state;
+}
+function renderMultiSelectFrame(title, state, options = {}) {
+  const c = options.colorEnabled;
+  const bar = style.dim("\u2502", c);
+  const maxVisible = options.maxVisible ?? 10;
+  const total = state.options.length;
+  const header = `${style.bold(style.cyan(`\u25C6 ${title}`, c), c)}`;
+  const instructions = `${bar}  ${style.dim("(\u2191/\u2193 move \xB7 Space select \xB7 'a' toggle all \xB7 Enter confirm)", c)}`;
+  const lines = [header];
+  if (options.subtitle) {
+    lines.push(`${bar}  ${options.subtitle}`);
+  }
+  lines.push(instructions, bar);
+  let startIdx = 0;
+  if (total > maxVisible) {
+    const half = Math.floor(maxVisible / 2);
+    startIdx = Math.max(0, Math.min(state.cursor - half, total - maxVisible));
+  }
+  const endIdx = Math.min(total, startIdx + maxVisible);
+  if (startIdx > 0) {
+    lines.push(`${bar}  ${style.dim(`\u2191 ${startIdx} more above...`, c)}`);
+  }
+  const maxLabelCols = Math.min(
+    26,
+    state.options.reduce((m, o) => Math.max(m, visibleLength(o.label)), 14)
+  );
+  for (let i = startIdx; i < endIdx; i++) {
+    const opt = state.options[i];
+    if (!opt) continue;
+    const isCurrent = i === state.cursor;
+    const isChecked = state.selected.has(opt.value);
+    const pointer = isCurrent ? style.cyan("\u276F", c) : " ";
+    const checkbox = isChecked ? style.green("\u25FC", c) : style.dim("\u25FB", c);
+    const kindTag = opt.kind === "skill" ? style.cyan("skill ", c) : opt.kind === "agent" ? style.magenta("agent ", c) : "";
+    const labelRaw = opt.label.length > maxLabelCols ? `${opt.label.slice(0, maxLabelCols - 1)}\u2026` : opt.label;
+    const labelPadded = padVisible(labelRaw, maxLabelCols + 1, "left");
+    const styledLabel = isCurrent ? style.bold(labelPadded, c) : isChecked ? style.green(labelPadded, c) : labelPadded;
+    const prefixWidth = 6 + (opt.kind === "skill" || opt.kind === "agent" ? 6 : 0) + maxLabelCols + 1;
+    const maxHintCols = Math.max(10, 75 - prefixWidth);
+    const rawHint = opt.hint ?? "";
+    const shortHint = rawHint.length > maxHintCols ? `${rawHint.slice(0, maxHintCols - 1)}\u2026` : rawHint;
+    const hintPart = shortHint ? ` ${style.dim(shortHint, c)}` : "";
+    lines.push(
+      `${bar}  ${pointer} ${checkbox} ${kindTag}${styledLabel}${hintPart}`
+    );
+  }
+  if (endIdx < total) {
+    lines.push(`${bar}  ${style.dim(`\u2193 ${total - endIdx} more below...`, c)}`);
+  }
+  lines.push(bar);
+  const targetSuffix = options.targetHint ? ` \xB7 IDE: ${options.targetHint}` : "";
+  lines.push(
+    `${style.dim("\u2570\u2500", c)} ${style.bold(`${state.selected.size} selected`, c)}${style.dim(`${targetSuffix} \u2014 Enter to import`, c)}`
+  );
+  return lines.join("\n");
+}
+async function runMultiSelectPrompt(title, options, renderOpts = {}) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return null;
+  }
+  let state = createMultiSelectState(options);
+  let renderedLineCount = 0;
+  const render = () => {
+    const frame = renderMultiSelectFrame(title, state, renderOpts);
+    if (renderedLineCount > 0) {
+      process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+    }
+    process.stdout.write(`${frame}
+`);
+    renderedLineCount = frame.split("\n").length;
+  };
+  return new Promise((resolve) => {
+    const stdin = process.stdin;
+    const wasRaw = stdin.isRaw;
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf-8");
+    process.stdout.write("\x1B[?25l");
+    render();
+    const cleanup = () => {
+      stdin.removeListener("data", onData);
+      if (stdin.isTTY) {
+        stdin.setRawMode(Boolean(wasRaw));
+      }
+      stdin.pause();
+      process.stdout.write("\x1B[?25h");
+    };
+    const onData = (chunk) => {
+      const key = typeof chunk === "string" ? chunk : chunk.toString("utf-8");
+      state = applyMultiSelectKey(state, key);
+      if (state.status === "cancelled") {
+        if (renderedLineCount > 0) {
+          process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+        }
+        cleanup();
+        resolve(null);
+        return;
+      }
+      if (state.status === "submitted") {
+        if (renderedLineCount > 0) {
+          process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+        }
+        cleanup();
+        resolve([...state.selected]);
+        return;
+      }
+      render();
+    };
+    stdin.on("data", onData);
+  });
+}
+
 // src/framework/index.ts
 function extractMarkdownHeadings(markdownBody) {
   const headings = [];
@@ -5986,6 +6181,41 @@ function resolveCatalogDir(args, repoPath, loadedConfig) {
   }
   return path10.join(PACKAGE_ROOT, "catalog");
 }
+function buildInteractiveCatalogOptions(catalogDir) {
+  const options = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const skillDir of discoverSkillDirectories(catalogDir)) {
+    try {
+      const parsed = parseSkillDirectory(skillDir, { requireLayout: false });
+      if (!seen.has(parsed.manifest.name)) {
+        seen.add(parsed.manifest.name);
+        options.push({
+          value: parsed.manifest.name,
+          label: parsed.manifest.name,
+          kind: "skill",
+          hint: parsed.manifest.description
+        });
+      }
+    } catch {
+    }
+  }
+  for (const saPath of discoverSubagentFiles(catalogDir)) {
+    try {
+      const parsed = parseSubagentFile(saPath);
+      if (!seen.has(parsed.manifest.name)) {
+        seen.add(parsed.manifest.name);
+        options.push({
+          value: parsed.manifest.name,
+          label: parsed.manifest.name,
+          kind: "agent",
+          hint: parsed.manifest.description
+        });
+      }
+    } catch {
+    }
+  }
+  return options;
+}
 function runCli(argv) {
   const args = argv.slice(2);
   if (args.includes("--version") || args.includes("-V") || args[0] === "version") {
@@ -6184,6 +6414,7 @@ function runCli(argv) {
     return ExitCode.SUCCESS;
   }
   if (command === "list") {
+    const positionals = getPositionalArgs(args);
     const repoPath = getFlagValue(args, "--repo", "--project", "-p") ?? process.cwd();
     const cfgRes = loadSkillOpsConfig(repoPath);
     if (cfgRes.error) {
@@ -6195,6 +6426,12 @@ function runCli(argv) {
     }
     const catalogDir = resolveCatalogDir(args, repoPath, cfgRes.config);
     const rawFormat = getFlagValue(args, "--format", "-f") ?? "table";
+    if (positionals.length > 0) {
+      const format = rawFormat === "json" || rawFormat === "markdown" ? rawFormat : "table";
+      const report = searchCatalog(catalogDir, positionals.join(" "));
+      process.stdout.write(formatCatalogSearchReport(report, format));
+      return ExitCode.SUCCESS;
+    }
     const summary = auditCatalogTokenBudgets(catalogDir, {
       requireLayout: false
     });
@@ -6444,7 +6681,9 @@ function runCli(argv) {
     const force = args.includes("--force");
     const rawFormat = getFlagValue(args, "--format", "-f") ?? "table";
     const format = rawFormat === "json" || rawFormat === "markdown" ? rawFormat : "table";
-    if (positionals.length === 0) {
+    const importAll = args.includes("--all");
+    const itemsToAdd = importAll && positionals.length === 0 ? buildInteractiveCatalogOptions(catalogDir).map((o) => o.value) : positionals;
+    if (itemsToAdd.length === 0) {
       if (command === "add") {
         process.stderr.write(
           "Usage: npx skillops-cli add <skill-or-subagent-name> [more-names...] [options]\n"
@@ -6465,19 +6704,27 @@ function runCli(argv) {
       return report.passed ? ExitCode.SUCCESS : ExitCode.ERROR;
     }
     try {
-      let allPassed = true;
-      for (const itemName of positionals) {
-        const report = addSkillOrSubagent(repoPath, catalogDir, itemName, {
+      const reports = itemsToAdd.map(
+        (itemName) => addSkillOrSubagent(repoPath, catalogDir, itemName, {
           targets,
           dryRun,
           force
-        });
-        process.stdout.write(formatSyncReport(report, format));
-        if (!report.passed) {
-          allPassed = false;
-        }
+        })
+      );
+      const firstReport = reports[0];
+      if (!firstReport) {
+        return ExitCode.ERROR;
       }
-      return allPassed ? ExitCode.SUCCESS : ExitCode.ERROR;
+      const finalReport = reports.length === 1 ? firstReport : {
+        ...firstReport,
+        artifacts: reports.flatMap((r) => r.artifacts),
+        drift_conflicts: [
+          ...new Set(reports.flatMap((r) => r.drift_conflicts))
+        ],
+        passed: reports.every((r) => r.passed)
+      };
+      process.stdout.write(formatSyncReport(finalReport, format));
+      return finalReport.passed ? ExitCode.SUCCESS : ExitCode.ERROR;
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       process.stderr.write(`Error: ${msg}
@@ -6654,6 +6901,46 @@ function runCli(argv) {
   );
   return ExitCode.ERROR;
 }
+async function runCliInteractive(argv) {
+  const args = argv.slice(2);
+  const command = args[0];
+  if (command === "add" && !args.includes("--help") && !args.includes("-h") && !args.includes("--all") && getPositionalArgs(args).length === 0 && process.stdin.isTTY && process.stdout.isTTY) {
+    const repoPath = getFlagValue(args, "--repo", "--project", "-p") ?? process.cwd();
+    const cfgRes = loadSkillOpsConfig(repoPath);
+    if (cfgRes.error) {
+      process.stderr.write(
+        `Invalid .skillops.yml at ${cfgRes.configPath}: ${cfgRes.error}
+`
+      );
+      return ExitCode.BUDGET_OR_CONTRACT_ERROR;
+    }
+    const catalogDir = resolveCatalogDir(args, repoPath, cfgRes.config);
+    const targetsArg = resolveTargetsArg(args);
+    let targets;
+    try {
+      targets = targetsArg ? resolveRuntimeTargets(targetsArg, repoPath) : cfgRes.config?.targets ?? [...CORE_RUNTIME_TARGETS];
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`Invalid --targets: ${msg}
+`);
+      return ExitCode.BUDGET_OR_CONTRACT_ERROR;
+    }
+    const options = buildInteractiveCatalogOptions(catalogDir);
+    const selected = await runMultiSelectPrompt(
+      "SkillOps \u2014 Select Skills & Agents to Import",
+      options,
+      {
+        targetHint: `${targets.join(", ")} -> ${repoPath.replace(/\\/g, "/")}`
+      }
+    );
+    if (!selected || selected.length === 0) {
+      process.stdout.write("No Skills or Agents selected.\n");
+      return ExitCode.SUCCESS;
+    }
+    return runCli([...argv, ...selected]);
+  }
+  return runCli(argv);
+}
 function isDirectCliInvocation() {
   const entryArg = process.argv[1];
   if (!entryArg) {
@@ -6670,9 +6957,12 @@ function isDirectCliInvocation() {
   }
 }
 if (isDirectCliInvocation()) {
-  const code = runCli(process.argv);
-  process.exit(code);
+  runCliInteractive(process.argv).then((code) => {
+    process.exit(code);
+  });
 }
 export {
-  runCli
+  buildInteractiveCatalogOptions,
+  runCli,
+  runCliInteractive
 };

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import { z } from 'zod';
  * telemetry and Multi-Runtime Transpilation lockfiles.
  */
 
-declare const SKILLOPS_VERSION = "1.3.1";
+declare const SKILLOPS_VERSION = "1.3.2";
 /**
  * Count whitespace-delimited words in text.
  */
@@ -2165,7 +2165,7 @@ declare const COMMAND_HELP_SPECS: readonly CommandHelpSpec[];
  */
 declare function findCommandHelpSpec(commandOrAlias: string): CommandHelpSpec | undefined;
 /**
- * Render the compact, emoji-free 3-Pillar Framework & Library global help tree (`npx skillops-cli --help`).
+ * Render the compact, emoji-free global help tree (`npx skillops-cli --help`) focused on the 5 core commands.
  */
 declare function renderGlobalHelp(version: string, colorEnabled?: boolean): string;
 /**
@@ -2173,6 +2173,49 @@ declare function renderGlobalHelp(version: string, colorEnabled?: boolean): stri
  */
 declare function renderCommandHelp(spec: CommandHelpSpec, version: string, colorEnabled?: boolean): string;
 
+/**
+ * Zero-dependency interactive terminal multi-select prompt (`src/ui/prompt.ts`).
+ *
+ * Supports keyboard navigation (`↑`/`↓` or `j`/`k`), `Space` to toggle selection,
+ * `a` to toggle all, `Enter` to confirm, and `Esc`/`Ctrl+C` to cancel.
+ */
+interface MultiSelectOption {
+    readonly value: string;
+    readonly label: string;
+    readonly kind?: "skill" | "agent" | "ide";
+    readonly hint?: string;
+    readonly initialSelected?: boolean;
+}
+interface MultiSelectState {
+    readonly options: readonly MultiSelectOption[];
+    readonly cursor: number;
+    readonly selected: ReadonlySet<string>;
+    readonly status: "active" | "submitted" | "cancelled";
+}
+interface RenderMultiSelectOptions {
+    readonly subtitle?: string;
+    readonly targetHint?: string;
+    readonly maxVisible?: number;
+    readonly colorEnabled?: boolean;
+}
+/**
+ * Initialize a deterministic multi-select state from a list of options.
+ */
+declare function createMultiSelectState(options: readonly MultiSelectOption[]): MultiSelectState;
+/**
+ * Pure state reducer for keyboard input in the multi-select TUI.
+ */
+declare function applyMultiSelectKey(state: MultiSelectState, key: string): MultiSelectState;
+/**
+ * Render a single frame of the multi-select tree prompt (guaranteed <= 78 columns).
+ */
+declare function renderMultiSelectFrame(title: string, state: MultiSelectState, options?: RenderMultiSelectOptions): string;
+/**
+ * Run an interactive multi-select prompt in a TTY terminal.
+ * Returns the array of selected values, or `null` if cancelled by user.
+ */
+declare function runMultiSelectPrompt(title: string, options: readonly MultiSelectOption[], renderOpts?: RenderMultiSelectOptions): Promise<string[] | null>;
+
 /**
  * SkillOps Zero-Dependency Terminal UI (TUI) Aesthetic Engine.
  *
@@ -2292,4 +2335,4 @@ declare const DEFAULT_VALID_COMMANDS: readonly string[];
  */
 declare function suggestCommand(unknownCommand: string, validCommands?: readonly string[]): string | null;
 
-export { ALL_RUNTIME_TARGETS, type AddOptions, type AnalyzeTokenEconomyOptions, type AuditCatalogOptions, type BadgeType, type BenchmarkArm, BenchmarkArmSchema, type BenchmarkDelta, BenchmarkDeltaSchema, type BoxOptions, COMMAND_HELP_SPECS, CORE_RUNTIME_TARGETS, type CatalogEvalSummary, CatalogEvalSummarySchema, type CatalogItemInfo, type CatalogSearchMatch, type CatalogSearchReport, type CatalogTokenBudgetSummary, type CatalogTrack, CatalogTrackSchema, type CleanOptions, type CollisionPair, CollisionPairSchema, type CollisionReport, CollisionReportSchema, type CollisionSeverity, CollisionSeveritySchema, type ColorOverrideOptions, type CommandHelpSpec, type CommandOptionSpec, DEFAULT_VALID_COMMANDS, type DiagnoseRepositoryOptions, type DoctorCheckItem, type DoctorReport, type EvalAssertion, EvalAssertionSchema, type EvalCase, EvalCaseSchema, ExitCode, type ExitCodeValue, type HarnessCategory, type HarnessInspectionEntry, type HarnessInspectionReport, type HarnessSkillFormat, type JsonRpcRequest, type JsonRpcResponse, type LoadedSkillOpsConfigResult, type LockfileArtifactDiagnostic, type McpConfigAction, type McpServerContext, type McpSetupOptions, type McpSetupReport, type NextStepHint, type ParseSkillOptions, type ParsedSkillDirectory, type ParsedSubagentFile, type QuickstartOptions, type QuickstartReport, RUNTIME_HARNESS_SPECS, type RemoveOptions, RepoFingerprinter, type RepoProfile, RepoProfileSchema, type RouteOptions, type RoutedBundle, RoutedBundleSchema, type RoutingSignals, RoutingSignalsSchema, type RuntimeHarnessSpec, type RuntimeTarget, RuntimeTargetSchema, SKILLOPS_VERSION, type ScaffoldOptions, type ScaffoldResult, type ScoredSkill, ScoredSkillSchema, type ScriptEntrypoint, ScriptEntrypointSchema, type SkillBenchmark, SkillBenchmarkSchema, type SkillEntrypoints, SkillEntrypointsSchema, type SkillEvalSuite, SkillEvalSuiteSchema, type SkillManifest, type SkillManifestInput, SkillManifestSchema, type SkillOpsConfig, SkillOpsConfigSchema, type SkillOpsDetectedStackConfig, SkillOpsDetectedStackConfigSchema, type SkillOpsTokenEconomyConfig, SkillOpsTokenEconomyConfigSchema, type SkillTokenBudgetAudit, type SkippedSkill, SkippedSkillSchema, type SubagentManifest, SubagentManifestSchema, type SubagentTokenBudgetAudit, type SyncLockEntry, SyncLockEntrySchema, type SyncLockfile, SyncLockfileSchema, type SyncOptions, type SyncReport, SyncReportSchema, type SyncedArtifact, SyncedArtifactSchema, type TableOptions, type TokenBarOptions, type TokenEconomyReport, TokenEconomyReportSchema, type TokenFileCategory, TokenFileCategorySchema, type TokenFileEntry, TokenFileEntrySchema, type TokenWasteHotspot, TokenWasteHotspotSchema, addSkillOrSubagent, analyzeRepoTokenEconomy, auditCatalog, auditCatalogTokenBudgets, auditSkillTokenBudget, auditSubagentTokenBudget, classifyCollisionSeverity, cleanSyncedArtifacts, compileSkillBundle, computeCollisionMatrix, computeFeatureCosine, computeIdfWeights, computeSha256, countWords, createCollisionPair, createCollisionReport, createSkillManifest, createSubagentManifest, detectInstalledHarnesses, diagnoseRepository, discoverSkillDirectories, discoverSubagentFiles, estimateTokenCount, evaluateCatalog, evaluateSkillDirectory, extractSkillFeatures, findCommandHelpSpec, fingerprintRepository, formatBadge, formatCatalogItemInfo, formatCatalogSearchReport, formatDoctorReport, formatEvalSummary, formatHarnessInspectionReport, formatMcpSetupReport, formatQuickstartReport, formatRoutedBundle, formatScaffoldReport, formatSyncReport, formatTokenEconomyReport, handleMcpJsonRpcRequest, inspectCatalogItem, inspectHarnesses, isColorEnabled, levenshteinDistance, loadSkillOpsConfig, normalizePackageName, padVisible, parseSkillDirectory, parseSkillMdFile, parseSubagentFile, parseSubagentMdFile, removeSkillOrSubagent, renderAiUsageGuide, renderBox, renderCodexAgentsIndex, renderCommandHelp, renderGlobalHelp, renderHeaderBanner, renderNextSteps, renderProgressBar, renderSectionHeader, renderStep, renderTable, renderTokenBar, resolveRuntimeTargets, routeRepository, runQuickstart, scaffoldFrameworkItem, scoreSkillAgainstProfile, searchCatalog, setupMcpForHarnesses, splitFrontmatter, startMcpStdioServer, stripAnsi, stripCodexAgentsBlock, stripNegativeTriggerClauses, style, suggestCommand, syncRepository, tokenizeRoutingText, visibleLength };
+export { ALL_RUNTIME_TARGETS, type AddOptions, type AnalyzeTokenEconomyOptions, type AuditCatalogOptions, type BadgeType, type BenchmarkArm, BenchmarkArmSchema, type BenchmarkDelta, BenchmarkDeltaSchema, type BoxOptions, COMMAND_HELP_SPECS, CORE_RUNTIME_TARGETS, type CatalogEvalSummary, CatalogEvalSummarySchema, type CatalogItemInfo, type CatalogSearchMatch, type CatalogSearchReport, type CatalogTokenBudgetSummary, type CatalogTrack, CatalogTrackSchema, type CleanOptions, type CollisionPair, CollisionPairSchema, type CollisionReport, CollisionReportSchema, type CollisionSeverity, CollisionSeveritySchema, type ColorOverrideOptions, type CommandHelpSpec, type CommandOptionSpec, DEFAULT_VALID_COMMANDS, type DiagnoseRepositoryOptions, type DoctorCheckItem, type DoctorReport, type EvalAssertion, EvalAssertionSchema, type EvalCase, EvalCaseSchema, ExitCode, type ExitCodeValue, type HarnessCategory, type HarnessInspectionEntry, type HarnessInspectionReport, type HarnessSkillFormat, type JsonRpcRequest, type JsonRpcResponse, type LoadedSkillOpsConfigResult, type LockfileArtifactDiagnostic, type McpConfigAction, type McpServerContext, type McpSetupOptions, type McpSetupReport, type MultiSelectOption, type MultiSelectState, type NextStepHint, type ParseSkillOptions, type ParsedSkillDirectory, type ParsedSubagentFile, type QuickstartOptions, type QuickstartReport, RUNTIME_HARNESS_SPECS, type RemoveOptions, type RenderMultiSelectOptions, RepoFingerprinter, type RepoProfile, RepoProfileSchema, type RouteOptions, type RoutedBundle, RoutedBundleSchema, type RoutingSignals, RoutingSignalsSchema, type RuntimeHarnessSpec, type RuntimeTarget, RuntimeTargetSchema, SKILLOPS_VERSION, type ScaffoldOptions, type ScaffoldResult, type ScoredSkill, ScoredSkillSchema, type ScriptEntrypoint, ScriptEntrypointSchema, type SkillBenchmark, SkillBenchmarkSchema, type SkillEntrypoints, SkillEntrypointsSchema, type SkillEvalSuite, SkillEvalSuiteSchema, type SkillManifest, type SkillManifestInput, SkillManifestSchema, type SkillOpsConfig, SkillOpsConfigSchema, type SkillOpsDetectedStackConfig, SkillOpsDetectedStackConfigSchema, type SkillOpsTokenEconomyConfig, SkillOpsTokenEconomyConfigSchema, type SkillTokenBudgetAudit, type SkippedSkill, SkippedSkillSchema, type SubagentManifest, SubagentManifestSchema, type SubagentTokenBudgetAudit, type SyncLockEntry, SyncLockEntrySchema, type SyncLockfile, SyncLockfileSchema, type SyncOptions, type SyncReport, SyncReportSchema, type SyncedArtifact, SyncedArtifactSchema, type TableOptions, type TokenBarOptions, type TokenEconomyReport, TokenEconomyReportSchema, type TokenFileCategory, TokenFileCategorySchema, type TokenFileEntry, TokenFileEntrySchema, type TokenWasteHotspot, TokenWasteHotspotSchema, addSkillOrSubagent, analyzeRepoTokenEconomy, applyMultiSelectKey, auditCatalog, auditCatalogTokenBudgets, auditSkillTokenBudget, auditSubagentTokenBudget, classifyCollisionSeverity, cleanSyncedArtifacts, compileSkillBundle, computeCollisionMatrix, computeFeatureCosine, computeIdfWeights, computeSha256, countWords, createCollisionPair, createCollisionReport, createMultiSelectState, createSkillManifest, createSubagentManifest, detectInstalledHarnesses, diagnoseRepository, discoverSkillDirectories, discoverSubagentFiles, estimateTokenCount, evaluateCatalog, evaluateSkillDirectory, extractSkillFeatures, findCommandHelpSpec, fingerprintRepository, formatBadge, formatCatalogItemInfo, formatCatalogSearchReport, formatDoctorReport, formatEvalSummary, formatHarnessInspectionReport, formatMcpSetupReport, formatQuickstartReport, formatRoutedBundle, formatScaffoldReport, formatSyncReport, formatTokenEconomyReport, handleMcpJsonRpcRequest, inspectCatalogItem, inspectHarnesses, isColorEnabled, levenshteinDistance, loadSkillOpsConfig, normalizePackageName, padVisible, parseSkillDirectory, parseSkillMdFile, parseSubagentFile, parseSubagentMdFile, removeSkillOrSubagent, renderAiUsageGuide, renderBox, renderCodexAgentsIndex, renderCommandHelp, renderGlobalHelp, renderHeaderBanner, renderMultiSelectFrame, renderNextSteps, renderProgressBar, renderSectionHeader, renderStep, renderTable, renderTokenBar, resolveRuntimeTargets, routeRepository, runMultiSelectPrompt, runQuickstart, scaffoldFrameworkItem, scoreSkillAgainstProfile, searchCatalog, setupMcpForHarnesses, splitFrontmatter, startMcpStdioServer, stripAnsi, stripCodexAgentsBlock, stripNegativeTriggerClauses, style, suggestCommand, syncRepository, tokenizeRoutingText, visibleLength };

package/dist/index.js

@@ -2,7 +2,7 @@
 import fs from "fs";
 import YAML from "yaml";
 import { z } from "zod";
-var SKILLOPS_VERSION = "1.3.1";
+var SKILLOPS_VERSION = "1.3.2";
 var SKILL_NAME_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var SEMVER_REGEX = /^\d+\.\d+\.\d+$/;
 var FRONTMATTER_REGEX = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
@@ -5131,45 +5131,52 @@ function renderGlobalHelp(version, colorEnabled) {
   const c = colorEnabled;
   const bar = style.dim("\u2502", c);
   const banner = renderHeaderBanner(
-    "Framework & Library for AI Skills & Subagents",
+    "Skills & Agents Library for AI Coding IDEs",
     {
       version,
       colorEnabled: c
     }
   );
-  const formatCmdSection = (pillar) => {
-    const specs = COMMAND_HELP_SPECS.filter((s) => s.pillar === pillar);
-    return specs.map((s) => {
-      const aliasPart = s.aliases.length > 0 ? style.dim(` (${s.aliases.join(", ")})`, c) : "";
-      const cmdCol = padVisible(
-        `${style.bold(style.cyan(s.name, c), c)}${aliasPart}`,
-        23,
-        "left"
-      );
-      return `${bar}  ${cmdCol}${s.summary}`;
-    }).join("\n");
-  };
+  const coreCmds = [
+    {
+      cmd: "add [name...]",
+      desc: "Import Skills or Agents (interactive if no name given)"
+    },
+    {
+      cmd: "list [query]",
+      desc: "List or filter available Skills & Agents in catalog"
+    },
+    {
+      cmd: "info <name>",
+      desc: "View details and how to use a Skill or Agent"
+    },
+    {
+      cmd: "remove <name>",
+      desc: "Remove an imported Skill or Agent from your project"
+    },
+    {
+      cmd: "init",
+      desc: "Auto-detect stack & IDE and import recommended bundle"
+    }
+  ];
+  const cmdRows = coreCmds.map(
+    (item) => `${bar}  ${padVisible(style.bold(style.cyan(item.cmd, c), c), 18, "left")}${item.desc}`
+  ).join("\n");
   return [
     banner,
-    `${bar}  Usage: npx skillops-cli <command> [options]`,
-    renderSectionHeader("Quickstart (Library + Framework)", c),
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.green("npx skillops-cli quickstart", c), c)}          ${style.dim("\u2014 Detect stack, sync Skills & MCP", c)}`,
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.cyan("npx skillops-cli info <name>", c), c)}         ${style.dim("\u2014 Inspect Skill/Subagent & usage", c)}`,
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.magenta("npx skillops-cli create skill <name>", c), c)} ${style.dim("\u2014 Scaffold a custom Skill", c)}`,
-    renderSectionHeader("1. Library of High-End Skills & Subagents", c),
-    formatCmdSection("library"),
-    renderSectionHeader(
-      "2. Framework for Building Custom Skills & Subagents",
-      c
-    ),
-    formatCmdSection("framework"),
-    renderSectionHeader(
-      "3. Universal Runtime Sync, Token Economy & Diagnostics",
-      c
-    ),
-    formatCmdSection("runtime"),
+    `${bar}  Usage: skillops <command> [options]`,
+    renderSectionHeader("Commands", c),
+    cmdRows,
+    renderSectionHeader("Options", c),
+    `${bar}  ${padVisible(style.cyan("-t, --target <ide>", c), 22, "left")}AI IDE (cursor, claude, copilot, windsurf, auto)`,
+    `${bar}  ${padVisible(style.cyan("-p, --project <dir>", c), 22, "left")}Project folder (default: current directory)`,
+    `${bar}  ${padVisible(style.cyan("--all", c), 22, "left")}Import all 10 Skills & 9 Agents`,
+    renderSectionHeader("Examples", c),
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops add", c)}                                  ${style.dim("\u2014 Interactive selector", c)}`,
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops add bug-reproducer-tdd red-team-breaker", c)} ${style.dim("\u2014 Direct import", c)}`,
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops list", c)}                                 ${style.dim("\u2014 Browse catalog", c)}`,
     bar,
-    `${style.dim("\u2570\u2500", c)} ${style.bold("Global Flags:", c)} ${style.cyan("-p <dir>", c)} \xB7 ${style.cyan("-t <harnesses>", c)} \xB7 ${style.cyan("-f <table|json|md>", c)} \xB7 ${style.cyan("-h <cmd>", c)}`
+    `${style.dim("\u2570\u2500", c)} ${style.dim("Run", c)} ${style.cyan("skillops <cmd> -h", c)} ${style.dim("for command options.", c)}`
   ].join("\n");
 }
 function renderCommandHelp(spec, version, colorEnabled) {
@@ -5194,6 +5201,194 @@ function renderCommandHelp(spec, version, colorEnabled) {
   return [headerLines, optionsSection, examplesSection].filter(Boolean).join("\n");
 }
 
+// src/ui/prompt.ts
+function createMultiSelectState(options) {
+  const initial = /* @__PURE__ */ new Set();
+  for (const opt of options) {
+    if (opt.initialSelected) {
+      initial.add(opt.value);
+    }
+  }
+  return {
+    options,
+    cursor: 0,
+    selected: initial,
+    status: "active"
+  };
+}
+function applyMultiSelectKey(state, key) {
+  if (state.status !== "active" || state.options.length === 0) {
+    return state;
+  }
+  const count = state.options.length;
+  if (key === "" || key === "\x1B" || key === "q" || key === "Q") {
+    return {
+      ...state,
+      status: "cancelled"
+    };
+  }
+  if (key === "\r" || key === "\n") {
+    return {
+      ...state,
+      status: "submitted"
+    };
+  }
+  if (key === "\x1B[A" || key === "\x1BOA" || key === "k" || key === "K") {
+    const nextCursor = (state.cursor - 1 + count) % count;
+    return {
+      ...state,
+      cursor: nextCursor
+    };
+  }
+  if (key === "\x1B[B" || key === "\x1BOB" || key === "j" || key === "J") {
+    const nextCursor = (state.cursor + 1) % count;
+    return {
+      ...state,
+      cursor: nextCursor
+    };
+  }
+  if (key === " ") {
+    const currentOpt = state.options[state.cursor];
+    if (!currentOpt) {
+      return state;
+    }
+    const nextSelected = new Set(state.selected);
+    if (nextSelected.has(currentOpt.value)) {
+      nextSelected.delete(currentOpt.value);
+    } else {
+      nextSelected.add(currentOpt.value);
+    }
+    return {
+      ...state,
+      selected: nextSelected
+    };
+  }
+  if (key === "a" || key === "A") {
+    const allSelected = state.selected.size === count;
+    const nextSelected = /* @__PURE__ */ new Set();
+    if (!allSelected) {
+      for (const opt of state.options) {
+        nextSelected.add(opt.value);
+      }
+    }
+    return {
+      ...state,
+      selected: nextSelected
+    };
+  }
+  return state;
+}
+function renderMultiSelectFrame(title, state, options = {}) {
+  const c = options.colorEnabled;
+  const bar = style.dim("\u2502", c);
+  const maxVisible = options.maxVisible ?? 10;
+  const total = state.options.length;
+  const header = `${style.bold(style.cyan(`\u25C6 ${title}`, c), c)}`;
+  const instructions = `${bar}  ${style.dim("(\u2191/\u2193 move \xB7 Space select \xB7 'a' toggle all \xB7 Enter confirm)", c)}`;
+  const lines = [header];
+  if (options.subtitle) {
+    lines.push(`${bar}  ${options.subtitle}`);
+  }
+  lines.push(instructions, bar);
+  let startIdx = 0;
+  if (total > maxVisible) {
+    const half = Math.floor(maxVisible / 2);
+    startIdx = Math.max(0, Math.min(state.cursor - half, total - maxVisible));
+  }
+  const endIdx = Math.min(total, startIdx + maxVisible);
+  if (startIdx > 0) {
+    lines.push(`${bar}  ${style.dim(`\u2191 ${startIdx} more above...`, c)}`);
+  }
+  const maxLabelCols = Math.min(
+    26,
+    state.options.reduce((m, o) => Math.max(m, visibleLength(o.label)), 14)
+  );
+  for (let i = startIdx; i < endIdx; i++) {
+    const opt = state.options[i];
+    if (!opt) continue;
+    const isCurrent = i === state.cursor;
+    const isChecked = state.selected.has(opt.value);
+    const pointer = isCurrent ? style.cyan("\u276F", c) : " ";
+    const checkbox = isChecked ? style.green("\u25FC", c) : style.dim("\u25FB", c);
+    const kindTag = opt.kind === "skill" ? style.cyan("skill ", c) : opt.kind === "agent" ? style.magenta("agent ", c) : "";
+    const labelRaw = opt.label.length > maxLabelCols ? `${opt.label.slice(0, maxLabelCols - 1)}\u2026` : opt.label;
+    const labelPadded = padVisible(labelRaw, maxLabelCols + 1, "left");
+    const styledLabel = isCurrent ? style.bold(labelPadded, c) : isChecked ? style.green(labelPadded, c) : labelPadded;
+    const prefixWidth = 6 + (opt.kind === "skill" || opt.kind === "agent" ? 6 : 0) + maxLabelCols + 1;
+    const maxHintCols = Math.max(10, 75 - prefixWidth);
+    const rawHint = opt.hint ?? "";
+    const shortHint = rawHint.length > maxHintCols ? `${rawHint.slice(0, maxHintCols - 1)}\u2026` : rawHint;
+    const hintPart = shortHint ? ` ${style.dim(shortHint, c)}` : "";
+    lines.push(
+      `${bar}  ${pointer} ${checkbox} ${kindTag}${styledLabel}${hintPart}`
+    );
+  }
+  if (endIdx < total) {
+    lines.push(`${bar}  ${style.dim(`\u2193 ${total - endIdx} more below...`, c)}`);
+  }
+  lines.push(bar);
+  const targetSuffix = options.targetHint ? ` \xB7 IDE: ${options.targetHint}` : "";
+  lines.push(
+    `${style.dim("\u2570\u2500", c)} ${style.bold(`${state.selected.size} selected`, c)}${style.dim(`${targetSuffix} \u2014 Enter to import`, c)}`
+  );
+  return lines.join("\n");
+}
+async function runMultiSelectPrompt(title, options, renderOpts = {}) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return null;
+  }
+  let state = createMultiSelectState(options);
+  let renderedLineCount = 0;
+  const render = () => {
+    const frame = renderMultiSelectFrame(title, state, renderOpts);
+    if (renderedLineCount > 0) {
+      process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+    }
+    process.stdout.write(`${frame}
+`);
+    renderedLineCount = frame.split("\n").length;
+  };
+  return new Promise((resolve) => {
+    const stdin = process.stdin;
+    const wasRaw = stdin.isRaw;
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf-8");
+    process.stdout.write("\x1B[?25l");
+    render();
+    const cleanup = () => {
+      stdin.removeListener("data", onData);
+      if (stdin.isTTY) {
+        stdin.setRawMode(Boolean(wasRaw));
+      }
+      stdin.pause();
+      process.stdout.write("\x1B[?25h");
+    };
+    const onData = (chunk) => {
+      const key = typeof chunk === "string" ? chunk : chunk.toString("utf-8");
+      state = applyMultiSelectKey(state, key);
+      if (state.status === "cancelled") {
+        if (renderedLineCount > 0) {
+          process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+        }
+        cleanup();
+        resolve(null);
+        return;
+      }
+      if (state.status === "submitted") {
+        if (renderedLineCount > 0) {
+          process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+        }
+        cleanup();
+        resolve([...state.selected]);
+        return;
+      }
+      render();
+    };
+    stdin.on("data", onData);
+  });
+}
+
 // src/framework/index.ts
 function extractMarkdownHeadings(markdownBody) {
   const headings = [];
@@ -5950,6 +6145,7 @@ export {
   TokenWasteHotspotSchema,
   addSkillOrSubagent,
   analyzeRepoTokenEconomy,
+  applyMultiSelectKey,
   auditCatalog,
   auditCatalogTokenBudgets,
   auditSkillTokenBudget,
@@ -5964,6 +6160,7 @@ export {
   countWords,
   createCollisionPair,
   createCollisionReport,
+  createMultiSelectState,
   createSkillManifest,
   createSubagentManifest,
   detectInstalledHarnesses,
@@ -6007,6 +6204,7 @@ export {
   renderCommandHelp,
   renderGlobalHelp,
   renderHeaderBanner,
+  renderMultiSelectFrame,
   renderNextSteps,
   renderProgressBar,
   renderSectionHeader,
@@ -6015,6 +6213,7 @@ export {
   renderTokenBar,
   resolveRuntimeTargets,
   routeRepository,
+  runMultiSelectPrompt,
   runQuickstart,
   scaffoldFrameworkItem,
   scoreSkillAgainstProfile,

package/package.json

@@ -1,86 +1,86 @@
 {
-  "name": "skillops-cli",
-  "version": "1.3.1",
-  "description": "SkillOps — The Zero-API Framework & Benchmark-Verified Library for High-End AI Coding Skills & Context-Isolated Subagents with Universal Top-20 AI Agent Transpilation & Token Economy Auditing.",
-  "type": "module",
-  "license": "MIT",
-  "author": "OdevMatheus <matheusvita007@gmail.com>",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/OdevMatheus/SkillOps.git"
-  },
-  "homepage": "https://github.com/OdevMatheus/SkillOps#readme",
-  "bugs": {
-    "url": "https://github.com/OdevMatheus/SkillOps/issues"
-  },
-  "bin": {
-    "skillops-cli": "./dist/cli.js",
-    "skillops": "./dist/cli.js"
-  },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "catalog",
-    ".github/agents",
-    "docs/BENCHMARKS.md",
-    "SKILL_CONTRACT.md",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "prepublishOnly": "npm run build && npm test",
-    "lint": "tsc --noEmit",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "skillops": "node dist/cli.js"
-  },
-  "dependencies": {
-    "yaml": "^2.7.0",
-    "zod": "^3.24.2"
-  },
-  "devDependencies": {
-    "@types/node": "^22.13.0",
-    "tsup": "^8.4.0",
-    "typescript": "^5.8.2",
-    "vitest": "^3.0.7"
-  },
-  "keywords": [
-    "ai-agents",
-    "agent-skills",
-    "subagents",
-    "token-economy",
-    "claude-code",
-    "cursor",
-    "antigravity",
-    "codex",
-    "github-copilot",
-    "windsurf",
-    "cline",
-    "roocode",
-    "kilocode",
-    "zed",
-    "continue",
-    "aider",
-    "openhands",
-    "amp",
-    "goose",
-    "opencode",
-    "kiro",
-    "trae",
-    "amazon-q",
-    "junie",
-    "mcp",
-    "context-engineering"
-  ]
+	"name": "skillops-cli",
+	"version": "1.3.2",
+	"description": "SkillOps — The Zero-API Framework & Benchmark-Verified Library for High-End AI Coding Skills & Context-Isolated Subagents with Universal Top-20 AI Agent Transpilation & Token Economy Auditing.",
+	"type": "module",
+	"license": "MIT",
+	"author": "OdevMatheus <matheusvita007@gmail.com>",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/OdevMatheus/SkillOps.git"
+	},
+	"homepage": "https://github.com/OdevMatheus/SkillOps#readme",
+	"bugs": {
+		"url": "https://github.com/OdevMatheus/SkillOps/issues"
+	},
+	"bin": {
+		"skillops-cli": "./dist/cli.js",
+		"skillops": "./dist/cli.js"
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"catalog",
+		".github/agents",
+		"docs/BENCHMARKS.md",
+		"SKILL_CONTRACT.md",
+		"README.md",
+		"LICENSE"
+	],
+	"engines": {
+		"node": ">=20.0.0"
+	},
+	"scripts": {
+		"build": "tsup",
+		"prepublishOnly": "npm run build && npm test",
+		"lint": "tsc --noEmit",
+		"typecheck": "tsc --noEmit",
+		"test": "vitest run",
+		"skillops": "node dist/cli.js"
+	},
+	"dependencies": {
+		"yaml": "^2.7.0",
+		"zod": "^3.24.2"
+	},
+	"devDependencies": {
+		"@types/node": "^22.13.0",
+		"tsup": "^8.4.0",
+		"typescript": "^5.8.2",
+		"vitest": "^3.0.7"
+	},
+	"keywords": [
+		"ai-agents",
+		"agent-skills",
+		"subagents",
+		"token-economy",
+		"claude-code",
+		"cursor",
+		"antigravity",
+		"codex",
+		"github-copilot",
+		"windsurf",
+		"cline",
+		"roocode",
+		"kilocode",
+		"zed",
+		"continue",
+		"aider",
+		"openhands",
+		"amp",
+		"goose",
+		"opencode",
+		"kiro",
+		"trae",
+		"amazon-q",
+		"junie",
+		"mcp",
+		"context-engineering"
+	]
 }