@nano-step/skill-manager 5.0.0 → 5.0.1

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-export declare const MANAGER_VERSION = "5.0.0";
+export declare const MANAGER_VERSION = "5.0.1";
 export interface SkillManifest {
     name: string;
     version: string;

package/dist/utils.js

@@ -13,7 +13,7 @@ exports.writeText = writeText;
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
-exports.MANAGER_VERSION = "5.0.0";
+exports.MANAGER_VERSION = "5.0.1";
 async function detectOpenCodePaths() {
     const homeConfig = path_1.default.join(os_1.default.homedir(), ".config", "opencode");
     const cwd = process.cwd();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nano-step/skill-manager",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "description": "CLI tool that installs and manages AI agent skills, MCP tool routing, and workflow configurations.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,6 +19,8 @@
   "keywords": [
     "nano-step",
     "opencode",
+    "skill",
+    "skill-manager",
     "mcp",
     "model-context-protocol",
     "ai",

package/skills/skill-management/assets/tools-template.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Agent Skill Tools Cache v2.0.0",
-  "description": "Cache file for MCP tool routing. Generated by /agent-skill-refresh command using semantic AI categorization.",
+  "description": "Cache file for tool routing. Generated by /skill-refresh command using semantic AI categorization.",
   "type": "object",
   "properties": {
     "version": {

package/skills/skill-management/assets/workflow-schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Agent Skill Workflow Definition",
-  "description": "Schema for defining prerequisite workflows in Agent Skill Manager",
+  "description": "Schema for defining prerequisite workflows in Skill Manager",
   "type": "object",
   "properties": {
     "enabled": {

package/skills/skill-management/references/error-handling.md

@@ -12,7 +12,7 @@
 
 ## Automatic Retry Mechanism
 
-The agent-skill-manager automatically retries failed tool executions before returning errors.
+The skill-manager automatically retries failed tool executions before returning errors.
 
 ### Retry Configuration
 - Maximum attempts: 3
@@ -67,7 +67,7 @@ Template:
 ```
 Error: Tool not found: <tool-id>
 Suggestions: <tool-a>, <tool-b>, <tool-c>
-Next: confirm the intended tool or run /agent-skill-refresh.
+Next: confirm the intended tool or run /skill-refresh.
 ```
 
 ## Execution Failure Handling
@@ -113,18 +113,18 @@ Next: confirm retry with new parameters
 
 ## Cache Missing Recovery
 Symptoms:
-- `.opencode/agent-skill-tools.json` missing.
+- `.opencode/skill-tools.json` missing.
 - Cache file invalid or unreadable.
 
 Recovery steps:
 1. Inform that cache is missing or invalid.
-2. Recommend /agent-skill-refresh to regenerate.
+2. Recommend /skill-refresh to regenerate.
 3. Proceed with dynamic tool discovery if possible.
 
 Template:
 ```
-Cache missing or invalid at .opencode/agent-skill-tools.json
-Suggestion: run /agent-skill-refresh
+Cache missing or invalid at .opencode/skill-tools.json
+Suggestion: run /skill-refresh
 Fallback: dynamic discovery enabled
 ```
 
@@ -247,7 +247,7 @@ Decision tree (text form):
    - Yes -> request corrected params.
    - No -> continue.
 5. Is cache missing?
-   - Yes -> recommend /agent-skill-refresh and use dynamic discovery.
+   - Yes -> recommend /skill-refresh and use dynamic discovery.
    - No -> continue.
 6. Unknown failure
    - Provide generic error template and ask for clarification.

package/skills/skill-management/references/tool-categories.md

@@ -6,7 +6,7 @@
 
 This skill uses **semantic categorization**:
 
-1. **Tool discovery** - `/agent-skill-refresh` enumerates all tools available to the agent
+1. **Tool discovery** - `/skill-refresh` enumerates all tools available to the agent
 2. **Semantic analysis** - the AI reads each tool's **name + description**
 3. **Dynamic grouping** - tools are grouped into categories based on what they do
 
@@ -31,12 +31,12 @@ categories are **labels**, not fixed contracts, and can evolve with the tool set
 
 - Categories are **not hard-coded**
 - Category names are **derived from the tools** at refresh time
-- Custom MCP servers are handled automatically
-- The system works with any MCP configuration (MetaMCP, standalone, or custom)
+- Custom tool servers are handled automatically
+- The system works with any tool configuration (MetaMCP, standalone, or custom)
 
 ## Cache File (v2.0.0) - How to Read It
 
-The `/agent-skill-refresh` command writes a cache file using the v2.0.0 schema. This
+The `/skill-refresh` command writes a cache file using the v2.0.0 schema. This
 file is the **source of truth** for the current categorization state.
 
 ### Schema Overview

package/skills/skill-management/references/tool-execution.md

@@ -3,11 +3,11 @@
 # Do not include category catalogs, result summarization, or error templates here.
 
 ## Cache Access and Reading
-Cache location: .opencode/agent-skill-tools.json
-Purpose: fast tool routing without reloading full MCP schemas.
+Cache location: .opencode/skill-tools.json
+Purpose: fast tool routing without reloading full tool schemas.
 
 How to read the cache:
-1. Check if file exists at project root `.opencode/agent-skill-tools.json`.
+1. Check if file exists at project root `.opencode/skill-tools.json`.
 2. Parse JSON into a structured object.
 3. Validate minimal fields: version, refreshed_at, tool_count, categories.
 4. If missing or malformed, fall back to dynamic discovery.
@@ -18,10 +18,10 @@ Cache staleness heuristic:
 
 ## Cache Schema (TypeScript Interface)
 ```ts
-interface AgentSkillToolCache {
+interface SkillToolCache {
   version: string;
   refreshed_at: string; // ISO string
-  mcp_servers: string[];
+  tool_sources: string[];
   tool_count: number;
   categories: {
     [name: string]: {
@@ -156,7 +156,7 @@ params: { fullPage: true }
 ## When to Avoid Cache
 - During tool upgrades or when discrepancies are reported.
 - When a tool id from cache fails execution.
-- When the user references a new MCP server prefix.
+- When the user references a new tool server prefix.
 
 ## Execution Prerequisites
 - Ensure selected tool exists in cache or registry.
@@ -234,7 +234,7 @@ Tool: sequentialthinking { thought: "...", thoughtNumber: 1, totalThoughts: 4, n
 ## Cache Refresh Recommendation Text
 Recommended message:
 ```
-Cache appears stale or missing. Run /agent-skill-refresh to rebuild tool metadata.
+Cache appears stale or missing. Run /skill-refresh to rebuild tool metadata.
 ```
 
 ## Execution Output Metadata (Internal)

package/skills/skill-management/references/workflows.md

@@ -70,7 +70,7 @@ Each prerequisite step has:
 
 ## Session State
 
-Completed prerequisites are tracked in `.opencode/.agent-skill-session.json`:
+Completed prerequisites are tracked in `.opencode/.skill-session.json`:
 
 ```json
 {
@@ -202,26 +202,26 @@ Also matched: 'custom-db-workflow'
 
 ## Managing Workflows
 
-Use `/agent-skill-workflow` command:
+Use `/skill-workflow` command:
 
 ```bash
 # List all workflows
-/agent-skill-workflow list
+/skill-workflow list
 
 # Add from template
-/agent-skill-workflow add --template database
+/skill-workflow add --template database
 
 # Add custom workflow
-/agent-skill-workflow add my-workflow
+/skill-workflow add my-workflow
 
 # Edit existing
-/agent-skill-workflow edit my-workflow
+/skill-workflow edit my-workflow
 
 # Disable temporarily
-/agent-skill-workflow disable my-workflow
+/skill-workflow disable my-workflow
 
 # Remove
-/agent-skill-workflow remove my-workflow
+/skill-workflow remove my-workflow
 ```
 
 ## Best Practices
@@ -230,4 +230,4 @@ Use `/agent-skill-workflow` command:
 2. **Use enforce sparingly** - Only for critical safety workflows
 3. **Keep prerequisites minimal** - Each step adds latency
 4. **Mark optional steps** - Use `required: false` for nice-to-have steps
-5. **Review session state** - Check `.agent-skill-session.json` if prerequisites seem stuck
+5. **Review session state** - Check `.skill-session.json` if prerequisites seem stuck

package/dist/install.d.ts

@@ -1 +0,0 @@
-export declare function install(): Promise<void>;

package/dist/install.js

@@ -1,35 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.install = install;
-const path_1 = __importDefault(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const utils_1 = require("./utils");
-async function install() {
-    const paths = await (0, utils_1.detectOpenCodePaths)();
-    await (0, utils_1.ensureDirExists)(paths.commandDir);
-    await (0, utils_1.ensureDirExists)(paths.skillsDir);
-    const skillTargetDir = path_1.default.join(paths.skillsDir, utils_1.SKILL_DIR_NAME);
-    const commandTargetPath = path_1.default.join(paths.commandDir, "agent-skill-refresh.md");
-    await fs_extra_1.default.copy(paths.templateSkillDir, skillTargetDir, { overwrite: true });
-    const commandTemplate = await (0, utils_1.readText)(paths.templateCommandPath);
-    await (0, utils_1.writeText)(commandTargetPath, commandTemplate);
-    const agentTemplate = await (0, utils_1.readJsonFile)(paths.templateAgentPath, {});
-    const agentConfig = await (0, utils_1.readJsonFile)(paths.agentConfigPath, {});
-    const agents = (agentConfig.agents || {});
-    const templateAgents = (agentTemplate.agents || agentTemplate);
-    agentConfig.agents = { ...agents, ...templateAgents };
-    await (0, utils_1.writeJsonFile)(paths.agentConfigPath, agentConfig);
-    await (0, utils_1.writeJsonFile)(paths.versionFilePath, { version: utils_1.PACKAGE_VERSION, installedAt: new Date().toISOString() });
-    const state = await (0, utils_1.getInstallationState)(paths);
-    if (!state.skillInstalled || !state.commandInstalled || !state.agentInstalled) {
-        throw new Error("Installation verification failed. Some files were not installed.");
-    }
-    if (Object.keys(agentConfig).length > 0 && Object.prototype.hasOwnProperty.call(agentConfig, utils_1.AGENT_ID)) {
-        console.log(chalk_1.default.yellow("agent-skill-manager agent already existed; configuration was updated."));
-    }
-    console.log(chalk_1.default.green("Agent skill manager installed successfully."));
-}

package/dist/remove.d.ts

@@ -1 +0,0 @@
-export declare function remove(): Promise<void>;

package/dist/remove.js

@@ -1,32 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.remove = remove;
-const path_1 = __importDefault(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const utils_1 = require("./utils");
-async function remove() {
-    const paths = await (0, utils_1.detectOpenCodePaths)();
-    const skillTargetDir = path_1.default.join(paths.skillsDir, utils_1.SKILL_DIR_NAME);
-    const commandTargetPath = path_1.default.join(paths.commandDir, "agent-skill-refresh.md");
-    if (await fs_extra_1.default.pathExists(skillTargetDir)) {
-        await fs_extra_1.default.remove(skillTargetDir);
-    }
-    if (await fs_extra_1.default.pathExists(commandTargetPath)) {
-        await fs_extra_1.default.remove(commandTargetPath);
-    }
-    const agentConfig = await (0, utils_1.readJsonFile)(paths.agentConfigPath, {});
-    const agents = (agentConfig.agents || {});
-    if (Object.prototype.hasOwnProperty.call(agents, utils_1.AGENT_ID)) {
-        delete agents[utils_1.AGENT_ID];
-        agentConfig.agents = agents;
-        await (0, utils_1.writeJsonFile)(paths.agentConfigPath, agentConfig);
-    }
-    if (await fs_extra_1.default.pathExists(paths.versionFilePath)) {
-        await fs_extra_1.default.remove(paths.versionFilePath);
-    }
-    console.log(chalk_1.default.green("Agent skill manager removed successfully."));
-}

package/dist/update.d.ts

@@ -1 +0,0 @@
-export declare function update(): Promise<void>;

package/dist/update.js

@@ -1,53 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.update = update;
-const path_1 = __importDefault(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const utils_1 = require("./utils");
-async function update() {
-    const paths = await (0, utils_1.detectOpenCodePaths)();
-    await (0, utils_1.ensureDirExists)(paths.commandDir);
-    await (0, utils_1.ensureDirExists)(paths.skillsDir);
-    const skillTargetDir = path_1.default.join(paths.skillsDir, utils_1.SKILL_DIR_NAME);
-    const commandTargetPath = path_1.default.join(paths.commandDir, "agent-skill-refresh.md");
-    await (0, utils_1.ensureDirExists)(skillTargetDir);
-    const state = await (0, utils_1.getInstallationState)(paths);
-    if (state.installedVersion === utils_1.PACKAGE_VERSION) {
-        console.log(chalk_1.default.green("Agent skill manager is already up to date."));
-        return;
-    }
-    const [skillCustomized, commandCustomized] = await Promise.all([
-        (0, utils_1.directoryDiffersFromTemplate)(skillTargetDir, paths.templateSkillDir),
-        (0, utils_1.fileDiffersFromTemplate)(commandTargetPath, paths.templateCommandPath),
-    ]);
-    if (skillCustomized || commandCustomized) {
-        console.log(chalk_1.default.yellow("Detected customized files. Backups will be created before update."));
-    }
-    if (await fs_extra_1.default.pathExists(skillTargetDir)) {
-        console.log(chalk_1.default.yellow("Backing up existing skill directory before update."));
-        const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-        const backupDir = `${skillTargetDir}.backup-${timestamp}.bak`;
-        await fs_extra_1.default.copy(skillTargetDir, backupDir, { overwrite: true });
-    }
-    if (await fs_extra_1.default.pathExists(commandTargetPath)) {
-        await (0, utils_1.backupFile)(commandTargetPath, "backup");
-    }
-    if (await fs_extra_1.default.pathExists(paths.agentConfigPath)) {
-        await (0, utils_1.backupFile)(paths.agentConfigPath, "backup");
-    }
-    await fs_extra_1.default.copy(paths.templateSkillDir, skillTargetDir, { overwrite: true });
-    const commandTemplate = await fs_extra_1.default.readFile(paths.templateCommandPath, "utf8");
-    await fs_extra_1.default.writeFile(commandTargetPath, commandTemplate, "utf8");
-    const agentTemplate = await (0, utils_1.readJsonFile)(paths.templateAgentPath, {});
-    const agentConfig = await (0, utils_1.readJsonFile)(paths.agentConfigPath, {});
-    const agents = (agentConfig.agents || {});
-    const templateAgents = (agentTemplate.agents || agentTemplate);
-    agentConfig.agents = { ...agents, ...templateAgents };
-    await (0, utils_1.writeJsonFile)(paths.agentConfigPath, agentConfig);
-    await (0, utils_1.writeJsonFile)(paths.versionFilePath, { version: utils_1.PACKAGE_VERSION, updatedAt: new Date().toISOString() });
-    console.log(chalk_1.default.green("Agent skill manager updated successfully."));
-}