agent-skill-manager 2.3.0 → 2.5.0

package/README.md

@@ -12,7 +12,7 @@
   <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="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://bun.sh"><img src="https://img.shields.io/badge/runtime-Bun%20%E2%89%A5%201.0-black.svg" alt="Bun" /></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>
 </p>
 
 <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
 
 ## How it works
 
-1. **Install `asm`** — one command via npm, Bun, or curl
+1. **Install `asm`** — one command via npm or curl
 2. **Run `asm`** — it auto-discovers skills across all configured agent directories
 3. **Manage everything** — install, search, inspect, audit, and uninstall skills from the TUI or CLI
 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
 npm install -g agent-skill-manager
 ```
 
-> Requires [Bun](https://bun.sh) >= 1.0.0 as the runtime. Install Bun: `curl -fsSL https://bun.sh/install | bash`
+> Runs on **Node.js ≥ 18** for both the CLI and the interactive TUI. No other runtime required.
 
 ### One-liner install
 
@@ -410,7 +410,7 @@ npm install -g agent-skill-manager
 curl -sSL https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh | bash
 ```
 
-This installs Bun (if needed) and `agent-skill-manager` globally. Then just run:
+This installs `agent-skill-manager` globally. Then just run:
 
 ```bash
 asm
@@ -420,27 +420,15 @@ asm
   <a href="#cli-commands"><strong>See All Commands &rarr;</strong></a>
 </p>
 
-### Pick one package manager
-
-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.
-
 <a id="troubleshooting"></a>
 
-**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.
-
-**Fix:** remove the duplicate install.
+### Shadowed installs
 
-```bash
-# If you're switching to npm:
-bun remove -g agent-skill-manager
-
-# If you're switching to bun:
-npm uninstall -g agent-skill-manager
-```
+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.
 
-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.
+**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.
 
-> **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.
+**Fix:** remove the stale install with your package manager, then re-run `asm --version` to confirm only one binary is left.
 
 ---
 
@@ -525,7 +513,7 @@ Need a tool not listed? Add a custom provider entry to the config.
 Yes. `asm` is MIT licensed and free forever. No accounts, no telemetry, no paywalls.
 
 **Is it actively maintained?**
-v2.3.0 shipped on April 21, 2026. The project has had 36 releases. Check the [changelog](docs/CHANGELOG.md) for the full history.
+v2.5.0 shipped on April 24, 2026. The project has had 38 releases. Check the [changelog](docs/CHANGELOG.md) for the full history.
 
 **Which AI agents does it support?**
 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
 ```bash
 git clone https://github.com/luongnv89/agent-skill-manager.git
 cd agent-skill-manager
-bun install
+npm install
 ```
 
 Bundle to `dist/`:
 
 ```bash
-bun run build
+npm run build
 ```
 
 Run from source (development):
 
 ```bash
-bun run start
+npm start
 ```
 
 ### Advanced Install
@@ -1098,7 +1086,7 @@ agent-skill-manager/
 ├── scripts/
 │   └── build.ts               # Build script with version injection
 ├── src/
-│   ├── index.ts               # TUI app bootstrap & keyboard handling
+│   ├── index.tsx              # TUI app bootstrap & keyboard handling (ink)
 │   ├── cli.ts                 # CLI command parser & dispatcher
 │   ├── config.ts              # Config loading & saving
 │   ├── scanner.ts             # Skill directory scanning & filtering
@@ -1113,13 +1101,13 @@ agent-skill-manager/
 │   │   ├── frontmatter.ts     # SKILL.md frontmatter parser
 │   │   └── editor.ts          # $EDITOR command parser
 │   └── views/
-│       ├── dashboard.ts       # Main dashboard layout
-│       ├── skill-list.ts      # Scrollable skill list
-│       ├── skill-detail.ts    # Skill detail overlay
-│       ├── confirm.ts         # Uninstall confirmation dialog
-│       ├── duplicates.ts      # Duplicate audit overlay
-│       ├── config.ts          # In-TUI config editor
-│       └── help.ts            # Help overlay
+│       ├── dashboard.tsx      # Main dashboard layout
+│       ├── skill-list.tsx     # Scrollable skill list
+│       ├── skill-detail.tsx   # Skill detail view
+│       ├── confirm.tsx        # Uninstall confirmation dialog
+│       ├── duplicates.tsx     # Duplicate audit view
+│       ├── config.tsx         # In-TUI config editor
+│       └── help.tsx           # Help view
 ├── docs/                      # Extended documentation
 │   ├── ARCHITECTURE.md        # System design & data flow
 │   ├── DEVELOPMENT.md         # Local setup & debugging
@@ -1140,11 +1128,11 @@ agent-skill-manager/
 <details>
 <summary><strong>Tech Stack</strong></summary>
 
