agent-skill-manager 2.14.0 → 2.15.0

package/README.md

@@ -9,10 +9,10 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/agent-skill-manager"><img src="https://img.shields.io/npm/v/agent-skill-manager.svg" alt="npm version" /></a>
   <a href="https://www.npmjs.com/package/agent-skill-manager"><img src="https://img.shields.io/npm/dm/agent-skill-manager.svg" alt="npm downloads" /></a>
-  <a href="https://github.com/luongnv89/agent-skill-manager/stargazers"><img src="https://img.shields.io/github/stars/luongnv89/agent-skill-manager.svg?style=social" alt="GitHub stars" /></a>
+  <a href="https://github.com/luongnv89/asm/stargazers"><img src="https://img.shields.io/github/stars/luongnv89/asm.svg?style=social" alt="GitHub stars" /></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT License" /></a>
-  <a href="https://github.com/luongnv89/agent-skill-manager/actions"><img src="https://github.com/luongnv89/agent-skill-manager/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-%E2%89%A5%2018-339933.svg" alt="Node.js" /></a>
+  <a href="https://github.com/luongnv89/asm/actions"><img src="https://github.com/luongnv89/asm/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-%E2%89%A5%2022-339933.svg" alt="Node.js" /></a>
 </p>
 
 # CLI to install and manage agent skills
@@ -23,13 +23,15 @@
 
 ## Problems `asm` solves
 
-| Pain                    | Without `asm`                                                                                                           | With `asm`                                                                 |
-| ----------------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
-| Scattered installs      | Same skill copied into `~/.claude/skills/`, `~/.codex/skills/`, `~/.cursor/rules/` — different versions, no single view | One `asm list` across all 19 providers and scopes                          |
-| No inventory            | `ls` through hidden dirs; no idea what is installed, duplicated, or outdated                                            | `asm search`, `asm inspect`, `asm stats`, `asm audit`                      |
-| Risky manual installs   | Clone repos, copy folders, hope `SKILL.md` is valid                                                                     | `asm install` validates frontmatter, scans security, pins registry commits |
-| Agent-unfriendly output | Human-only copy-paste workflows                                                                                         | Structured JSON via `--json`; skip prompts with `--yes`                    |
-| New agent, new chore    | Every tool adds another skill directory to track                                                                        | Add or disable providers in one config file                                |
+| Pain                      | Without `asm`                                                                                                           | With `asm`                                                                 |
+| ------------------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| Scattered installs        | Same skill copied into `~/.claude/skills/`, `~/.codex/skills/`, `~/.cursor/rules/` — different versions, no single view | One `asm list` across all 19 providers and scopes                          |
+| No inventory              | `ls` through hidden dirs; no idea what is installed, duplicated, or outdated                                            | `asm search`, `asm inspect`, `asm stats`, `asm audit`                      |
+| Invisible context cost    | Every installed skill's description is resident in the agent's prompt on every message, whether or not it ever fires    | `asm stats --tokens`, `asm audit residency`                                |
+| Install just to read once | Installing is the only way to get a skill in front of an agent — and it stays resident forever afterwards               | `asm get <skill>` prints the body and installs nothing                     |
+| Risky manual installs     | Clone repos, copy folders, hope `SKILL.md` is valid                                                                     | `asm install` validates frontmatter, scans security, pins registry commits |
+| Agent-unfriendly output   | Human-only copy-paste workflows                                                                                         | Structured JSON via `--json`; skip prompts with `--yes`                    |
+| New agent, new chore      | Every tool adds another skill directory to track                                                                        | Add or disable providers in one config file                                |
 
 ## At a glance
 
@@ -58,19 +60,29 @@ graph LR
 2. Run commands from your agent, shell, or CI — no prompts when you pass `--yes`.
 3. Parse JSON output to decide what to install, remove, or audit next.
 
