npm.io
1.0.0 • Published 2d agoCLI

@kkmila/isc

Licence
MIT
Version
1.0.0
Deps
4
Size
40 kB
Vulns
0
Weekly
0
SummaryDependencyVersions

ISC - Skill Management CLI

A command-line tool for managing skills for AI agents.

Installation

npm install -g @kkmila/isc

Usage

Add a remote git skill repository
isc add <url>
isc add <url> --name my-skill
List added skills
isc list
isc list --detail
Install skills to agent(s)
# Interactive selection (recommended) - first select agents, then skills
isc install

# Install specific skill by name
isc install "Design an Interface" --agent pi

# Install to all agents
isc install "Design an Interface" --all

Interactive flow:

  1. Select target agents (space to select, enter to confirm)
  2. Select skill repository
  3. Select skills from repository

Note: When using interactive selection, use the space bar to select/deselect items, then press Enter to confirm.

Uninstall skills from agent(s)
# Interactive selection (recommended) - first select agents, then skills
isc uninstall

# Uninstall specific skill by name
isc uninstall "Design an Interface" --agent pi

# Uninstall from all agents
isc uninstall "Design an Interface" --all

Interactive flow:

  1. Select target agents (space to select, enter to confirm)
  2. Select skills to uninstall from installed skills list

Note: Use the exact skill name as shown in isc index or isc installed. The command will also try to match partial names case-insensitively.

Remove a skill from added skills
isc remove my-skill
isc remove my-skill --force
Update skills
# Update a specific skill
isc update my-skill

# Update all skills
isc update
List skills installed to agents
isc installed
isc installed --agent pi
List available agents
isc agents
Get information about a skill
isc info my-skill
Check configuration
isc doctor
View skill index
isc index

Shows the two-level skill index structure: repositories and their contained skills.

Build skill index file
isc build-index

Generates a skill-index.json file in ~/.config/isc/ for faster access. The index is automatically cached and refreshed when needed.

设计理念：私有存储 + 受控分发

ISC 与其他技能安装工具（如 npx 方式）的核心区别在于存储策略：

ISC npx 方式
存储位置 ~/.config/isc/skills/ ~/.agents/skills/
可见性 私有目录，不会被 agent 自动发现 多数 agent 会自动扫描并加载
分发方式 isc install 显式指定目标 agent，创建 symlink 无需分发，agent 自动识别

为什么选择私有存储？

~/.agents/skills/ 被 Pi、Claude Code、Codex 等多数 agent 自动识别为技能目录——放进去的 skill 立刻对所有 agent 可见，无法选择性控制。ISC 的设计哲学是：skill 存储在私有目录，只有通过 isc install 显式安装到指定 agent 时才创建 symlink。这样你可以精确控制每个 agent 加载哪些 skill，而不是让所有 agent 一股脑加载全部 skill。

典型用法：先 isc add 把技能收进私有仓库，再用 isc install --agent pi 精准地只给 Pi 安装你需要的 skill。

Configuration

ISC stores added skills in ~/.config/isc/skills/. Each skill is a directory with a .skill-meta file containing:

  • Type (local or remote)
  • Source URL
  • Added timestamp

Agent definitions are stored in registry.yaml in the project root.

Development

# Clone the repository
git clone https://github.com/machuqiji/isc.git
cd isc

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

License

MIT

Keywords

cliskillagentmanagementinstall