-- **Runtime:** [Bun](https://bun.sh) >= 1.0.0
-- **Language:** TypeScript (ESNext, strict mode)
-- **Build:** Bun bundler (ships pre-built via npm)
-- **TUI Framework:** [OpenTUI](https://github.com/nicholasgasior/opentui)
-- **Testing:** Bun test runner
+- **Runtime:** Node.js ≥ 18 (CLI and TUI both run on Node alone)
+- **Language:** TypeScript + TSX (ESNext, strict mode)
+- **Build:** esbuild (ships pre-built via npm)
+- **TUI Framework:** [Ink](https://github.com/vadimdemedes/ink) + [@inkjs/ui](https://github.com/vadimdemedes/ink-ui)
+- **Testing:** Vitest (+ ink-testing-library for TUI)
 - **CI:** GitHub Actions + pre-commit hooks
 
 </details>

package/data/bundles/content-writing.json

@@ -0,0 +1,30 @@
+{
+  "version": 1,
+  "name": "content-writing",
+  "description": "Content creation and marketing skills: blog drafting, social media posts, Reddit writing, and SEO optimization.",
+  "author": "ASM",
+  "createdAt": "2025-01-01T00:00:00.000Z",
+  "tags": ["content", "marketing", "social-media", "seo"],
+  "skills": [
+    {
+      "name": "blog-draft",
+      "installUrl": "github:luongnv89/skills:skills/blog-draft",
+      "description": "Draft SEO-optimized blog posts from ideas or outlines"
+    },
+    {
+      "name": "x-post-generator",
+      "installUrl": "github:luongnv89/skills:skills/x-post-generator",
+      "description": "Generate copy-paste-ready X (Twitter) posts"
+    },
+    {
+      "name": "reddit-writer",
+      "installUrl": "github:luongnv89/skills:skills/reddit-writer",
+      "description": "Generate authentic Reddit posts and replies"
+    },
+    {
+      "name": "seo-ai-optimizer",
+      "installUrl": "github:luongnv89/skills:skills/seo-ai-optimizer",
+      "description": "Audit and optimize website codebases for search engine visibility"
+    }
+  ]
+}

package/data/bundles/devops.json

@@ -0,0 +1,30 @@
+{
+  "version": 1,
+  "name": "devops",
+  "description": "DevOps workflow skills: CI/CD pipeline setup, release management, code review, and security review.",
+  "author": "ASM",
+  "createdAt": "2025-01-01T00:00:00.000Z",
+  "tags": ["devops", "ci-cd", "release", "security"],
+  "skills": [
+    {
+      "name": "devops-pipeline",
+      "installUrl": "github:luongnv89/skills:skills/devops-pipeline",
+      "description": "Implement pre-commit hooks and lean GitHub Actions CI/CD pipelines"
+    },
+    {
+      "name": "release-manager",
+      "installUrl": "github:luongnv89/skills:skills/release-manager",
+      "description": "Automate the full release lifecycle"
+    },
+    {
+      "name": "code-review",
+      "installUrl": "github:luongnv89/skills:skills/code-review",
+      "description": "Review code changes for bugs, security issues, and best practices"
+    },
+    {
+      "name": "security-review",
+      "installUrl": "github:affaan-m/everything-claude-code:skills/security-review",
+      "description": "Complete a security review of the codebase"
+    }
+  ]
+}

package/data/bundles/frontend-dev.json

@@ -0,0 +1,35 @@
+{
+  "version": 1,
+  "name": "frontend-dev",
+  "description": "Essential skills for frontend development: UI design, UX review, QA testing, browsing, and code review.",
+  "author": "ASM",
+  "createdAt": "2025-01-01T00:00:00.000Z",
+  "tags": ["frontend", "design", "qa", "web"],
+  "skills": [
+    {
+      "name": "frontend-design",
+      "installUrl": "github:luongnv89/skills:skills/frontend-design",
+      "description": "Design and implement production-grade frontend components and UI pages"
+    },
+    {
+      "name": "dont-make-me-think",
+      "installUrl": "github:luongnv89/skills:skills/dont-make-me-think",
+      "description": "Review UI for usability issues using Don't Make Me Think principles"
+    },
+    {
+      "name": "qa",
+      "installUrl": "github:mattpocock/skills:qa",
+      "description": "Systematically QA test a web application"
+    },
+    {
+      "name": "browse",
+      "installUrl": "github:luongnv89/skills:skills/browse",
+      "description": "Fast headless browser for QA testing and site dogfooding"
+    },
+    {
+      "name": "code-review",
+      "installUrl": "github:luongnv89/skills:skills/code-review",
+      "description": "Review code changes for bugs, security issues, and best practices"
+    }
+  ]
+}

package/data/bundles/ios-release.json

@@ -0,0 +1,30 @@
+{
+  "version": 1,
+  "name": "ios-release",
+  "description": "iOS app release workflow: release management, App Store review checks, release notes, and VS Code extension publishing.",
+  "author": "ASM",
+  "createdAt": "2025-01-01T00:00:00.000Z",
+  "tags": ["ios", "mobile", "release", "appstore"],
+  "skills": [
+    {
+      "name": "release-manager",
+      "installUrl": "github:luongnv89/skills:skills/release-manager",
+      "description": "Automate the full release lifecycle"
+    },
+    {
+      "name": "appstore-review-checker",
+      "installUrl": "github:luongnv89/skills:skills/appstore-review-checker",
+      "description": "Audit iOS/macOS app projects against App Store Review Guidelines"
+    },
+    {
+      "name": "release-notes",
+      "installUrl": "github:luongnv89/skills:skills/release-notes",
+      "description": "Generate release notes from git commits and GitHub PRs/issues"
+    },
+    {
+      "name": "vscode-extension-publisher",
+      "installUrl": "github:luongnv89/skills:skills/vscode-extension-publisher",
+      "description": "Publish VS Code extensions to the Visual Studio Marketplace"
+    }
+  ]
+}

package/data/skill-index/antonbabenko_terraform-skill.json

@@ -0,0 +1,146 @@
+{
+  "repoUrl": "https://github.com/antonbabenko/terraform-skill.git",
+  "owner": "antonbabenko",
+  "repo": "terraform-skill",
+  "updatedAt": "2026-04-24T05:21:41.936Z",
+  "skillCount": 1,
+  "skills": [
+    {
+      "name": "terraform-skill",
+      "description": "Use when writing, reviewing, or debugging Terraform/OpenTofu modules, tests, CI, scans, or state ops — diagnoses failure mode (identity churn, secrets, blast radius, CI drift, state corruption) with version-aware guards.",
+      "version": "1.8.0",
+      "license": "Apache-2.0",
+      "creator": "",
+      "compatibility": "",
+      "allowedTools": [],
+      "installUrl": "github:antonbabenko/terraform-skill:skills/terraform-skill",
+      "relPath": "skills/terraform-skill",
+      "verified": true,
+      "tokenCount": 4111,
+      "evalSummary": {
+        "overallScore": 79,
+        "grade": "C",
+        "categories": [
+          {
+            "id": "structure",
+            "name": "Structure & completeness",
+            "score": 9,
+            "max": 10
+          },
+          {
+            "id": "description",
+            "name": "Description quality",
+            "score": 7,
+            "max": 10
+          },
+          {
+            "id": "prompt-engineering",
+            "name": "Prompt engineering",
+            "score": 10,
+            "max": 10
+          },
+          {
+            "id": "context-efficiency",
+            "name": "Context efficiency",
+            "score": 7,
+            "max": 10
+          },
+          {
+            "id": "safety",
+            "name": "Safety & guardrails",
+            "score": 7,
+            "max": 10
+          },
+          {
+            "id": "testability",
+            "name": "Testability",
+            "score": 5,
+            "max": 10
+          },
+          {
+            "id": "naming",
+            "name": "Naming & conventions",
+            "score": 10,
+            "max": 10
+          }
+        ],
+        "evaluatedAt": "2026-04-24T05:21:41.933Z",
+        "evaluatedVersion": "1.8.0"
+      },
+      "evalSummaries": {
+        "quality": {
+          "providerId": "quality",
+          "providerVersion": "1.0.0",
+          "schemaVersion": 1,
+          "passed": true,
+          "overallScore": 79,
+          "grade": "C",
+          "categories": [
+            {
+              "id": "structure",
+              "name": "Structure & completeness",
+              "score": 9,
+              "max": 10
+            },
+            {
+              "id": "description",
+              "name": "Description quality",
+              "score": 7,
+              "max": 10
+            },
+            {
+              "id": "prompt-engineering",
+              "name": "Prompt engineering",
+              "score": 10,
+              "max": 10
+            },
+            {
+              "id": "context-efficiency",
+              "name": "Context efficiency",
+              "score": 7,
+              "max": 10
+            },
+            {
+              "id": "safety",
+              "name": "Safety & guardrails",
+              "score": 7,
+              "max": 10
+            },
+            {
+              "id": "testability",
+              "name": "Testability",
+              "score": 5,
+              "max": 10
+            },
+            {
+              "id": "naming",
+              "name": "Naming & conventions",
+              "score": 10,
+              "max": 10
+            }
+          ],
+          "evaluatedAt": "2026-04-24T05:21:41.933Z",
+          "evaluatedVersion": "1.8.0"
+        },
+        "skill-best-practice": {
+          "providerId": "skill-best-practice",
+          "providerVersion": "1.0.0",
+          "schemaVersion": 1,
+          "passed": true,
+          "overallScore": 89,
+          "grade": "B",
+          "categories": [
+            {
+              "id": "validation",
+              "name": "Deterministic validation",
+              "score": 8,
+              "max": 9
+            }
+          ],
+          "evaluatedAt": "2026-04-24T05:21:41.933Z",
+          "evaluatedVersion": "1.8.0"
+        }
+      }
+    }
+  ]
+}