+## Screenshots
+
+<p align="center">
+  <img src="assets/screenshots/tui.png" alt="asm TUI — browsing installed skills across providers" width="800" />
+  <br/><em>The optional TUI (<code>asm</code> with no args) — filter, inspect, and audit skills across every provider from one dashboard.</em>
+</p>
+
 ## Features
 
-| Feature                  | What you get                                                        |
-| ------------------------ | ------------------------------------------------------------------- |
-| Cross-provider inventory | `asm list --json` — every skill, every agent, one response          |
-| One-command install      | `asm install github:user/repo` or `asm install skill-name`          |
-| Agent-parseable output   | `--json` on list, search, inspect, install, audit                   |
-| Duplicate audit          | `asm audit --yes` removes redundant skills non-interactively        |
-| Security scan            | `asm audit security` before install                                 |
-| Authoring pipeline       | `asm init`, `asm link`, `asm eval`, `asm publish`                   |
-| Bundles                  | `asm bundle install` — curated sets in one pass                     |
-| Local library            | `asm install --library` — install once, `asm activate` per provider |
-| Cross-tool linking       | Reinstall or symlink when a skill already exists in another tool    |
+| Feature                  | What you get                                                         |
+| ------------------------ | -------------------------------------------------------------------- |
+| Cross-provider inventory | `asm list --json` — every skill, every agent, one response           |
+| One-command install      | `asm install github:user/repo` or `asm install skill-name`           |
+| Agent-parseable output   | `--json` on list, search, inspect, install, audit                    |
+| Duplicate audit          | `asm audit --yes` removes redundant skills non-interactively         |
+| Attention budget         | `asm stats --tokens` shows resident vs body token cost per tool      |
+| Residency audit          | `asm audit residency` ranks skills to demote out of resident context |
+| Reference tier           | `asm get <skill>` delivers a body once, at zero residency            |
+| Security scan            | `asm audit security` before install                                  |
+| Authoring pipeline       | `asm init`, `asm link`, `asm eval`, `asm publish`                    |
+| Bundles                  | `asm bundle install` — curated sets in one pass                      |
+| Local library            | `asm install --library` — install once, `asm activate` per provider  |
+| Cross-tool linking       | Reinstall or symlink when a skill already exists in another tool     |
 
 ## Getting started
 
@@ -98,26 +110,163 @@ Search installed and catalog skills:
 asm search "code review" --json
 ```
 
-Alternative install: `curl -sSL https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh | bash`
+Alternative install: `curl -sSL https://raw.githubusercontent.com/luongnv89/asm/main/install.sh | bash`
 
-Node.js 18+ required. Optional TUI: run `asm` with no arguments.
+Node.js 22+ required. Optional TUI: run `asm` with no arguments.
 
 ## Common tasks
 
