agent-skill-manager 2.3.0 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -12,7 +12,7 @@
12
12
  <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>
13
13
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT License" /></a>
14
14
  <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>
15
- <a href="https://bun.sh"><img src="https://img.shields.io/badge/runtime-Bun%20%E2%89%A5%201.0-black.svg" alt="Bun" /></a>
15
+ <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-%E2%89%A5%2018-339933.svg" alt="Node.js" /></a>
16
16
  </p>
17
17
 
18
18
  <h1 align="center">One tool to manage every AI agent's skills</h1>
@@ -72,7 +72,7 @@ The more AI agents you use, the worse this gets. Every new tool adds another ski
72
72
 
73
73
  ## How it works
74
74
 
75
- 1. **Install `asm`** — one command via npm, Bun, or curl
75
+ 1. **Install `asm`** — one command via npm or curl
76
76
  2. **Run `asm`** — it auto-discovers skills across all configured agent directories
77
77
  3. **Manage everything** — install, search, inspect, audit, and uninstall skills from the TUI or CLI
78
78
  4. **Stay safe** — security scan skills before installing, detect duplicates, and clean up with confidence
@@ -402,7 +402,7 @@ If multiple authors publish a skill with the same name, `asm` shows a disambigua
402
402
  npm install -g agent-skill-manager
403
403
  ```
404
404
 
405
- > Requires [Bun](https://bun.sh) >= 1.0.0 as the runtime. Install Bun: `curl -fsSL https://bun.sh/install | bash`
405
+ > Runs on **Node.js 18** for both the CLI and the interactive TUI. No other runtime required.
406
406
 
407
407
  ### One-liner install
408
408
 
@@ -410,7 +410,7 @@ npm install -g agent-skill-manager
410
410
  curl -sSL https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh | bash
411
411
  ```
412
412
 
413
- This installs Bun (if needed) and `agent-skill-manager` globally. Then just run:
413
+ This installs `agent-skill-manager` globally. Then just run:
414
414
 
415
415
  ```bash
416
416
  asm
@@ -420,27 +420,15 @@ asm
420
420
  <a href="#cli-commands"><strong>See All Commands &rarr;</strong></a>
421
421
  </p>
422
422
 
423
- ### Pick one package manager
424
-
425
- Install `asm` via **either** `npm` **or** `bun` — not both. Each global install drops an `asm` binary in a different directory (`/opt/homebrew/bin/asm` via npm, `~/.bun/bin/asm` via bun), and shells resolve whichever appears first on `PATH`. An older install can silently shadow a fresh upgrade: you run `asm --version` and still see the old version even though the upgrade succeeded.
426
-
427
423
  <a id="troubleshooting"></a>
428
424
 
429
- **Diagnose:** `asm --version` detects and warns when it sees multiple `asm` binaries on `PATH`. For a full report, run `asm doctor` — it lists the resolved path and any shadowed installs.
430
-
431
- **Fix:** remove the duplicate install.
425
+ ### Shadowed installs
432
426
 
433
- ```bash
434
- # If you're switching to npm:
435
- bun remove -g agent-skill-manager
436
-
437
- # If you're switching to bun:
438
- npm uninstall -g agent-skill-manager
439
- ```
427
+ If you have multiple `asm` binaries on `PATH` (for example, a leftover install from an older package manager), shells resolve whichever appears first and a fresh upgrade can be silently shadowed.
440
428
 
441
- Re-run `asm --version` to confirm only one binary is left. The postinstall step emits the same warning during `npm install -g agent-skill-manager` so you catch it at install time.
429
+ **Diagnose:** `asm --version` detects and warns when it sees multiple `asm` binaries on `PATH`. For a full report, run `asm doctor` it lists the resolved path and any shadowed installs.
442
430
 
443
- > **Note:** Bun skips lifecycle scripts by default, so the postinstall warning does not fire for `bun add -g agent-skill-manager`. Use `asm --version` or `asm doctor` to check for shadowing after a bun install.
431
+ **Fix:** remove the stale install with your package manager, then re-run `asm --version` to confirm only one binary is left.
444
432
 
445
433
  ---
446
434
 
@@ -525,7 +513,7 @@ Need a tool not listed? Add a custom provider entry to the config.
525
513
  Yes. `asm` is MIT licensed and free forever. No accounts, no telemetry, no paywalls.
526
514
 
527
515
  **Is it actively maintained?**
528
- v2.3.0 shipped on April 21, 2026. The project has had 36 releases. Check the [changelog](docs/CHANGELOG.md) for the full history.
516
+ v2.4.0 shipped on April 23, 2026. The project has had 37 releases. Check the [changelog](docs/CHANGELOG.md) for the full history.
529
517
 
530
518
  **Which AI agents does it support?**
