kenmark-skills 1.1.1 → 1.1.4

package/README.md

@@ -40,11 +40,12 @@ For installing, updating, and cleaning up skills on your machine (pairs with **`
 
 | Skill | Purpose |
 | --- | --- |
-| [`skills-install-recommended`](skills/user-skills/skills-install-recommended/SKILL.md) | Install curated third-party packs (Impeccable, ECC, …) with scope and pack selection |
+| [`skills-install-recommended`](skills/user-skills/skills-install-recommended/SKILL.md) | Install curated third-party packs (Impeccable, ECC, Graphify, code review, SEO/GEO) with scope and pack selection |
 | [`skills-update`](skills/user-skills/skills-update/SKILL.md) | Refresh Kenmark skills and optionally reinstall recommended packs |
 | [`skills-maintain`](skills/user-skills/skills-maintain/SKILL.md) | Inventory installed skills, group duplicates, recommend keep vs remove (no auto-delete) |
+| [`subagents-maintain`](skills/user-skills/subagents-maintain/SKILL.md) | Inventory installed sub-agents across Claude, Cursor, Codex, Gemini, OpenCode, MiniMax; recommend keep vs remove (no auto-delete) |
 
-**Typical path:** `skills-init` or `npx kenmark-skills setup` → **`skills-install-recommended`** for curated packs → day-to-day **`skills-router`** → periodic **`skills-update`** / **`skills-maintain`**.
+**Typical path:** `skills-init` or `npx kenmark-skills setup` → **`skills-install-recommended`** for curated packs → day-to-day **`skills-router`** → periodic **`skills-update`** / **`skills-maintain`** / **`subagents-maintain`**.
 
 These skills assume a **`brain/`** knowledge base (standards, changelog, optional issue tracker). On a new repo: **`init-brain`** → **`issues-setup`** if you track work in `brain/issues/` → **`commit-push`** when shipping.
 
@@ -63,10 +64,11 @@ All `kenmark-skills` commands **prompt in the terminal by default** (TTY). For a
 | --- | --- | --- |
 | `init` | `npx kenmark-skills init` | `npx kenmark-skills init --global --ide all -y` |
 | `setup` | `npx kenmark-skills setup` | `npx kenmark-skills setup --global --ide cursor -y` |
-| `install-recommended` | `npx kenmark-skills install-recommended` | `npx kenmark-skills install-recommended --ids impeccable,ecc --global -y` |
+| `install-recommended` | `npx kenmark-skills install-recommended` | `npx kenmark-skills install-recommended --ids impeccable --global -y` |
 | `update` | `npx kenmark-skills update` | `npx kenmark-skills update --both --global -y` |
 | `adopt` | `npx kenmark-skills adopt` | `npx kenmark-skills adopt --global --ide all -y` |
 | `inventory` | `npx kenmark-skills inventory` | `npx kenmark-skills inventory --markdown ./report.md -y` |
+| `subagents-inventory` | `npx kenmark-skills subagents-inventory` | `npx kenmark-skills subagents-inventory --markdown ./agents.md --include-marketplaces -y` |
 
 ### Option A — Global npm install (recommended)
 
@@ -79,12 +81,12 @@ npx kenmark-skills init
 
 ### Kenmark skill hub (`~/.kenmark`)
 
-Kenmark first-party skills and **curated catalog** skills (Impeccable, ECC skill folders) are stored once under:
+Kenmark first-party skills and **curated catalog** skills (Impeccable, ECC, Graphify, code review, SEO/GEO, and more) are stored once under:
 
 - **Store:** `~/.kenmark/store/skills/<name>/`
 - **Manifest:** `~/.kenmark/manifest.json`
 
-`setup` copies bundled skills into the store, then **symlinks** (or copies on Windows when symlinks are unavailable) into each IDE path. **`update`** refreshes the store and runs **`adopt`** by default to consolidate catalog skills into the store and relink IDEs. **Adopt** includes Kenmark bundled skills, Impeccable, and ECC skills listed in the ECC install profile (`--ecc-profile`, default `core`) — not arbitrary third-party trees such as gstack mirrors.
+`setup` copies bundled skills into the store, then **symlinks** (or copies on Windows when symlinks are unavailable) into each IDE path. **`update`** refreshes the store and runs **`adopt`** by default to consolidate catalog skills into the store and relink IDEs. **Adopt** includes Kenmark bundled skills and adoptable catalog packs (Impeccable, ECC, and more) when present on disk.
 
 | Flag | Purpose |
 | --- | --- |
@@ -157,18 +159,30 @@ npx kenmark-skills inventory --markdown ~/Desktop/skills-report.md --json ~/Desk
 npx kenmark-skills inventory --include-plugins
 ```
 
-Install curated packs from [`recommended-catalog.json`](skills/user-skills/recommended-catalog.json) via **npx** (no git clone). Default is **global** install; use **project** for the current repo only.
+### Sub-agents inventory
+
+Scan installed sub-agents (Claude, Cursor, Codex, Gemini, OpenCode, MiniMax) and get a keep / dedupe / remove report. Same output layout as the skills inventory, but walks `agents/` directories and reads YAML frontmatter (`name`, `description`, `tools`, `model`).
+
+```bash
+npx kenmark-skills subagents-inventory
+npx kenmark-skills subagents-inventory --markdown ~/Desktop/subagents-report.md --json ~/Desktop/subagents-inventory.json
+npx kenmark-skills subagents-inventory --include-marketplaces
+```
+
+For guided chat cleanup (no auto-delete), use the **`subagents-maintain`** skill — it pairs with **`skills-maintain`** for the full library audit.
+
+Install curated packs from [`recommended-catalog.json`](skills/user-skills/recommended-catalog.json) — Impeccable, ECC, Graphify, code review, SEO/GEO, and more. Install methods vary by pack: npx, git clone, uv/pipx, or `npx ecc-install` with a profile. Default is **global** install; use **project** for the current repo only.
 
 ```bash
 npx kenmark-skills install-recommended --list
 
-# Interactive: scope → packs → ECC profile
+# Interactive: scope → packs
 npx kenmark-skills install-recommended
 
 # Non-interactive
 npx kenmark-skills install-recommended --all --global -y
 npx kenmark-skills install-recommended --all --project -y
-npx kenmark-skills install-recommended --ids impeccable,ecc --global --ecc-profile core -y
+npx kenmark-skills install-recommended --ids impeccable --global -y
 npx kenmark-skills install-recommended --dry-run --all --project
 ```
 
@@ -184,7 +198,7 @@ npx kenmark-skills update
 # Non-interactive
 npx kenmark-skills update --both --global -y
 npx kenmark-skills update --kenmark-only --global --ide all -y
-npx kenmark-skills update --recommended-only --global --ids impeccable,ecc -y
+npx kenmark-skills update --recommended-only --global --ids impeccable -y
 npx kenmark-skills update --npm-only -y
 ```
 
@@ -297,6 +311,7 @@ kenmark-skills/
         ├── issues-*/
         ├── skills-maintain/
         ├── skills-install-recommended/
+        ├── subagents-maintain/
         └── recommended-catalog.json
 ```
 

package/brain/CHANGELOG.md

@@ -1,5 +1,22 @@
 # CHANGELOG
 
+## v1.1.4 — Multi-pack recommended catalog
+
+- **recommended-catalog.json (v3):** Catalog expanded from 1 to 5 packs: `impeccable` (default), `ecc` (minimal/core/full profiles, default `minimal`), `graphify` (Python via uv/pipx), `code-review-skill` (git clone), `seo-geo-claude-skills` (npx). Dropped `defaults.eccProfile`; the profile now lives on the `ecc` pack itself.
+- **scripts/skills-install-recommended.js:** Reused existing `id === "ecc"` special-casing to wire up the ECC profile prompt and `{{profile}}` placeholder substitution. CLI now accepts `--ecc-profile minimal|core|full` (e.g. `npx kenmark-skills install-recommended --ids ecc --ecc-profile minimal --global -y`).
+- **skills-install-recommended, skills-init, skills-update, README:** Docs and examples updated to reflect the multi-pack catalog. The "ECC, gstack not in this catalog" note is gone; the Impeccable-only pack table now lists all 5 packs with their install methods.
+- **Removed:** `compound-engineering` pack entry (replaced by `ecc` as the preferred harness pack).
+
+## v1.1.3 — Impeccable-only recommended catalog
+
+- **recommended-catalog.json (v3):** Removed `ecc` and `gstack` packs; only **Impeccable** remains (`defaultSelected: true`). Dropped `defaults.eccProfile`.
+- **skills-install-recommended, skills-init, skills-update, README:** Docs and examples updated for Impeccable-only curated installs. ECC/gstack can still be installed separately outside the catalog.
+
+## v1.1.2 — gstack in recommended catalog
+
+- **recommended-catalog.json:** Added [gstack](https://github.com/garrytan/gstack) pack (`id: gstack`) with global `git clone` + `./setup` and project team-mode via `gstack-team-init optional`; `defaultSelected: false`.
+- **skills-install-recommended:** Documented gstack install commands, requirements (Git, Bun), and overlap note with ECC.
+
 ## v1.1.1 — ECC adopt scope fix
 
 - **`kenmark-hub.js`:** ECC adopt names come from ECC `install-profiles.json` / `install-modules.json` (profile from catalog, default `core`), not every skill under `~/.claude/skills`. Optional pack-level `adoptSkillNames` override in `recommended-catalog.json`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenmark-skills",
-  "version": "1.1.1",
+  "version": "1.1.4",
   "description": "Skills by Kenmark ITan Solutions — Cursor/Codex agent skills from our development workflows. Created by Tanooj Mehra & Adwait Date.",
   "license": "MIT",
   "private": false,
@@ -19,6 +19,7 @@
     "scripts/skills-inventory.js",
     "scripts/skills-install-recommended.js",
     "scripts/skills-update.js",
+    "scripts/subagents-inventory.js",
     "skills/user-skills/recommended-catalog.json"
   ],
   "scripts": {
@@ -26,6 +27,7 @@
     "setup": "node scripts/cli.js setup",
     "uninstall:skills": "node scripts/cli.js uninstall",
     "inventory": "node scripts/cli.js inventory",
+    "subagents-inventory": "node scripts/cli.js subagents-inventory",
     "install-recommended": "node scripts/cli.js install-recommended",
     "update": "node scripts/cli.js update",
     "setup:skills": "node scripts/setup-skills.js",

package/scripts/cli.js

@@ -16,6 +16,7 @@ function printUsage() {
   console.log("  kenmark-skills setup [--global|--project] [--ide <target>] [-y]");
   console.log("  kenmark-skills uninstall [--global|--project] [--ide <target>] [-y]");
   console.log("  kenmark-skills inventory [--json path] [--markdown path] [--include-plugins]");
+  console.log("  kenmark-skills subagents-inventory [--json path] [--markdown path] [--include-plugins] [--include-marketplaces]");
   console.log("  kenmark-skills install-recommended [--list] [--all] [--ids a,b] [--global|--project] [-y]");
   console.log("  kenmark-skills update [--kenmark-only|--recommended-only|--both] [--global|--project] [-y]");
   console.log("  kenmark-skills adopt [--global|--project] [--ide <target>] [--dry-run] [-y]");
@@ -67,6 +68,14 @@ if (command === "inventory") {
   process.exit(result.status === null ? 1 : result.status);
 }
 
+if (command === "subagents-inventory" || command === "agents-inventory") {
+  const scriptPath = path.join(__dirname, "subagents-inventory.js");
+  const result = spawnSync(process.execPath, [scriptPath, ...args.slice(1)], {
+    stdio: "inherit"
+  });
+  process.exit(result.status === null ? 1 : result.status);
+}
+
 if (command === "install-recommended") {
   const scriptPath = path.join(__dirname, "skills-install-recommended.js");
   const result = spawnSync(process.execPath, [scriptPath, ...args.slice(1)], {

package/scripts/kenmark-hub.js

@@ -18,7 +18,23 @@ const VENDORED_PREFIXES = [
   "plugins/cache/"
 ];
 
+const AGENT_VENDORED_PREFIXES = [
+  "gstack/",
+  ".cursor/agents/gstack",
+  ".factory/agents/gstack",
+  ".agents/agents/gstack",
+  ".gbrain/agents/gstack",
+  ".hermes/agents/gstack",
+  ".kiro/agents/gstack",
+  ".openclaw/agents/gstack",
+  ".opencode/agents/gstack",
+  ".slate/agents/gstack",
+  "plugins/cache/",
+  "plugins/marketplaces/"
+];
+
 const IDE_SCAN_PRIORITY = ["agents", "cursor", "claude", "gemini", "codex", "opencode", "minimax"];
+const AGENT_IDE_SCAN_PRIORITY = ["claude", "cursor", "agents", "gemini", "codex", "opencode", "minimax"];
 
 function getKenmarkHome() {
   return path.join(os.homedir(), ".kenmark");
@@ -28,10 +44,18 @@ function getStoreDir() {
   return path.join(getKenmarkHome(), "store", "skills");
 }
 
+function getAgentStoreDir() {
+  return path.join(getKenmarkHome(), "store", "agents");
+}
+
 function getManifestPath() {
   return path.join(getKenmarkHome(), "manifest.json");
 }
 
+function getAgentManifestPath() {
+  return path.join(getKenmarkHome(), "agent-manifest.json");
+}
+
 function buildGlobalTargets(homeDir = os.homedir()) {
   return {
     cursor: path.join(homeDir, ".cursor", "skills"),
@@ -77,11 +101,29 @@ function buildInventoryRoots(homeDir = os.homedir()) {
   ];
 }
 
+function buildAgentInventoryRoots(homeDir = os.homedir()) {
+  return [
+    { id: "kenmark-store", path: path.join(homeDir, ".kenmark", "store", "agents") },
+    { id: "claude", path: path.join(homeDir, ".claude", "agents") },
+    { id: "cursor", path: path.join(homeDir, ".cursor", "agents") },
+    { id: "agents", path: path.join(homeDir, ".agents", "agents") },
+    { id: "gemini", path: path.join(homeDir, ".gemini", "agents") },
+    { id: "codex", path: path.join(homeDir, ".codex", "agents") },
+    { id: "opencode", path: path.join(homeDir, ".opencode", "agents") },
+    { id: "minimax", path: path.join(homeDir, ".minimax", "agents") }
+  ];
+}
+
 function isVendoredMirror(relativePath) {
   const norm = String(relativePath || "").replace(/\\/g, "/");
   return VENDORED_PREFIXES.some((prefix) => norm.includes(prefix));
 }
 
+function isVendoredAgent(relativePath) {
+  const norm = String(relativePath || "").replace(/\\/g, "/");
+  return AGENT_VENDORED_PREFIXES.some((prefix) => norm.includes(prefix));
+}
+
 function safeRealpath(p) {
   try {
     return fs.realpathSync(p);
@@ -588,13 +630,19 @@ function uninstallKenmarkFromIdes(skillNames, targetMap, { keepStore = true, dry
 
 module.exports = {
   VENDORED_PREFIXES,
+  AGENT_VENDORED_PREFIXES,
+  AGENT_IDE_SCAN_PRIORITY,
   getKenmarkHome,
   getStoreDir,
+  getAgentStoreDir,
   getManifestPath,
+  getAgentManifestPath,
   buildGlobalTargets,
   buildProjectTargets,
   buildInventoryRoots,
+  buildAgentInventoryRoots,
   isVendoredMirror,
+  isVendoredAgent,
   safeRealpath,
   readManifest,
   writeManifest,