Agent Skill Manager (ASM)
This is your primary hub for managing, auditing, and expanding your own functional capabilities. Whenever you or the user needs to know what tools are installed or want to add/remove a "skill", use this tool.
IMPORTANT: All scripts support non-interactive (CLI argument) mode. You MUST always use CLI arguments (--scope, --agents, --yes, etc.) to avoid TUI prompts, since not all agents can display interactive menus.
🛠️ Capabilities
1. 🔍 Find Skills
Usage: Discover capabilities you don't have.
Constraint: ONLY list results. Do NOT install anything unless explicitly ordered by the user.
npx skills find <search_query>
2. ⬇️ Install Skill
Usage: Install a skill explicitly requested by the user from any source (Registry name, Git URL, or Local Path).
Constraint: You MUST use the following script. NEVER use npx skills add directly.
python3 <path_to_skill_manager>/scripts/install_skill.py <skill_source> --scope <global|project> --agents <ids|all> --yes
| Argument |
Required |
Description |
<skill_source> |
Yes |
Git URL, local path, or registry name |
--scope <global|project> |
Yes |
Installation scope. Ask user if unclear. |
-a, --agents <ids|all> |
Optional |
Comma-separated agent IDs or all. Omit to skip syncing. |
--yes, -y |
Recommended |
Auto-confirm overwrites |
-s, --skills <names|all> |
For multi-skill repos |
Comma-separated skill subdirectory names or all |
--all |
Optional |
Shortcut for --skills all --agents all --yes |
3. 📋 List & Check Skills
Usage: List all installed skills, check current capabilities, and verify sync status.
python3 <path_to_skill_manager>/scripts/list_skills.py --brief
| Argument |
Required |
Description |
--brief |
Recommended |
One line per skill (compact output for agents with limited display) |
--scope <global|project> |
Optional |
Filter by scope |
4. 🔄 Sync Skill
Usage: Fix missing tools or sync to a new agent environment.
python3 <path_to_skill_manager>/scripts/sync_skill.py <skill_name> --scope <global|project> --agents <ids|all>
| Argument |
Required |
Description |
<skill_name> |
Yes |
Name of the installed skill |
--scope <global|project> |
Optional |
Scope (auto-detected if omitted) |
--agents <ids|all> |
Yes |
Comma-separated agent IDs or all. Ask user which agents to sync to. |
5. 🆙 Update Skills
Usage: Update installed skills to latest versions.
python3 <path_to_skill_manager>/scripts/update_skills.py --all --scope <global|project>
| Argument |
Required |
Description |
--all |
Yes |
Update all Git-based skills without prompting |
--scope <global|project> |
Yes |
Target scope |
--npx |
Optional |
Also run npx skills update |
<skill_names...> |
Alternative to --all |
Specific skill names to update |
6. 🗑️ Uninstall Skill
Usage: Remove a skill and clean up configurations.
python3 <path_to_skill_manager>/scripts/uninstall_skill.py <skill_name> --scope <global|project> --all-locations
| Argument |
Required |
Description |
<skill_name> |
Yes |
Name of the skill to uninstall |
--scope <global|project> |
Yes |
Target scope. Ask user if unclear. |
--all-locations |
Recommended |
Remove from all detected locations |
🧠 Agent Protocol
- Non-Interactive Mode Only: You MUST always use CLI arguments to run scripts non-interactively. NEVER run scripts without arguments expecting TUI menus. Extract required parameters (
scope, skill_name, etc.) from the user's message. If a required parameter cannot be determined, ask the user for clarification before executing.
- Strictly Non-Autonomous Installation: After running
npx skills find, you must show the list to the user and wait. Proactive installation is strictly forbidden.
- No Direct NPX Calls: You MUST NOT call
npx skills add or npx skills remove directly. Use the provided Python scripts (install_skill.py, uninstall_skill.py) for these actions.
- Parameter Extraction: When the user says "install X globally", extract
scope=global. When the user says "uninstall Y", extract skill_name=Y and ask for scope if ambiguous.
- Agent Confirmation for
--agents: Do NOT blindly use --agents all. Ask the user which agents/platforms to sync to. You can run list_skills.py --brief first to see available platforms, then present the options. If the user says "install to all", then use --agents all. Valid --agents IDs (from skills.sh):
adal, amp, antigravity, augment, claude-code, cline, codebuddy, codex, command-code, continue, cortex, crush, cursor, droid, gemini-cli, github-copilot, goose, iflow-cli, junie, kilo, kimi-cli, kiro-cli, kode, mcpjam, mistral-vibe, mux, neovate, openclaw, opencode, openhands, pi, pochi, qoder, qwen-code, replit, roo, trae, trae-cn, windsurf, zencoder
- Verification: Always use
python3 <path_to_skill_manager>/scripts/list_skills.py to confirm the current state before making suggestions.
- Context Awareness: You MUST execute these scripts from the User's Current Working Directory (Project Root). Do NOT
cd into the scripts/ folder or the skill-manager repository.
- Path Resolution: The
skill-manager might be installed Globally (~/.agents/skills/skill-manager) or Locally in the project (.agents/skills/skill-manager). You must detect where it is installed and execute the scripts using that path. Do not assume it is always global.
- Example (Global):
python3 ~/.agents/skills/skill-manager/scripts/install_skill.py
- Example (Project):
python3 .agents/skills/skill-manager/scripts/install_skill.py
- GitHub Pre-Check Protocol: When installing from a GitHub URL,
install_skill.py will automatically analyze the repo structure after cloning:
- Root
SKILL.md found: Proceeds with normal installation (pure skill repo).
- Sub-directory
SKILL.md(s) found: Use --skills all or --skills name1,name2 to select. Review the output and assist the user.
- No
SKILL.md found: The script will print the repo's README content. You MUST carefully read this output, understand the repo's installation instructions, and then guide the user accordingly. Use --yes to force-install only if the user explicitly confirms.
1---2name: skill-manager3description: Agent Skill Manager (ASM)4---56# Agent Skill Manager (ASM)78This is your **primary hub** for managing, auditing, and expanding your own functional capabilities. Whenever you or the user needs to know what tools are installed or want to add/remove a "skill", use this tool.910> **IMPORTANT**: All scripts support **non-interactive (CLI argument) mode**. You **MUST** always use CLI arguments (`--scope`, `--agents`, `--yes`, etc.) to avoid TUI prompts, since not all agents can display interactive menus.1112## 🛠️ Capabilities1314### 1. 🔍 Find Skills15**Usage**: Discover capabilities you don't have.16**Constraint**: **ONLY** list results. Do **NOT** install anything unless explicitly ordered by the user.17```bash18npx skills find <search_query>19```2021### 2. ⬇️ Install Skill22**Usage**: Install a skill explicitly requested by the user from any source (Registry name, Git URL, or Local Path).23**Constraint**: You **MUST** use the following script. **NEVER** use `npx skills add` directly.2425```bash26python3 <path_to_skill_manager>/scripts/install_skill.py <skill_source> --scope <global|project> --agents <ids|all> --yes27```28| Argument | Required | Description |29| --------------------------- | --------------------- | ------------------------------------------------------------- |30| `<skill_source>` | Yes | Git URL, local path, or registry name |31| `--scope <global\|project>` | Yes | Installation scope. Ask user if unclear. |32| `-a, --agents <ids\|all>` | Optional | Comma-separated agent IDs or `all`. **Omit to skip syncing**. |33| `--yes, -y` | Recommended | Auto-confirm overwrites |34| `-s, --skills <names\|all>` | For multi-skill repos | Comma-separated skill subdirectory names or `all` |35| `--all` | Optional | Shortcut for `--skills all --agents all --yes` |3637### 3. 📋 List & Check Skills38**Usage**: List all installed skills, check current capabilities, and verify sync status.39```bash40python3 <path_to_skill_manager>/scripts/list_skills.py --brief41```42| Argument | Required | Description |43| --------------------------- | ----------- | ------------------------------------------------------------------- |44| `--brief` | Recommended | One line per skill (compact output for agents with limited display) |45| `--scope <global\|project>` | Optional | Filter by scope |4647### 4. 🔄 Sync Skill48**Usage**: Fix missing tools or sync to a new agent environment.49```bash50python3 <path_to_skill_manager>/scripts/sync_skill.py <skill_name> --scope <global|project> --agents <ids|all>51```52| Argument | Required | Description |53| --------------------------- | -------- | ------------------------------------------------------------------------- |54| `<skill_name>` | Yes | Name of the installed skill |55| `--scope <global\|project>` | Optional | Scope (auto-detected if omitted) |56| `--agents <ids\|all>` | Yes | Comma-separated agent IDs or `all`. **Ask user** which agents to sync to. |5758### 5. 🆙 Update Skills59**Usage**: Update installed skills to latest versions.60```bash61python3 <path_to_skill_manager>/scripts/update_skills.py --all --scope <global|project>62```63| Argument | Required | Description |64| --------------------------- | ---------------------- | --------------------------------------------- |65| `--all` | Yes | Update all Git-based skills without prompting |66| `--scope <global\|project>` | Yes | Target scope |67| `--npx` | Optional | Also run `npx skills update` |68| `<skill_names...>` | Alternative to `--all` | Specific skill names to update |6970### 6. 🗑️ Uninstall Skill71**Usage**: Remove a skill and clean up configurations.72```bash73python3 <path_to_skill_manager>/scripts/uninstall_skill.py <skill_name> --scope <global|project> --all-locations74```75| Argument | Required | Description |76| --------------------------- | ----------- | ---------------------------------- |77| `<skill_name>` | Yes | Name of the skill to uninstall |78| `--scope <global\|project>` | Yes | Target scope. Ask user if unclear. |79| `--all-locations` | Recommended | Remove from all detected locations |8081## 🧠 Agent Protocol82831. **Non-Interactive Mode Only**: You **MUST** always use CLI arguments to run scripts non-interactively. **NEVER** run scripts without arguments expecting TUI menus. Extract required parameters (`scope`, `skill_name`, etc.) from the user's message. If a required parameter **cannot be determined**, ask the user for clarification before executing.842. **Strictly Non-Autonomous Installation**: After running `npx skills find`, you must show the list to the user and wait. **Proactive installation is strictly forbidden.**853. **No Direct NPX Calls**: You **MUST NOT** call `npx skills add` or `npx skills remove` directly. Use the provided Python scripts (`install_skill.py`, `uninstall_skill.py`) for these actions.864. **Parameter Extraction**: When the user says "install X globally", extract `scope=global`. When the user says "uninstall Y", extract `skill_name=Y` and ask for scope if ambiguous.875. **Agent Confirmation for `--agents`**: Do **NOT** blindly use `--agents all`. Ask the user which agents/platforms to sync to. You can run `list_skills.py --brief` first to see available platforms, then present the options. If the user says "install to all", then use `--agents all`. Valid `--agents` IDs (from [skills.sh](https://skills.sh)):88 `adal`, `amp`, `antigravity`, `augment`, `claude-code`, `cline`, `codebuddy`, `codex`, `command-code`, `continue`, `cortex`, `crush`, `cursor`, `droid`, `gemini-cli`, `github-copilot`, `goose`, `iflow-cli`, `junie`, `kilo`, `kimi-cli`, `kiro-cli`, `kode`, `mcpjam`, `mistral-vibe`, `mux`, `neovate`, `openclaw`, `opencode`, `openhands`, `pi`, `pochi`, `qoder`, `qwen-code`, `replit`, `roo`, `trae`, `trae-cn`, `windsurf`, `zencoder`896. **Verification**: Always use `python3 <path_to_skill_manager>/scripts/list_skills.py` to confirm the current state before making suggestions.907. **Context Awareness**: You **MUST** execute these scripts from the **User's Current Working Directory (Project Root)**. Do **NOT** `cd` into the `scripts/` folder or the `skill-manager` repository.918. **Path Resolution**: The `skill-manager` might be installed Globally (`~/.agents/skills/skill-manager`) or Locally in the project (`.agents/skills/skill-manager`). You must **detect** where it is installed and execute the scripts using that path. Do not assume it is always global.92 * Example (Global): `python3 ~/.agents/skills/skill-manager/scripts/install_skill.py`93 * Example (Project): `python3 .agents/skills/skill-manager/scripts/install_skill.py`949. **GitHub Pre-Check Protocol**: When installing from a GitHub URL, `install_skill.py` will automatically analyze the repo structure after cloning:95 * **Root `SKILL.md` found**: Proceeds with normal installation (pure skill repo).96 * **Sub-directory `SKILL.md`(s) found**: Use `--skills all` or `--skills name1,name2` to select. Review the output and assist the user.97 * **No `SKILL.md` found**: The script will print the repo's **README** content. You **MUST carefully read** this output, understand the repo's installation instructions, and then guide the user accordingly. Use `--yes` to force-install only if the user explicitly confirms.98
pityfish