531
519
  18 providers built-in: Claude Code, Codex, OpenClaw, Cursor, Windsurf, Cline, Roo Code, Continue, GitHub Copilot, Aider, OpenCode, Zed, Augment, Amp, Gemini CLI, Google Antigravity, Hermes, and a generic Agents provider. All 18 are enabled by default; disable any you don't need via `asm config edit`. You can also add any custom agent that stores skills as directories with a `SKILL.md` file.
@@ -1053,19 +1041,19 @@ asm init my-skill -p claude
1053
1041
  ```bash
1054
1042
  git clone https://github.com/luongnv89/agent-skill-manager.git
1055
1043
  cd agent-skill-manager
1056
- bun install
1044
+ npm install
1057
1045
  ```
1058
1046
 
1059
1047
  Bundle to `dist/`:
1060
1048
 
1061
1049
  ```bash
1062
- bun run build
1050
+ npm run build
1063
1051
  ```
1064
1052
 
1065
1053
  Run from source (development):
1066
1054
 
1067
1055
  ```bash
1068
- bun run start
1056
+ npm start
1069
1057
  ```
1070
1058
 
1071
1059
  ### Advanced Install
@@ -1098,7 +1086,7 @@ agent-skill-manager/
1098
1086
  ├── scripts/
1099
1087
  │ └── build.ts # Build script with version injection
1100
1088
  ├── src/
1101
- │ ├── index.ts # TUI app bootstrap & keyboard handling
1089
+ │ ├── index.tsx # TUI app bootstrap & keyboard handling (ink)
1102
1090
  │ ├── cli.ts # CLI command parser & dispatcher
1103
1091
  │ ├── config.ts # Config loading & saving
1104
1092
  │ ├── scanner.ts # Skill directory scanning & filtering
@@ -1113,13 +1101,13 @@ agent-skill-manager/
1113
1101
  │ │ ├── frontmatter.ts # SKILL.md frontmatter parser
1114
1102
  │ │ └── editor.ts # $EDITOR command parser
1115
1103
  │ └── views/
1116
- │ ├── dashboard.ts # Main dashboard layout
1117
- │ ├── skill-list.ts # Scrollable skill list
1118
- │ ├── skill-detail.ts # Skill detail overlay
1119
- │ ├── confirm.ts # Uninstall confirmation dialog
1120
- │ ├── duplicates.ts # Duplicate audit overlay
1121
- │ ├── config.ts # In-TUI config editor
1122
- │ └── help.ts # Help overlay
1104
+ │ ├── dashboard.tsx # Main dashboard layout
1105
+ │ ├── skill-list.tsx # Scrollable skill list
1106
+ │ ├── skill-detail.tsx # Skill detail view
1107
+ │ ├── confirm.tsx # Uninstall confirmation dialog
1108
+ │ ├── duplicates.tsx # Duplicate audit view
1109
+ │ ├── config.tsx # In-TUI config editor
1110
+ │ └── help.tsx # Help view
1123
1111
  ├── docs/ # Extended documentation
1124
1112
  │ ├── ARCHITECTURE.md # System design & data flow
1125
1113
  │ ├── DEVELOPMENT.md # Local setup & debugging
@@ -1140,11 +1128,11 @@ agent-skill-manager/
1140
1128
  <details>
1141
1129
  <summary><strong>Tech Stack</strong></summary>
1142
1130
 
