Scaffold

asm init my-skill

asm init my-skill -p claude

asm init my-skill --path ./skills

Develop with live reload

asm link ./my-skill -p claude

asm link ./skill-a ./skill-b ./skill-c -p claude

asm link ./my-skills-folder -p claude

asm link ./my-skill --name my-alias -p claude --force

Audit and inspect

asm audit security my-skill

asm audit security ./path/to/my-skill

asm audit security --all

asm inspect my-skill

asm inspect my-skill --json

Test install flow

asm install github:you/awesome-skill

asm install github:you/awesome-skill -p claude --force --yes --json

Publish to ASM Registry

asm publish ./my-skill

asm publish --dry-run ./my-skill

Requires gh CLI authenticated with gh auth login.

Typical workflow

1. asm init awesome-skill -p claude
2. Edit SKILL.md
3. asm link ./awesome-skill -p claude
4. Test with your agent
5. asm audit security awesome-skill
6. asm inspect awesome-skill
7. asm eval ./awesome-skill
8. Push to GitHub
9. asm install github:you/awesome-skill
10. asm publish ./awesome-skill

Indexed skills are evaluated automatically. Skills passing all criteria get a verified badge in the catalog.

Verification criteria (all required):

1. Valid frontmatter with name and description
2. Body content with at least 20 characters of instruction text
3. No malicious patterns (atob(), suspicious base64, hex escapes, hardcoded credentials)
4. Directory contains a readable SKILL.md

asm index ingest github:your-user/your-repo

asm index search "your-skill" --json

Quality scoring (asm eval) runs a rubric over structure, clarity, safety, and naming:

asm eval ./my-skill

asm eval ./my-skill --machine

asm eval ./my-skill --fix

asm eval-providers list

See docs/eval-providers.md for the provider model.

The ASM Registry lists community-published skills. Install by name — no GitHub URL needed.

asm install code-review

asm install luongnv89/code-review

asm install code-review --no-cache

asm publish ./my-skill

Resolution flow: fetch index (1-hour cache) → find manifest with pinned commit → clone at exact commit → install.

Over 2,800 skills across curated repositories. Use asm search <term> to discover, then asm install github:owner/repo.

Last updated: 2026-07-07

asm install github:anthropics/skills

asm install github:anthropics/skills --all

21 built-in providers, all enabled by default. Disable via asm config edit.

Add custom providers in config.

Multiple asm binaries on PATH can shadow a fresh upgrade.

Diagnose: asm --version warns about multiple binaries. Run asm doctor for a full report.

Fix: Remove the stale install with your package manager, then confirm with asm --version.

Commands

| Command | Description | | ------------------------------- | ----------------------------------------- | ----------------------------------------- | | asm list | List all discovered skills | | asm search <query> | Search by name/description/provider | | asm tag add\|remove | Edit local tags on an installed skill | | asm inspect <skill-name> | Show detailed info for a skill | | asm get <skill> | Print a skill's body, install nothing — --path borrows the full directory | | asm cleanup <path> | Remove a directory borrowed by asm get --path | | asm deps discover\|acquire\|release\|cleanup | Manage caller-owned temporary dependency leases | | 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 index overlap | Find semantically overlapping skills in the 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

-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)
--tag <tag[,tag]>      Filter by all tags; repeatable (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

asm list --scope global --sort location

asm list --summary

asm list --compact --group-by tool --limit 20

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).

asm tag add code-review testing cli
asm tag remove code-review automation
asm list --tag cli --tag testing
asm search code --tag cli,testing

Tags are local overlays (not written into SKILL.md). --tag requires every listed tag (AND). The catalog UI TagFilter uses the same AND matching and stores selections in ?tag=.

asm search "code review" --json

asm audit --yes

asm audit security github:user/repo

asm audit security --all

asm stats --tokens

asm audit residency --json

asm eval ./my-skill

asm init my-skill -p claude

asm link ./my-skill -p claude

asm uninstall old-skill --yes

asm index ingest github:anthropics/skills

asm index search "frontend design" --json

Bundles — pre-defined sets for common workflows. Browse at luongnv.com/asm/#/bundles:

asm bundle list --predefined

asm bundle install frontend-dev

asm bundle install ./my-bundle.json

In a terminal, asm bundle install prompts for the tool(s), then which bundle skills to install, then the install scope; Esc on any picker aborts. Pass a prompt's own flag to skip it — -p/--tool for the tool picker, -s/--scope global|project for the scope picker, -y for the skill and scope pickers. Outside a terminal there are no pickers, and -p/--tool is required unless exactly one tool is enabled:

asm bundle install frontend-dev --tool claude --scope project --yes

asm bundle create my-workflow
asm bundle export my-workflow ./my-workflow.json

