feat: skillman detect

AGENTS.md

@@ -10,6 +10,7 @@
 src/
 ├── cli.ts              # CLI entry point with parseArgs
 ├── config.ts           # skills.json config management
+├── detect.ts           # Project stack detection
 ├── skills.ts           # Skills CLI execution
 └── utils/
     ├── colors.ts       # ANSI color codes for terminal output
@@ -31,6 +32,10 @@ test/index.test.ts      # Tests using vitest
 - `installSkills(options?)` — Spawns `skills add` for each source with progress logging; options: `{ cwd?, agents?, global?, yes? }`
 - `installSkillSource(entry, options)` — Installs a single skill source; options: `{ cwd?, agents?, global?, yes?, prefix? }`
 
+### Detect (src/detect.ts)
+
+- `detectSkills(options?)` — Detects project stack using `skills-detector` and saves to `skills.json`; options: `{ cwd? }`
+
 ### CLI Entry (src/cli.ts)
 
 - `main(argv?)` — CLI entry point using Node.js `parseArgs`
@@ -71,6 +76,7 @@ interface SkillSource {
 skillman                                    # Install skills (default)
 skillman install, i [--global] [--agent <name>...]  # Install skills from skills.json
 skillman add <source>... [--agent <name>...]  # Add skill source(s) to skills.json
+skillman detect                             # Detect project stack and save to skills.json
 ```
 
 ### Source Format

README.md

@@ -38,12 +38,23 @@ This creates a `skills.json` file:
 }
 ```
 
+**Auto detect skills for current project:**
+
+```bash
+npx skillman detect
+```
+
+<p align="center">
+  <img src="./assets/detect.svg" alt="Install preview">
+</p>
+
 ## CLI Usage
 
 ```sh
 npx skillman                    # Install skills from skills.json (default)
 npx skillman install, i         # Same as above
 npx skillman add <source>...    # Add skill source(s) to skills.json
+npx skillman detect             # Detect project stack and save to skills.json
 ```
 
 ### Commands
@@ -75,6 +86,14 @@ npx skillman add <source>... [options]
 | `--agent <name>` | Target agent (default: `claude-code`, repeatable) |
 | `-h, --help`     | Show help                                         |
 
+#### `detect`
+
+Detects project stack (frameworks, languages, tools) and saves the information to `skills.json`. Uses [`skills-detector`](https://github.com/vercel-labs/skills-detector) under the hood.
+
+```sh
+npx skillman detect
+```
+
 ### Source Formats
 
 Sources can be specified in multiple formats:
@@ -115,6 +134,9 @@ npx skillman install --global
 
 # Install for multiple agents
 npx skillman install --agent claude-code --agent cursor
+
+# Detect project stack
+npx skillman detect
 ```
 
 ## Development

assets/gen.sh

@@ -9,9 +9,13 @@ rm -rf "$TMP_DIR" && mkdir -p "$TMP_DIR" && cd "$TMP_DIR"
 cleanup() { rm -rf "$TMP_DIR"; }
 trap cleanup EXIT
 
+SKILLMAN="node ../../src/cli.ts"
+
 # https://github.com/pamburus/termframe
 
-termframe -o "$SCRIPT_DIR/add.svg" --padding 2 -H auto --title "npx skillman add" -- pnpx skillman add skills.sh/vercel-labs/skills/find-skills anthropics/skills:skill-creator
+termframe -o "$SCRIPT_DIR/add.svg" --padding 2 -H auto --title "npx skillman add" -- $SKILLMAN add skills.sh/vercel-labs/skills/find-skills anthropics/skills:skill-creator
+
+termframe -o "$SCRIPT_DIR/install.svg" --padding 2 -H auto --title "npx skillman" -- $SKILLMAN
 
-termframe -o "$SCRIPT_DIR/install.svg" --padding 2 -H auto --title "npx skillman" -- pnpx skillman
+termframe -o "$SCRIPT_DIR/detect.svg" --padding 2 -H auto --title "npx skillman detect" -- $SKILLMAN detect
 

package.json

@@ -25,7 +25,8 @@
     "typecheck": "tsgo --noEmit --skipLibCheck"
   },
   "dependencies": {
-    "skills": "^1.3.1"
+    "skills": "^1.3.1",
+    "skills-detector": "link:../skills-detector"
   },
   "devDependencies": {
     "@types/node": "latest",

skills.json

@@ -13,5 +13,26 @@
         "skill-creator"
       ]
     }
-  ]
+  ],
+  "detected": {
+    "packageManager": "pnpm",
+    "frameworks": [],
+    "languages": [
+      "typescript",
+      "javascript"
+    ],
+    "tools": [],
+    "testing": [
+      "vitest",
+      "pytest",
+      "minitest"
+    ],
+    "searchTerms": [
+      "javascript",
+      "minitest",
+      "pytest",
+      "typescript",
+      "vitest"
+    ]
+  }
 }

skills_schema.json

@@ -30,6 +30,51 @@
           }
         }
       }
+    },
+    "detected": {
+      "type": "object",
+      "description": "Auto-detected project environment information",
+      "properties": {
+        "packageManager": {
+          "type": ["string", "null"],
+          "description": "Detected package manager (npm, yarn, pnpm, bun, deno)"
+        },
+        "frameworks": {
+          "type": "array",
+          "description": "Detected frameworks (e.g., nextjs, remix, rails, django)",
+          "items": {
+            "type": "string"
+          }
+        },
+        "languages": {
+          "type": "array",
+          "description": "Detected programming languages (e.g., typescript, python, go)",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tools": {
+          "type": "array",
+          "description": "Detected tools and libraries (e.g., prisma, tailwind, docker)",
+          "items": {
+            "type": "string"
+          }
+        },
+        "testing": {
+          "type": "array",
+          "description": "Detected testing frameworks (e.g., vitest, jest, playwright)",
+          "items": {
+            "type": "string"
+          }
+        },
+        "searchTerms": {
+          "type": "array",
+          "description": "Combined search terms for skill discovery",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
     }
   }
 }

src/cli.ts

@@ -4,6 +4,7 @@ import { parseArgs } from "node:util";
 
 import { c } from "./utils/colors.ts";
 import { addSkill, findSkillsConfig } from "./config.ts";
+import { detectSkills } from "./detect.ts";
 import { installSkillSource, installSkills } from "./skills.ts";
 
 const name = "skillman";
@@ -113,6 +114,11 @@ ${c.dim}$${c.reset} npx ${name} add ${c.cyan}vercel-labs/skills${c.reset}
     return;
   }
 
+  if (command === "detect") {
+    await detectSkills();
+    return;
+  }
+
   throw new Error(`Unknown command: ${command}`);
 }
 
@@ -154,6 +160,18 @@ ${c.bold}Examples:${c.reset}
     return;
   }
 
+  if (command === "detect") {
+    console.log(`
+${c.bold}Usage:${c.reset} ${c.cyan}${name} detect${c.reset}
+
+Detect project stack and save to skills.json.
+
+${c.bold}Examples:${c.reset}
+  ${c.dim}$${c.reset} npx ${name} detect
+`);
+    return;
+  }
+
   console.log(`
 ${c.bold}${name}${c.reset} ${c.dim}v${version}${c.reset}
 
@@ -164,6 +182,7 @@ ${c.bold}Usage:${c.reset} ${c.cyan}${name}${c.reset} <command> [options]
 ${c.bold}Commands:${c.reset}
   ${c.cyan}install, i${c.reset}        Install skills from skills.json ${c.dim}(default)${c.reset}
   ${c.cyan}add${c.reset}               Add a skill source to skills.json
+  ${c.cyan}detect${c.reset}            Detect project stack and save to skills.json
 
 ${c.bold}Options:${c.reset}
   ${c.cyan}-h, --help${c.reset}        Show help for a command

src/config.ts

@@ -1,9 +1,11 @@
 import { existsSync } from "node:fs";
 import { readFile, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
+import type { DetectionResult } from "skills-detector";
 
 export interface SkillsConfig {
   $schema?: string;
+  detected?: DetectionResult;
   skills: SkillSource[];
 }