-| Task                       | Command                                          |
-| -------------------------- | ------------------------------------------------ |
-| Machine-readable inventory | `asm list --json`                                |
-| Skill metadata for agents  | `asm inspect my-skill --json`                    |
-| Non-interactive install    | `asm install code-review -p claude --yes --json` |
-| Remove duplicates          | `asm audit --yes`                                |
-| Scan before install        | `asm audit security github:user/repo`            |
-| Scaffold a new skill       | `asm init my-skill -p claude`                    |
-| Live dev via symlink       | `asm link ./my-skill -p claude`                  |
-| Publish to registry        | `asm publish ./my-skill --yes`                   |
-| Install a bundle           | `asm bundle install frontend-dev --yes`          |
+| Task                          | Command                                          |
+| ----------------------------- | ------------------------------------------------ |
+| Machine-readable inventory    | `asm list --json`                                |
+| Skill metadata for agents     | `asm inspect my-skill --json`                    |
+| Non-interactive install       | `asm install code-review -p claude --yes --json` |
+| Remove duplicates             | `asm audit --yes`                                |
+| See your context cost         | `asm stats --tokens`                             |
+| Find skills to demote         | `asm audit residency`                            |
+| Use a skill without residency | `asm get code-review`                            |
+| Scan before install           | `asm audit security github:user/repo`            |
+| Scaffold a new skill          | `asm init my-skill -p claude`                    |
+| Live dev via symlink          | `asm link ./my-skill -p claude`                  |
+| Publish to registry           | `asm publish ./my-skill --yes`                   |
+| Install a bundle              | `asm bundle install frontend-dev --yes`          |
 
 Full command reference, flags, and examples: [CLI Commands](#cli-commands). Catalog UI and bundles: [luongnv.com/asm](https://luongnv.com/asm/).
 
+## Attention budget
+
+Disk is cheap; context is not. Every installed skill's frontmatter
+`description` sits in the agent's system prompt on **every message**, whether or
+not the skill ever fires. The full `SKILL.md` body only costs anything when the
+skill actually fires.
+
+`asm` reports the two separately — token counts are estimates and always render
+with a leading `~`:
+
+```bash
+asm stats --tokens            # resident vs body tokens, per tool and per scope
+asm stats --tokens --json     # same data for scripts and agents
+```
+
+```text
+  Attention Budget
+  ----------------------------------------
+
+  Resident = frontmatter descriptions, paid on every message.
+  Bodies   = full SKILL.md, paid only when a skill fires.
+
+  Tool         Skills      Resident  Bodies
+  Claude Code      74    ~5k tokens  ~281k tokens
+  Codex            10   ~736 tokens  ~76k tokens
+  ---------------------------------------------
+  Total            84  ~5.7k tokens  ~357k tokens
+
+  By Scope
+  global           71  ~4.9k tokens  ~300k tokens
+  project          13   ~836 tokens  ~57k tokens
+
+  Heaviest resident descriptions
+    claude-api       ~1.2k tokens  (claude, global)
+    docx              ~233 tokens  (claude, global)
+    pptx              ~217 tokens  (claude, global)
+    code-review       ~198 tokens  (claude, global)
+    frontend-design   ~176 tokens  (claude, project)
+    dataviz           ~164 tokens  (claude, global)
+    skill-creator     ~151 tokens  (claude, global)
+    xlsx              ~143 tokens  (claude, global)
+    pdf               ~138 tokens  (claude, global)
+    release-manager   ~129 tokens  (codex, global)
+
+  Median resident cost: ~48 tokens
+  Run asm audit residency for demotion advice
+```
+
+### Residency audit
+
+`asm audit residency` ranks the installed skills that are not earning their
+resident context and pairs each one with a command that works for how that
+skill is actually installed. It only reports — nothing is deactivated,
+disabled, or removed unless you run one of the suggested commands yourself.
+
+```bash
+asm audit residency
+asm audit residency --json
+```
+
+The advice assumes this demotion ladder:
+
+| Tier                      | `asm` mechanism                           | Residency                    |
+| ------------------------- | ----------------------------------------- | ---------------------------- |
+| Installed (auto-triggers) | provider directory / `asm activate`       | description resident, always |
+| Saved (adapt, no trigger) | `asm install --library`, `asm deactivate` | none until `asm activate`    |
+| Disabled (kept on disk)   | `asm disable` (reverse with `asm enable`) | none                         |
+| Reference (read on use)   | `asm get` — nothing on disk at all        | none                         |
+
+Which command a candidate gets depends on how it is installed. `asm deactivate`
+only works on a live symlink into the `asm` library, so it is suggested only
+there; everything else gets `asm disable`, which is universal and reversible.
+The `asm deactivate` path additionally gets `asm get <skill>` as a second
+destination: deactivating removes the provider symlink but leaves the library
+copy, so the body is still one command away. The `asm disable` path does not,
+because disabling renames the canonical `SKILL.md` — for a library-linked skill
+that is the library copy itself — leaving nothing for `asm get` to read.
+Skills provided by plugin marketplaces are counted in the totals but never
+listed as candidates — no `asm` command demotes them.
+
+Two of the signals the report would like to use — trigger collision and
+last-used counts — have no data source in `asm` yet. They are listed as
+unavailable rather than silently dropped, so the report still works today.
+
+No network calls, accounts, or telemetry are involved: both reports run
+entirely against your local filesystem.
+
+### Reference tier: use a skill without installing it
+
+Demoting a skill does not mean losing it. `asm get <skill>` resolves a skill and
+writes its `SKILL.md` body to **stdout** — no provider directory, no library
+entry, no residency. The skill is paid for once, at the point of use, and costs
+nothing afterwards.
+
+```bash
+asm get code-review                       # body to stdout
+asm get code-review > /tmp/SKILL.md       # save it without installing
+asm get github:owner/repo:skills/review   # any `asm install` shorthand
+asm get code-review --json                # name, description, tier, source, tokenCount, security, content
+```
+
+That makes `asm` usable as delivery infrastructure, not only as an installer.
+An agent can pull a skill in for a single task and drop it again:
+
+```bash
+asm get code-review | your-agent --system-prompt-file -
+```
+
+`<skill>` walks a resolution ladder, and the rung that answered is reported as
+the `tier` so provenance is always visible:
+
+| Order | Tier        | Resolves                                              |
+| ----- | ----------- | ----------------------------------------------------- |
+| 1     | `installed` | a skill already installed in one of your agents       |
+| 2     | `library`   | a library skill, **including deactivated ones**       |
+| 3     | `index`     | an indexed catalog skill, matched by exact name       |
+| 4     | `registry`  | the ASM registry — same route as `asm install <name>` |
+
+An explicit `github:owner/repo[#ref][:path]` shorthand, a GitHub URL, or a local
+path skips the ladder. A name that matches more than one indexed repo or
+registry author is never guessed: `asm get` exits non-zero and lists the
+qualified candidates.
+
+The catalog stores metadata, not bodies, so an `index`, `registry` or remote
+`asm get` costs a shallow clone into a temp directory, which is deleted before
+the command returns. Those fetches run the **same pre-install security scan
+`asm install` runs**; the verdict goes to stderr and into `--json` under
+`security`. It reports rather than blocks — `asm get` writes nothing — and
+`--audit` prints the full `asm audit security` report for the fetched skill.
+
+Output discipline: stdout carries the body (or, with `--json`, a single JSON
+object) and nothing else, so piping and redirecting are safe. Provenance,
+progress, and the security verdict go to stderr.
+
 ## FAQ
 
 **Is it free?**
@@ -399,43 +548,54 @@ Multiple `asm` binaries on `PATH` can shadow a fresh upgrade.
 
 ### Commands
 
-| Command                         | Description                          |
-| ------------------------------- | ------------------------------------ | ----------------------------------------- |
-| `asm list`                      | List all discovered skills           |
-| `asm search <query>`            | Search by name/description/provider  |
-| `asm inspect <skill-name>`      | Show detailed info for a skill       |
-| `asm install <source>`          | Install from GitHub or registry      |
-| `asm publish [path]`            | Publish to ASM Registry              |
-| `asm uninstall <skill-name>`    | Remove a skill                       |
-| `asm init <name>`               | Scaffold a new skill                 |
-| `asm link <path> [<path2> ...]` | Symlink skills for live dev          |
-| `asm audit`                     | Detect duplicate skills              |
-| `asm audit security <name>`     | Security audit                       |
-| `asm eval <skill>`              | Score skill quality                  |
-| `asm eval-providers list`       | List eval providers                  |
-| `asm stats`                     | Aggregate installed skill metrics    |
-| `asm stats repo <repo>`         | Per-repo indexed skill stats         |
-| `asm stats author <owner>`      | Per-author indexed skill stats       |
-| `asm stats index`               | Indexed catalog stats summary        |
-| `asm activate <skill>`          | Link a library skill into a provider |
-| `asm deactivate <skill>`        | Remove a library activation symlink  |
-| `asm library list               | update`                              | Manage centrally installed library skills |
-| `asm export`                    | Export inventory as JSON             |
-| `asm index ingest <repo>`       | Index a skill repo                   |
-| `asm index search <query>`      | Search indexed skills                |
-| `asm index list`                | List indexed repos                   |
-| `asm index remove <owner/repo>` | Remove repo from index               |
-| `asm bundle list`               | List bundles (`--predefined`)        |
-| `asm bundle install <name>`     | Install every skill in a bundle      |
-| `asm bundle create <name>`      | Create bundle from installed skills  |
-| `asm bundle show <name>`        | Show bundle details                  |
-| `asm bundle modify <name>`      | Add/remove skills                    |
-| `asm bundle export <name>`      | Export bundle to JSON                |
-| `asm bundle remove <name>`      | Remove saved bundle                  |
-| `asm config show`               | Print config                         |
-| `asm config path`               | Print config path                    |
-| `asm config reset`              | Reset to defaults                    |
-| `asm config edit`               | Open config in `$EDITOR`             |
+| Command | Description |
+| ------------------------------- | ----------------------------------------- | ----------------------------------------- |
+| `asm list` | List all discovered skills |
+| `asm search <query>` | Search by name/description/provider |
+| `asm inspect <skill-name>` | Show detailed info for a skill |
+| `asm get <skill>` | Print a skill's body, install nothing |
+| `asm install <source>` | Install from GitHub or registry |
+| `asm publish [path]` | Publish to ASM Registry |
+| `asm uninstall <skill-name>` | Remove a skill |
+| `asm init <name>` | Scaffold a new skill |
+| `asm link <path> [<path2> ...]` | Symlink skills for live dev |
+| `asm audit` | Detect duplicate skills |
+| `asm audit security <name>` | Security audit |
+| `asm audit residency` | Rank skills that do not earn residency |
+| `asm eval <skill>` | Score skill quality |
+| `asm eval-providers list` | List eval providers |
+| `asm stats` | Aggregate installed skill metrics |
+| `asm stats repo <repo>` | Per-repo indexed skill stats |
+| `asm stats author <owner>` | Per-author indexed skill stats |
+| `asm stats index` | Indexed catalog stats summary |
+| `asm activate <skill>` | Link a library skill into a provider |
+| `asm deactivate <skill>` | Remove a library activation symlink |
+| `asm library` | Manage centrally installed library skills |
+| `asm library list` | List local library skills |
+| `asm library update <skill>` | Update one local library skill |
+| `asm library update --all` | Update all local library skills |
+| `asm export` | Export inventory as JSON |
+| `asm import <file>` | Import skills from exported manifest |
+| `asm outdated` | Show outdated skills |
+| `asm update [name...]` | Update outdated skills |
+| `asm disable <target>` | Disable skill(s) without uninstalling |
+| `asm enable <target>` | Re-enable disabled skill(s) |
+| `asm index ingest <repo>` | Index a skill repo |
+| `asm index search <query>` | Search indexed skills |
+| `asm index list` | List indexed repos |
+| `asm index remove <owner/repo>` | Remove repo from index |
+| `asm bundle list` | List bundles (`--predefined`) |
+| `asm bundle install <name>` | Install every skill in a bundle |
+| `asm bundle create <name>` | Create bundle from installed skills |
+| `asm bundle show <name>` | Show bundle details |
+| `asm bundle modify <name>` | Add/remove skills |
+| `asm bundle export <name>` | Export bundle to JSON |
+| `asm bundle remove <name>` | Remove saved bundle |
+| `asm config show` | Print config |
+| `asm config path` | Print config path |
+| `asm config reset` | Reset to defaults |
+| `asm config edit` | Open config in `$EDITOR` |
+| `asm doctor` | Run environment health checks and diagnostics |
 
 ### Global options
 
@@ -443,10 +603,16 @@ Multiple `asm` binaries on `PATH` can shadow a fresh upgrade.
 -h, --help             Show help
 -v, --version          Print version
 --json                 JSON output
+--machine              Stable machine-readable JSON envelope (v1)
 -s, --scope <scope>    global, project, or both
+-p, --tool <name>      Filter by tool (list, search)
 --sort <field>         name, version, or location
+--flat                 Show one row per tool instance (list, search)
+--model-invocable      Only skills the model can invoke
+--user-invocable       Only skills the user can invoke
 -y, --yes              Skip confirmations
 --no-color             Disable ANSI colors
+-V, --verbose          Show debug output
 ```
 
 ### Examples
@@ -463,6 +629,12 @@ asm list --summary
 asm list --compact --group-by tool --limit 20
 ```
 
+```bash
+asm list --model-invocable --user-invocable
+```
+
+Listings and `asm inspect` show invocability as `model`, `user`, or `both` (never collapsed). `--model-invocable` and `--user-invocable` are independent; both flags keep skills that match both (typically `both`).
+
 ```bash
 asm search "code review" --json
 ```
@@ -479,6 +651,14 @@ asm audit security github:user/repo
 asm audit security --all
 ```
 
+```bash
+asm stats --tokens
+```
+
+```bash
+asm audit residency --json
+```
+
 ```bash
 asm eval ./my-skill
 ```
@@ -639,6 +819,27 @@ On first run, config is created at `~/.config/agent-skill-manager/config.json`:
       "project": ".codex/skills",
       "enabled": true
     },
+    {
+      "name": "opencode",
+      "label": "OpenCode",
+      "global": "~/.config/opencode/skills",
+      "project": ".opencode/skills",
+      "enabled": true
+    },
+    {
+      "name": "pi",
+      "label": "Pi",
+      "global": "~/.pi/skills",
+      "project": ".pi/skills",
+      "enabled": true
+    },
+    {
+      "name": "hermes",
+      "label": "Hermes",
+      "global": "~/.hermes/skills",
+      "project": ".hermes/skills",
+      "enabled": true
+    },
     {
       "name": "openclaw",
       "label": "OpenClaw",
@@ -658,91 +859,84 @@ On first run, config is created at `~/.config/agent-skill-manager/config.json`:
       "label": "Cursor",
       "global": "~/.cursor/rules",
       "project": ".cursor/rules",
-      "enabled": false
+      "enabled": true
+    },
+    {
+      "name": "copilot",
+      "label": "GitHub Copilot",
+      "global": "~/.github/instructions",
+      "project": ".github/instructions",
+      "enabled": true
     },
     {
       "name": "windsurf",
       "label": "Windsurf",
       "global": "~/.windsurf/rules",
       "project": ".windsurf/rules",
-      "enabled": false
+      "enabled": true
+    },
+    {
+      "name": "antigravity",
+      "label": "Google Antigravity",
+      "global": "~/.antigravity/skills",
+      "project": ".antigravity/skills",
+      "enabled": true
+    },
+    {
+      "name": "gemini",
+      "label": "Gemini CLI",
+      "global": "~/.gemini/skills",
+      "project": ".gemini/skills",
+      "enabled": true
     },
     {
       "name": "cline",
       "label": "Cline",
       "global": "~/Documents/Cline/Rules",
       "project": ".clinerules",
-      "enabled": false
+      "enabled": true
     },
     {
       "name": "roocode",
       "label": "Roo Code",
       "global": "~/.roo/rules",
       "project": ".roo/rules",
-      "enabled": false
+      "enabled": true
     },
     {
       "name": "continue",
       "label": "Continue",
       "global": "~/.continue/rules",
       "project": ".continue/rules",
-      "enabled": false
-    },
-    {
-      "name": "copilot",
-      "label": "GitHub Copilot",
-      "global": "~/.github/instructions",
-      "project": ".github/instructions",
-      "enabled": false
+      "enabled": true
     },
     {
       "name": "aider",
       "label": "Aider",
       "global": "~/.aider/skills",
       "project": ".aider/skills",
-      "enabled": false
-    },
-    {
-      "name": "opencode",
-      "label": "OpenCode",
-      "global": "~/.config/opencode/skills",
-      "project": ".opencode/skills",
-      "enabled": false
+      "enabled": true
     },
     {
       "name": "zed",
       "label": "Zed",
       "global": "~/.config/zed/prompt_overrides",
       "project": ".zed/rules",
-      "enabled": false
+      "enabled": true
     },
     {
       "name": "augment",
       "label": "Augment",
       "global": "~/.augment/rules",
       "project": ".augment/rules",
-      "enabled": false
+      "enabled": true
     },
     {
       "name": "amp",
       "label": "Amp",
       "global": "~/.amp/skills",
       "project": ".amp/skills",
-      "enabled": false
-    },
-    {
-      "name": "gemini",
-      "label": "Gemini CLI",
-      "global": "~/.gemini/skills",
-      "project": ".gemini/skills",
-      "enabled": false
-    },
-    {
-      "name": "antigravity",
-      "label": "Google Antigravity",
-      "global": "~/.antigravity/skills",
-      "project": ".antigravity/skills",
-      "enabled": false
+      "enabled": true
     }
   ],
   "customPaths": [],
@@ -753,9 +947,9 @@ On first run, config is created at `~/.config/agent-skill-manager/config.json`:
 }
 ```
 
-- Set `"enabled": true` to start scanning a provider
+- All 19 providers are enabled by default
+- Set `"enabled": false` to skip a provider you don't use
 - Add arbitrary directories via `customPaths`
-- Set `"enabled": false` to skip a provider
 - Manage via `asm config show|path|reset|edit` or press `c` in the TUI
 
 </details>
@@ -804,8 +998,8 @@ asm init my-skill -p claude
 <summary><strong>From source</strong></summary>
 
 ```bash
-git clone https://github.com/luongnv89/agent-skill-manager.git
-cd agent-skill-manager
+git clone https://github.com/luongnv89/asm.git
+cd asm
 npm install
 ```
 
@@ -820,7 +1014,7 @@ npm start
 Inspect install script before running:
 
 ```bash
-curl -sSL https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh -o install.sh
+curl -sSL https://raw.githubusercontent.com/luongnv89/asm/main/install.sh -o install.sh
 less install.sh
 bash install.sh
 ```
@@ -831,7 +1025,7 @@ bash install.sh
 <summary><strong>Project structure</strong></summary>
 
 ```text
-agent-skill-manager/
+asm/
 ├── bin/                       # CLI entry point
 ├── dist/                      # Built bundle (npm ships this)
 ├── scripts/                   # Build, preindex, catalog
@@ -852,7 +1046,7 @@ agent-skill-manager/
 <details>
 <summary><strong>Tech stack</strong></summary>
 
-- **Runtime:** Node.js 18+
+- **Runtime:** Node.js 22+
 - **Language:** TypeScript + TSX
 - **Build:** esbuild
 - **TUI:** [Ink](https://github.com/vadimdemedes/ink) + [@inkjs/ui](https://github.com/vadimdemedes/ink-ui)
@@ -888,10 +1082,10 @@ agent-skill-manager/
 
 ### Contributors
 
-| Contributor                                | PRs                                                                                                              |
-| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
-| [@luongnv89](https://github.com/luongnv89) | [38 merged PRs](https://github.com/luongnv89/agent-skill-manager/pulls?q=is%3Apr+is%3Amerged+author%3Aluongnv89) |
-| [@Mordris](https://github.com/Mordris)     | [#111](https://github.com/luongnv89/agent-skill-manager/pull/111)                                                |
+| Contributor                                | PRs                                                                                              |
+| ------------------------------------------ | ------------------------------------------------------------------------------------------------ |
+| [@luongnv89](https://github.com/luongnv89) | [38 merged PRs](https://github.com/luongnv89/asm/pulls?q=is%3Apr+is%3Amerged+author%3Aluongnv89) |
+| [@Mordris](https://github.com/Mordris)     | [#111](https://github.com/luongnv89/asm/pull/111)                                                |
 
 ### Dependencies