1143
- - **Runtime:** [Bun](https://bun.sh) >= 1.0.0
1144
- - **Language:** TypeScript (ESNext, strict mode)
1145
- - **Build:** Bun bundler (ships pre-built via npm)
1146
- - **TUI Framework:** [OpenTUI](https://github.com/nicholasgasior/opentui)
1147
- - **Testing:** Bun test runner
1131
+ - **Runtime:** Node.js 18 (CLI and TUI both run on Node alone)
1132
+ - **Language:** TypeScript + TSX (ESNext, strict mode)
1133
+ - **Build:** esbuild (ships pre-built via npm)
1134
+ - **TUI Framework:** [Ink](https://github.com/vadimdemedes/ink) + [@inkjs/ui](https://github.com/vadimdemedes/ink-ui)
1135
+ - **Testing:** Vitest (+ ink-testing-library for TUI)
1148
1136
  - **CI:** GitHub Actions + pre-commit hooks
1149
1137
 
1150
1138
  </details>
@@ -0,0 +1,30 @@
1
+ {
2
+ "version": 1,
3
+ "name": "content-writing",
4
+ "description": "Content creation and marketing skills: blog drafting, social media posts, Reddit writing, and SEO optimization.",
5
+ "author": "ASM",
6
+ "createdAt": "2025-01-01T00:00:00.000Z",
7
+ "tags": ["content", "marketing", "social-media", "seo"],
8
+ "skills": [
9
+ {
10
+ "name": "blog-draft",
11
+ "installUrl": "github:luongnv89/skills:skills/blog-draft",
12
+ "description": "Draft SEO-optimized blog posts from ideas or outlines"
13
+ },
14
+ {
15
+ "name": "x-post-generator",
16
+ "installUrl": "github:luongnv89/skills:skills/x-post-generator",
17
+ "description": "Generate copy-paste-ready X (Twitter) posts"
18
+ },
19
+ {
20
+ "name": "reddit-writer",
21
+ "installUrl": "github:luongnv89/skills:skills/reddit-writer",
22
+ "description": "Generate authentic Reddit posts and replies"
23
+ },
24
+ {
25
+ "name": "seo-ai-optimizer",
26
+ "installUrl": "github:luongnv89/skills:skills/seo-ai-optimizer",
27
+ "description": "Audit and optimize website codebases for search engine visibility"
28
+ }
29
+ ]
30
+ }
@@ -0,0 +1,30 @@
1
+ {
2
+ "version": 1,
3
+ "name": "devops",
4
+ "description": "DevOps workflow skills: CI/CD pipeline setup, release management, code review, and security review.",
5
+ "author": "ASM",
6
+ "createdAt": "2025-01-01T00:00:00.000Z",
7
+ "tags": ["devops", "ci-cd", "release", "security"],
8
+ "skills": [
9
+ {
10
+ "name": "devops-pipeline",
11
+ "installUrl": "github:luongnv89/skills:skills/devops-pipeline",
12
+ "description": "Implement pre-commit hooks and lean GitHub Actions CI/CD pipelines"
13
+ },
14
+ {
15
+ "name": "release-manager",
16
+ "installUrl": "github:luongnv89/skills:skills/release-manager",
17
+ "description": "Automate the full release lifecycle"
18
+ },
19
+ {
20
+ "name": "code-review",
21
+ "installUrl": "github:luongnv89/skills:skills/code-review",
22
+ "description": "Review code changes for bugs, security issues, and best practices"
23
+ },
24
+ {
25
+ "name": "security-review",
26
+ "installUrl": "github:affaan-m/everything-claude-code:skills/security-review",
27
+ "description": "Complete a security review of the codebase"
28
+ }
29
+ ]
30
+ }
@@ -0,0 +1,25 @@
1
+ {
2
+ "version": 1,
3
+ "name": "eu-project-ops",
4
+ "description": "EU project operations skills: BIEN evaluation, COGNIMAN toolbox descriptions, and Montimage UI design.",
5
+ "author": "ASM",
6
+ "createdAt": "2025-01-01T00:00:00.000Z",
7
+ "tags": ["eu-project", "montimage", "cogniman", "bien"],
8
+ "skills": [
9
+ {
10
+ "name": "bien-evaluator",
11
+ "installUrl": "github:luongnv89/skills:skills/bien-evaluator",
12
+ "description": "Evaluate a French real estate listing for the BIEN database"
13
+ },
14
+ {
15
+ "name": "cogniman-toolbox-desc",
16
+ "installUrl": "github:luongnv89/skills:skills/cogniman-toolbox-desc",
17
+ "description": "Generate a COGNIMAN Toolbox tool description"
18
+ },
19
+ {
20
+ "name": "mi-designer",
21
+ "installUrl": "github:luongnv89/skills:skills/mi-designer",
22
+ "description": "Design frontend components and UI pages following Montimage brand identity"
23
+ }
24
+ ]
25
+ }
@@ -0,0 +1,35 @@
1
+ {
2
+ "version": 1,
3
+ "name": "frontend-dev",
4
+ "description": "Essential skills for frontend development: UI design, UX review, QA testing, browsing, and code review.",
5
+ "author": "ASM",
6
+ "createdAt": "2025-01-01T00:00:00.000Z",
7
+ "tags": ["frontend", "design", "qa", "web"],
8
+ "skills": [
9
+ {
10
+ "name": "frontend-design",
11
+ "installUrl": "github:luongnv89/skills:skills/frontend-design",
12
+ "description": "Design and implement production-grade frontend components and UI pages"
13
+ },
14
+ {
15
+ "name": "dont-make-me-think",
16
+ "installUrl": "github:luongnv89/skills:skills/dont-make-me-think",
17
+ "description": "Review UI for usability issues using Don't Make Me Think principles"
18
+ },
19
+ {
20
+ "name": "qa",
21
+ "installUrl": "github:mattpocock/skills:qa",
22
+ "description": "Systematically QA test a web application"
23
+ },
24
+ {
25
+ "name": "browse",
26
+ "installUrl": "github:luongnv89/skills:skills/browse",
27
+ "description": "Fast headless browser for QA testing and site dogfooding"
28
+ },
29
+ {
30
+ "name": "code-review",
31
+ "installUrl": "github:luongnv89/skills:skills/code-review",
32
+ "description": "Review code changes for bugs, security issues, and best practices"
33
+ }
34
+ ]
35
+ }
@@ -0,0 +1,30 @@
1
+ {
2
+ "version": 1,
3
+ "name": "ios-release",
4
+ "description": "iOS app release workflow: release management, App Store review checks, release notes, and VS Code extension publishing.",
5
+ "author": "ASM",
6
+ "createdAt": "2025-01-01T00:00:00.000Z",
7
+ "tags": ["ios", "mobile", "release", "appstore"],
8
+ "skills": [
9
+ {
10
+ "name": "release-manager",
11
+ "installUrl": "github:luongnv89/skills:skills/release-manager",
12
+ "description": "Automate the full release lifecycle"
13
+ },
14
+ {
15
+ "name": "appstore-review-checker",
16
+ "installUrl": "github:luongnv89/skills:skills/appstore-review-checker",
17
+ "description": "Audit iOS/macOS app projects against App Store Review Guidelines"
18
+ },
19
+ {
20
+ "name": "release-notes",
21
+ "installUrl": "github:luongnv89/skills:skills/release-notes",
22
+ "description": "Generate release notes from git commits and GitHub PRs/issues"
23
+ },
24
+ {
25
+ "name": "vscode-extension-publisher",
26
+ "installUrl": "github:luongnv89/skills:skills/vscode-extension-publisher",
27
+ "description": "Publish VS Code extensions to the Visual Studio Marketplace"
28
+ }
29
+ ]
30
+ }
@@ -0,0 +1,73 @@
1
+ {
2
+ "repoUrl": "https://github.com/luongnv89/asm.git",
3
+ "owner": "luongnv89",
4
+ "repo": "asm",
5
+ "updatedAt": "2026-04-21T20:48:38.441Z",
6
+ "skillCount": 1,
7
+ "skills": [
8
+ {
9
+ "name": "skill-auto-improver",
10
+ "description": "Improve a SKILL.md skill by running `asm eval`, fixing weakest categories, and looping until it clears the 85/8 floor or stops with a blocker. Use when leveling up a skill, preparing for publish, or rescuing a failing eval.",
11
+ "version": "0.1.0",
12
+ "license": "MIT",
13
+ "creator": "luongnv89",
14
+ "compatibility": "Claude Code",
15
+ "allowedTools": ["Bash", "Read", "Write", "Edit", "Grep", "Glob"],
16
+ "installUrl": "github:luongnv89/asm:skills/skill-auto-improver",
17
+ "relPath": "skills/skill-auto-improver",
18
+ "verified": true,
19
+ "featured": true,
20
+ "tokenCount": 3101,
21
+ "evalSummary": {
22
+ "overallScore": 100,
23
+ "grade": "A",
24
+ "categories": [
25
+ {
26
+ "id": "structure",
27
+ "name": "Structure & completeness",
28
+ "score": 10,
29
+ "max": 10
30
+ },
31
+ {
32
+ "id": "description",
33
+ "name": "Description quality",
34
+ "score": 10,
35
+ "max": 10
36
+ },
37
+ {
38
+ "id": "prompt-engineering",
39
+ "name": "Prompt engineering",
40
+ "score": 10,
41
+ "max": 10
42
+ },
43
+ {
44
+ "id": "context-efficiency",
45
+ "name": "Context efficiency",
46
+ "score": 10,
47
+ "max": 10
48
+ },
49
+ {
50
+ "id": "safety",
51
+ "name": "Safety & guardrails",
52
+ "score": 10,
53
+ "max": 10
54
+ },
55
+ {
56
+ "id": "testability",
57
+ "name": "Testability",
58
+ "score": 10,
59
+ "max": 10
60
+ },
61
+ {
62
+ "id": "naming",
63
+ "name": "Naming & conventions",
64
+ "score": 10,
65
+ "max": 10
66
+ }
67
+ ],
68
+ "evaluatedAt": "2026-04-21T20:48:38.441Z",
69
+ "evaluatedVersion": "0.1.0"
70
+ }
71
+ }
72
+ ]
73
+ }
@@ -1,6 +1,15 @@
1
1
  {
2
- "updatedAt": "2026-04-20T00:00:00Z",
2
+ "updatedAt": "2026-04-21T00:00:00Z",
3
3
  "repos": [
4
+ {
5
+ "source": "github:luongnv89/asm",
6
+ "url": "https://github.com/luongnv89/asm",
7
+ "owner": "luongnv89",
8
+ "repo": "asm",
9
+ "description": "Built-in ASM skills (only skill-auto-improver is published to the catalog)",
10
+ "maintainer": "@luongnv89",
11
+ "enabled": false
12
+ },
4
13
  {
5
14
  "source": "github:anthropics/skills",
6
15
  "url": "https://github.com/anthropics/skills",