skills 1.0.6 → 1.0.7

package/README.md

@@ -12,6 +12,7 @@ npx skills
 
 | Command | Description |
 |---------|-------------|
+| `skills init [name]` | Initialize a skill (`<name>/SKILL.md` or `./SKILL.md`) |
 | `skills add <package>` | Add a skill package |
 | `skills a <package>` | Alias for `add` |
 | `skills install <package>` | Alias for `add` |
@@ -24,8 +25,38 @@ npx skills
 | `skills find <query>` | Search for skills |
 | `skills update` | Update installed skills |
 
-## Example
+## Examples
 
 ```bash
+# Initialize skills (multiple skills per repo)
+npx skills init hydration-fix
+npx skills init waterfall-data-fetching
+
+# Add an existing skill package
 npx skills add vercel-labs/agent-skills
 ```
+
+## Skill Format
+
+Each skill lives in its own folder with a `SKILL.md` file:
+
+```
+my-repo/
+├── hydration-fix/
+│   └── SKILL.md
+└── waterfall-data-fetching/
+    └── SKILL.md
+```
+
+The `SKILL.md` file uses YAML frontmatter:
+
+```markdown
+---
+name: hydration-fix
+description: A brief description of what this skill does
+---
+
+# hydration-fix
+
+Instructions for the agent to follow when this skill is activated.
+```

package/dist/cli.js

@@ -2,6 +2,8 @@
 
 // src/cli.ts
 import { spawn } from "child_process";
+import { writeFileSync, existsSync, mkdirSync } from "fs";
+import { basename, join } from "path";
 var RESET = "\x1B[0m";
 var BOLD = "\x1B[1m";
 var DIM = "\x1B[38;5;102m";
@@ -34,6 +36,7 @@ function showBanner() {
   console.log(`${DIM}The open agent skills ecosystem${RESET}`);
   console.log();
   console.log(`  ${DIM}$${RESET} ${TEXT}npx skills --help${RESET}`);
+  console.log(`  ${DIM}$${RESET} ${TEXT}npx skills init ${DIM}[name]${RESET}`);
   console.log(`  ${DIM}$${RESET} ${TEXT}npx skills add ${DIM}[package]${RESET}`);
   console.log();
   console.log(`${DIM}try:${RESET} npx skills add vercel-labs/agent-skills`);
@@ -44,6 +47,7 @@ function showHelp() {
 ${BOLD}Usage:${RESET} skills <command> [options]
 
 ${BOLD}Commands:${RESET}
+  init [name]       Initialize a skill (creates <name>/SKILL.md or ./SKILL.md)
   add <package>     Add a skill package
                     e.g. vercel-labs/agent-skills
                          https://github.com/vercel-labs/agent-skills
@@ -53,6 +57,7 @@ ${BOLD}Options:${RESET}
   --version, -v     Show version number
 
 ${BOLD}Examples:${RESET}
+  ${DIM}$${RESET} skills init my-skill
   ${DIM}$${RESET} skills add vercel-labs/agent-skills
 `);
 }
@@ -65,6 +70,54 @@ function runAddSkill(packages) {
     process.exit(code ?? 0);
   });
 }
+function runInit(args) {
+  const cwd = process.cwd();
+  const skillName = args[0] || basename(cwd);
+  const hasName = args[0] !== undefined;
+  const skillDir = hasName ? join(cwd, skillName) : cwd;
+  const skillFile = join(skillDir, "SKILL.md");
+  const displayPath = hasName ? `${skillName}/SKILL.md` : "SKILL.md";
+  if (existsSync(skillFile)) {
+    console.log(`${TEXT}Skill already exists at ${DIM}${displayPath}${RESET}`);
+    return;
+  }
+  if (hasName) {
+    mkdirSync(skillDir, { recursive: true });
+  }
+  const skillContent = `---
+name: ${skillName}
+description: A brief description of what this skill does
+---
+
+# ${skillName}
+
+Instructions for the agent to follow when this skill is activated.
+
+## When to use
+
+Describe when this skill should be used.
+
+## Instructions
+
+1. First step
+2. Second step
+3. Additional steps as needed
+`;
+  writeFileSync(skillFile, skillContent);
+  console.log(`${TEXT}Initialized skill: ${DIM}${skillName}${RESET}`);
+  console.log();
+  console.log(`${DIM}Created:${RESET}`);
+  console.log(`  ${displayPath}`);
+  console.log();
+  console.log(`${DIM}Next steps:${RESET}`);
+  console.log(`  1. Edit ${TEXT}${displayPath}${RESET} to define your skill instructions`);
+  console.log(`  2. Update the ${TEXT}name${RESET} and ${TEXT}description${RESET} in the frontmatter`);
+  console.log();
+  console.log(`${DIM}Publishing:${RESET}`);
+  console.log(`  ${DIM}GitHub:${RESET}  Push to a repo, then ${TEXT}npx skills add <owner>/<repo>${RESET}`);
+  console.log(`  ${DIM}URL:${RESET}     Host the file, then ${TEXT}npx skills add https://example.com/${displayPath}${RESET}`);
+  console.log();
+}
 function main() {
   const args = process.argv.slice(2);
   if (args.length === 0) {
@@ -74,6 +127,11 @@ function main() {
   const command = args[0];
   const restArgs = args.slice(1);
   switch (command) {
+    case "init":
+      showLogo();
+      console.log();
+      runInit(restArgs);
+      break;
     case "i":
     case "install":
     case "a":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "The open agent skills ecosystem",
   "type": "module",
   "bin": {
@@ -13,6 +13,7 @@
   "scripts": {
     "build": "bun build ./src/cli.ts --outdir ./dist --target node",
     "dev": "bun run ./src/cli.ts",
+    "test": "vitest",
     "prepublishOnly": "bun run build"
   },
   "keywords": [
@@ -23,9 +24,7 @@
   ],
   "license": "MIT",
   "devDependencies": {
-    "@types/bun": "latest"
-  },
-  "peerDependencies": {
-    "typescript": "^5"
+    "@types/bun": "latest",
+    "vitest": "^4.0.17"
   }
 }