iOS/Swift catalog: ASM indexes public Swift/Apple skill repos. Use asm bundle install ios-release or search for swift, swiftui, swift testing, uikit, swiftdata, app store connect.

Pre-defined bundles: frontend-dev, devops, content-writing, ios-release, marketing, software-dev, game-dev — full list via asm bundle list --predefined.

Single-skill repo:

asm install github:user/my-skill

asm install github:user/my-skill#v1.0.0 -p claude

Multi-skill repo:

asm install github:user/skills --path skills/code-review

asm install github:user/skills --all -p claude -y

Subfolder URL:

asm install https://github.com/user/skills/tree/main/skills/agent-config

asm install github:user/skills#main:skills/agent-config

Private repos:

asm install github:user/private-skill --transport ssh

asm install github:user/private-skill -t auto

Vercel skills CLI:

asm install github:user/skills --method vercel --skill my-skill

Multi-skill repos: scans up to 5 levels deep. Root SKILL.md installs by default; use --all for every skill. Requires git on PATH.

Local browser for skills. The CLI above is the primary interface for agents and automation.

Keyboard shortcuts

On first run, config is created at ~/.config/agent-skill-manager/config.json:

{
  "version": 1,
  "providers": [
    {
      "name": "claude",
      "label": "Claude Code",
      "global": "~/.claude/skills",
      "project": ".claude/skills",
      "enabled": true
    },
    {
      "name": "codex",
      "label": "Codex",
      "global": "~/.codex/skills",
      "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",
      "global": "~/.openclaw/skills",
      "project": ".openclaw/skills",
      "enabled": true
    },
    {
      "name": "agents",
      "label": "Agents",
      "global": "~/.agents/skills",
      "project": ".agents/skills",
      "enabled": true
    },
    {
      "name": "cursor",
      "label": "Cursor",
      "global": "~/.cursor/rules",
      "project": ".cursor/rules",
      "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": 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": true
    },
    {
      "name": "roocode",
      "label": "Roo Code",
      "global": "~/.roo/rules",
      "project": ".roo/rules",
      "enabled": true
    },
    {
      "name": "continue",
      "label": "Continue",
      "global": "~/.continue/rules",
      "project": ".continue/rules",
      "enabled": true
    },
    {
      "name": "aider",
      "label": "Aider",
      "global": "~/.aider/skills",
      "project": ".aider/skills",
      "enabled": true
    },
    {
      "name": "zed",
      "label": "Zed",
      "global": "~/.config/zed/prompt_overrides",
      "project": ".zed/rules",
      "enabled": true
    },
    {
      "name": "augment",
      "label": "Augment",
      "global": "~/.augment/rules",
      "project": ".augment/rules",
      "enabled": true
    },
    {
      "name": "amp",
      "label": "Amp",
      "global": "~/.amp/skills",
      "project": ".amp/skills",
      "enabled": true
    }
  ],
  "customPaths": [],
  "preferences": {
    "defaultScope": "both",
    "defaultSort": "name"
  }
}

• All 21 providers are enabled by default
• Set "enabled": false to skip a provider you don't use
• Add arbitrary directories via customPaths
• Manage via asm config show|path|reset|edit or press c in the TUI

Every skill is a directory with a SKILL.md file — YAML frontmatter plus markdown instructions.

---
name: my-skill
description: "What this skill does"
license: "MIT"
compatibility: "Claude Code, Codex"
allowed-tools: Bash Read Grep Glob WebFetch
effort: medium
metadata:
  version: 1.0.0
  creator: "Your Name <you@example.com>"
---

asm init my-skill

asm init my-skill -p claude

git clone https://github.com/luongnv89/asm.git
cd asm
npm install

npm run build

npm start

Inspect install script before running:

curl -sSL https://raw.githubusercontent.com/luongnv89/asm/main/install.sh -o install.sh
less install.sh
bash install.sh

asm/
├── bin/                       # CLI entry point
├── dist/                      # Built bundle (npm ships this)
├── scripts/                   # Build, preindex, catalog
├── src/
│   ├── index.tsx              # TUI (ink)
│   ├── cli.ts                 # CLI dispatcher
│   ├── scanner.ts             # Skill discovery
│   ├── installer.ts           # GitHub install pipeline
│   └── views/                 # TUI views
├── docs/                      # Extended documentation
├── assets/                    # Logos and screenshots
├── install.sh                 # curl installer
└── package.json

• Runtime: Node.js 22+
• Language: TypeScript + TSX
• Build: esbuild
• TUI: Ink + @inkjs/ui
• Testing: Vitest
• CI: GitHub Actions + pre-commit hooks

Landing page: luongnv.com/asm — catalog, bundles, author/repo stats, filtered search, and catalog TagFilter (AND, ?tag=).