asm — Agent Skills Manager

Install, search, update, and manage AI agent skills from your terminal.

npm install -g @igorkosta/asm

---

Quick start

# Search the registry
asm search security

# Install a package
asm install addyosmani-agent-skills

# List installed packages
asm list

---

Command reference

asm search <query>

Search the registry for packages. Matches package name, description, skill name, and skill category.

asm search tdd
asm search security
asm search anthropic

Output shows matching packages with version, skill count, category breakdown, and the specific skills that matched.

---

asm install <pkg>

Install a package (all its skills) locally.

asm install addyosmani-agent-skills
asm i kayaman-skills                # shorthand alias

Flag	Description
-g, --global	Install globally for the target agent
--agent <name>	Target agent (opencode, pi, claude, etc.)

Global install:

asm install microsoft-skills -g --agent opencode

Installed to ./ags_modules/skills/<pkg>/ (local) or ~/.config/<agent>/skills/<pkg>/ (global).

---

asm uninstall <pkg>

Remove a package or a specific skill.

asm uninstall addyosmani-agent-skills          # remove entire package
asm un addyosmani-agent-skills/tdd             # remove one skill only

Flag	Description
-g, --global	Remove from global install
--agent <name>	Target agent

Removes the package from ags-lock.json and cleans .gitignore when the last local package is removed.

---

asm list

Show installed packages and their skills.

asm list
asm ls                          # shorthand alias
asm list -g                     # global installs
asm list --agent opencode       # filter by agent

---

asm info <pkg>

Show metadata for a package or a specific skill.

asm info addyosmani-agent-skills                # package overview
asm info addyosmani-agent-skills/tdd            # single skill detail

---

asm update [pkg]

Update one or all installed packages to the latest version.

asm update addyosmani-agent-skills              # update one package
asm update                                      # update all packages

Flag	Description
-g, --global	Update global installs
--agent <name>	Target agent

Skips packages already at the latest version.

---

asm init [name]

Scaffold a new skill package in the current directory.

asm init my-skills
asm init --description "My skill collection" --version 0.1.0

Creates ags.json, skills/ directory, and a sample skill file.

---

asm publish

Validate the ags.json manifest in the current directory and output a registry entry snippet.

asm publish

Checks for required fields and verifies that referenced skill entry files exist.

---

asm source

Manage registry sources.

asm source list                     # list configured sources
asm source add my-index <url>       # add a source
asm source remove my-index          # remove a source

Flag	Description
--api-base-url <url>	API base URL for self-hosted instances (GitHub Enterprise, GitLab)

When no sources are configured, ships with a built-in default registry of 8 curated packages.

---

Configuration

Config file: ~/.config/ags/config.json

{
  "sources": [
    {
      "name": "community",
      "indexUrl": "https://raw.githubusercontent.com/agent-skills/index/main/registry.json"
    }
  ]
}

Env var	Overrides
AGS_CONFIG_DIR	Config directory (default ~/.config/ags)
AGS_AGENT	Default agent name for global installs

---

Install paths

Scope	Path
Local	./ags_modules/skills/<pkg>/
Global	~/.config/<agent>/skills/<pkg>/

Global installs require --agent <name> or AGS_AGENT env var.

---

Default registry

Nine curated packages are built-in — nothing to configure to get started:

Package	Skills	Description
addyosmani-agent-skills	24	Spec, plan, build, test, review, ship workflows
anthropics-skills	17	Creative, technical, and enterprise skill examples
farmage-opencode-skills	66	Skills across 12 domains
kayaman-skills	46	Best practices, conventions, and architecture guidance
microsoft-skills	174	Azure SDK and AI Foundry development
flitzrrr-agent-skills	504	Curated from 19 verified sources
newmindsgroup-ai-agent-skills-library	1,513	With brand-config.yml and starter packs
superagent-skills	12	Security skills — hacker, recon, supply-chain, crypto, infra, and more
christophacham-agent-skills-library	2,622	Consolidated from 48 sources across 34 categories

Add more sources with asm source add to extend beyond the defaults.

---

Lockfile (ags-lock.json)

Written to the project root on local installs. Always fresh — no cache.

{
  "packages": {
    "addyosmani-agent-skills": {
      "version": "0.6.2",
      "resolved": "https://github.com/addyosmani/agent-skills/archive/0.6.2.tar.gz",
      "integrity": "sha256-...",
      "agent": "local",
      "skills": ["test-driven-development", "security-and-hardening"]
    }
  }
}

---

Development

npm run dev           # run directly from source (no build needed)
npm test              # run tests
npm run build         # compile TypeScript to dist/