ai-skills-manager 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 lwndev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,171 @@
+# AI Skills Manager
+
+AI Skills Manager (ASM) enables team members to create, test, distribute, install, update, and remove skills. It focuses on the [Claude Code Agent Skills](https://docs.claude.com/en/docs/claude-code/skills) system developed by Anthropic.
+
+## Installation
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) 18 or later
+- [npm](https://www.npmjs.com/) (comes with Node.js)
+
+### From Source
+
+```bash
+# Clone the repository
+git clone https://github.com/lwndev/ai-skills-manager.git
+cd ai-skills-manager
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Link the CLI globally (optional)
+npm link
+```
+
+## Usage
+
+### Create a New Skill
+
+Use the `scaffold` command to create a new Claude Code skill:
+
+```bash
+# Create a basic skill in .claude/skills/ (project scope)
+asm scaffold my-skill
+
+# Create a skill with a description
+asm scaffold my-skill --description "A helpful skill for code reviews"
+
+# Create a personal skill in ~/.claude/skills/
+asm scaffold my-skill --personal
+
+# Create a skill in a custom location
+asm scaffold my-skill --output ./custom/path
+
+# Specify allowed tools
+asm scaffold my-skill --allowed-tools "Read,Write,Bash"
+
+# Overwrite existing directory without prompting
+asm scaffold my-skill --force
+```
+
+#### Scaffold Options
+
+| Option | Description |
+|--------|-------------|
+| `-d, --description <text>` | Short description of the skill |
+| `-o, --output <path>` | Output directory path (overrides --project and --personal) |
+| `-p, --project` | Create as a project skill in `.claude/skills/` (default) |
+| `--personal` | Create as a personal skill in `~/.claude/skills/` |
+| `-a, --allowed-tools <tools>` | Comma-separated list of allowed tools |
+| `-f, --force` | Overwrite existing directory without prompting |
+
+#### Skill Name Requirements
+
+- Lowercase letters, numbers, and hyphens only
+- Cannot start or end with a hyphen
+- Cannot contain consecutive hyphens
+- Maximum 64 characters
+- Cannot use reserved words: "anthropic", "claude"
+
+#### Generated Structure
+
+```
+my-skill/
+  SKILL.md        # Skill instructions and metadata
+  scripts/        # Directory for skill scripts
+    .gitkeep
+```
+
+### Install a Skill
+
+*Coming soon*
+
+### Update a Skill
+
+*Coming soon*
+
+### Remove a Skill
+
+*Coming soon*
+
+## Development
+
+### Commands
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Run linting
+npm run lint
+
+# Run all quality checks
+npm run quality
+```
+
+### Project Structure
+
+```
+src/
+  cli.ts              # CLI entry point
+  commands/           # Command implementations
+  generators/         # File/directory generation
+  templates/          # Template generation
+  validators/         # Input validation
+  utils/              # Shared utilities
+
+tests/
+  unit/               # Unit tests (mirrors src/ structure)
+    generators/
+    templates/
+    utils/
+    validators/
+  integration/        # End-to-end tests
+```
+
+## Contributing
+
+Contributions are welcome! Please ensure:
+
+1. Tests pass: `npm test`
+2. Code is linted: `npm run lint`
+3. Coverage is maintained above 80%
+
+## FAQs
+
+**Q: Where are project skills stored?**
+A: In `.claude/skills/` within your project directory.
+
+**Q: Where are personal skills stored?**
+A: In `~/.claude/skills/` in your home directory.
+
+**Q: How do I test my skill?**
+A: After creating a skill, invoke it in Claude Code by name. Claude will discover skills in the standard locations.
+
+## Troubleshooting
+
+**Error: Invalid skill name**
+Ensure your skill name uses only lowercase letters, numbers, and hyphens. It cannot start or end with a hyphen.
+
+**Error: Directory already exists**
+Use the `--force` flag to overwrite, or choose a different name.
+
+**Command not found: asm**
+Run `npm link` after building, or use `node dist/cli.js` directly.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const scaffold_1 = require("./commands/scaffold");
+const program = new commander_1.Command();
+program
+    .name('asm')
+    .description('AI Skills Manager - CLI tool for managing Claude Code Agent Skills')
+    .version('1.0.0');
+(0, scaffold_1.registerScaffoldCommand)(program);
+program.parse();

package/dist/commands/scaffold.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerScaffoldCommand(program: Command): void;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/commands/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/commands/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmC9D"}

package/dist/commands/scaffold.js

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerScaffoldCommand = registerScaffoldCommand;
+const validators_1 = require("../validators");
+const scaffold_1 = require("../generators/scaffold");
+const errors_1 = require("../utils/errors");
+const output = __importStar(require("../utils/output"));
+function registerScaffoldCommand(program) {
+    program
+        .command('scaffold <name>')
+        .description('Create a new Claude Code skill with the required directory structure')
+        .option('-d, --description <description>', 'Short description of the skill')
+        .option('-o, --output <path>', 'Output directory path (overrides --project and --personal)')
+        .option('-p, --project', 'Create as a project skill in .claude/skills/')
+        .option('--personal', 'Create as a personal skill in ~/.claude/skills/')
+        .option('-a, --allowed-tools <tools>', 'Comma-separated list of allowed tools')
+        .option('-f, --force', 'Overwrite existing directory without prompting')
+        .addHelpText('after', `
+Examples:
+  $ asm scaffold my-skill
+  $ asm scaffold my-skill --description "A helpful skill"
+  $ asm scaffold my-skill --project --description "Project-specific skill"
+  $ asm scaffold my-skill --personal --description "Personal skill"
+  $ asm scaffold my-skill --output ./custom/path
+  $ asm scaffold my-skill --allowed-tools "Read,Write,Bash"
+  $ asm scaffold my-skill --force
+
+Note:
+  By default, skills are created in .claude/skills/ (project scope).
+  Use --personal to create in ~/.claude/skills/ (user scope).
+  Use --output to specify a custom directory.`)
+        .action((name, options) => __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield handleScaffold(name, options);
+        }
+        catch (error) {
+            handleError(error);
+            process.exit(1);
+        }
+    }));
+}
+function handleScaffold(name, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Validate skill name
+        const nameValidation = (0, validators_1.validateName)(name);
+        if (!nameValidation.valid) {
+            throw new errors_1.ValidationError(nameValidation.error || 'Invalid skill name');
+        }
+        // Validate description if provided
+        if (options.description) {
+            const descValidation = (0, validators_1.validateDescription)(options.description);
+            if (!descValidation.valid) {
+                throw new errors_1.ValidationError(descValidation.error || 'Invalid description');
+            }
+        }
+        // Parse allowed tools if provided
+        let allowedTools;
+        if (options.allowedTools) {
+            allowedTools = options.allowedTools
+                .split(',')
+                .map((tool) => tool.trim())
+                .filter((tool) => tool.length > 0);
+            if (allowedTools.length === 0) {
+                throw new errors_1.ValidationError('Allowed tools list cannot be empty');
+            }
+        }
+        // Create the scaffold
+        const result = yield (0, scaffold_1.createScaffold)({
+            name,
+            description: options.description,
+            allowedTools,
+            output: options.output,
+            project: options.project,
+            personal: options.personal,
+            force: options.force,
+        });
+        // Handle the result
+        if (!result.success) {
+            if (result.error === 'Operation cancelled by user') {
+                throw new errors_1.UserCancelledError();
+            }
+            throw new errors_1.FileSystemError(result.error || 'Unknown error occurred');
+        }
+        // Display success message
+        output.displayCreatedFiles(result.skillPath, result.filesCreated);
+        output.displayNextSteps(result.skillPath, name);
+    });
+}
+function handleError(error) {
+    if (error instanceof errors_1.ValidationError) {
+        output.displayValidationError('input', error.message);
+    }
+    else if (error instanceof errors_1.UserCancelledError) {
+        output.displayError(error.message);
+    }
+    else if (error instanceof errors_1.FileSystemError) {
+        output.displayError('File system error', error.message);
+    }
+    else if (error instanceof Error) {
+        output.displayError('Unexpected error', error.message);
+    }
+    else {
+        output.displayError('An unexpected error occurred', String(error));
+    }
+}

package/dist/generators/scaffold.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Scaffold generator
+ *
+ * Creates the directory structure and files for a new skill.
+ */
+export interface ScaffoldOptions {
+    name: string;
+    description?: string;
+    allowedTools?: string[];
+    output?: string;
+    project?: boolean;
+    personal?: boolean;
+    force?: boolean;
+}
+export interface ScaffoldResult {
+    success: boolean;
+    skillPath: string;
+    filesCreated: string[];
+    error?: string;
+}
+/**
+ * Resolve the output directory based on options
+ */
+export declare function resolveOutputPath(options: ScaffoldOptions): string;
+/**
+ * Check if a directory exists
+ */
+export declare function directoryExists(dirPath: string): Promise<boolean>;
+/**
+ * Prompt user for confirmation (used when directory exists)
+ */
+export declare function promptConfirmation(message: string): Promise<boolean>;
+/**
+ * Create the skill scaffold
+ */
+export declare function createScaffold(options: ScaffoldOptions): Promise<ScaffoldResult>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/generators/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/generators/scaffold.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAalE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAY1E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAyDtF"}

package/dist/generators/scaffold.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Scaffold generator
+ *
+ * Creates the directory structure and files for a new skill.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOutputPath = resolveOutputPath;
+exports.directoryExists = directoryExists;
+exports.promptConfirmation = promptConfirmation;
+exports.createScaffold = createScaffold;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const readline = __importStar(require("readline"));
+const skill_md_1 = require("../templates/skill-md");
+/**
+ * Resolve the output directory based on options
+ */
+function resolveOutputPath(options) {
+    // --output takes precedence
+    if (options.output) {
+        return path.resolve(options.output, options.name);
+    }
+    // --personal uses ~/.claude/skills/
+    if (options.personal) {
+        return path.join(os.homedir(), '.claude', 'skills', options.name);
+    }
+    // --project (default) uses .claude/skills/ in current directory
+    return path.join(process.cwd(), '.claude', 'skills', options.name);
+}
+/**
+ * Check if a directory exists
+ */
+function directoryExists(dirPath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const stat = yield fs.stat(dirPath);
+            return stat.isDirectory();
+        }
+        catch (_a) {
+            return false;
+        }
+    });
+}
+/**
+ * Prompt user for confirmation (used when directory exists)
+ */
+function promptConfirmation(message) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(`${message} (y/N): `, (answer) => {
+                rl.close();
+                resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+            });
+        });
+    });
+}
+/**
+ * Create the skill scaffold
+ */
+function createScaffold(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const skillPath = resolveOutputPath(options);
+        const filesCreated = [];
+        // Check if directory already exists
+        if (yield directoryExists(skillPath)) {
+            if (!options.force) {
+                const confirmed = yield promptConfirmation(`Directory "${skillPath}" already exists. Overwrite?`);
+                if (!confirmed) {
+                    return {
+                        success: false,
+                        skillPath,
+                        filesCreated: [],
+                        error: 'Operation cancelled by user',
+                    };
+                }
+            }
+        }
+        try {
+            // Create skill directory
+            yield fs.mkdir(skillPath, { recursive: true });
+            // Create scripts directory with .gitkeep
+            const scriptsPath = path.join(skillPath, 'scripts');
+            yield fs.mkdir(scriptsPath, { recursive: true });
+            const gitkeepPath = path.join(scriptsPath, '.gitkeep');
+            yield fs.writeFile(gitkeepPath, '');
+            filesCreated.push(gitkeepPath);
+            // Generate and write SKILL.md
+            const templateParams = {
+                name: options.name,
+                description: options.description,
+                allowedTools: options.allowedTools,
+            };
+            const skillMdContent = (0, skill_md_1.generateSkillMd)(templateParams);
+            const skillMdPath = path.join(skillPath, 'SKILL.md');
+            yield fs.writeFile(skillMdPath, skillMdContent, 'utf-8');
+            filesCreated.push(skillMdPath);
+            return {
+                success: true,
+                skillPath,
+                filesCreated,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                skillPath,
+                filesCreated,
+                error: `Failed to create scaffold: ${errorMessage}`,
+            };
+        }
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";
+console.log('Happy developing ✨');

package/dist/templates/skill-md.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SKILL.md template generator
+ *
+ * Generates the SKILL.md file content with YAML frontmatter and markdown body.
+ */
+export interface SkillTemplateParams {
+    name: string;
+    description?: string;
+    allowedTools?: string[];
+}
+/**
+ * Generate the complete SKILL.md content
+ */
+export declare function generateSkillMd(params: SkillTemplateParams): string;
+//# sourceMappingURL=skill-md.d.ts.map

package/dist/templates/skill-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../src/templates/skill-md.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAgJD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAInE"}

package/dist/templates/skill-md.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * SKILL.md template generator
+ *
+ * Generates the SKILL.md file content with YAML frontmatter and markdown body.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSkillMd = generateSkillMd;
+/**
+ * Escape a string for use in YAML values.
+ * Wraps in double quotes if it contains special characters.
+ */
+function escapeYamlString(value) {
+    const needsQuotes = value.includes(':') ||
+        value.includes('#') ||
+        value.includes("'") ||
+        value.includes('"') ||
+        value.includes('\n') ||
+        value.includes('\\') ||
+        value.startsWith(' ') ||
+        value.endsWith(' ') ||
+        value.startsWith('-') ||
+        value.startsWith('[') ||
+        value.startsWith('{') ||
+        /^(true|false|null|yes|no|on|off)$/i.test(value);
+    if (!needsQuotes) {
+        return value;
+    }
+    // Use double quotes and escape internal double quotes and backslashes
+    const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    return `"${escaped}"`;
+}
+/**
+ * Generate YAML frontmatter for the skill
+ */
+function generateFrontmatter(params) {
+    const lines = ['---'];
+    lines.push(`name: ${escapeYamlString(params.name)}`);
+    if (params.description) {
+        lines.push(`description: ${escapeYamlString(params.description)}`);
+    }
+    else {
+        lines.push('description: "TODO: Add a short description of what this skill does"');
+    }
+    if (params.allowedTools && params.allowedTools.length > 0) {
+        lines.push('allowed-tools:');
+        for (const tool of params.allowedTools) {
+            lines.push(`  - ${escapeYamlString(tool.trim())}`);
+        }
+    }
+    else {
+        lines.push('# allowed-tools:');
+        lines.push('#   - Bash');
+        lines.push('#   - Read');
+        lines.push('#   - Write');
+        lines.push('#   - Edit');
+        lines.push('#   - Glob');
+        lines.push('#   - Grep');
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+/**
+ * Generate the markdown body with guidance and TODO placeholders
+ */
+function generateBody(params) {
+    return `
+# ${params.name}
+
+## Overview
+
+TODO: Describe what this skill does and when Claude should use it.
+
+## Usage
+
+TODO: Explain how to invoke this skill and any required context.
+
+## Examples
+
+TODO: Provide examples of prompts that trigger this skill.
+
+### Example 1
+
+\`\`\`
+User: [example prompt]
+Claude: [expected behavior]
+\`\`\`
+
+## Implementation Notes
+
+TODO: Add any implementation details, edge cases, or important considerations.
+
+<!--
+================================================================================
+SKILL DEVELOPMENT GUIDANCE
+================================================================================
+
+This file defines a Claude Code skill. Skills are markdown files with YAML
+frontmatter that teach Claude how to perform specific tasks.
+
+FRONTMATTER FIELDS:
+- name: (required) Unique identifier for this skill
+- description: (required) Brief description shown in skill listings. This is the
+  PRIMARY triggering mechanism - include all "when to use" information here.
+- allowed-tools: (optional) List of tools this skill can use
+- license: (optional) License for the skill (e.g., "MIT", "Apache-2.0")
+
+BEST PRACTICES:
+1. Keep skills focused on a single task or related set of tasks
+2. Put ALL trigger conditions in the description field, not the body
+3. Provide clear examples of expected behavior
+4. Include edge cases and error handling guidance
+5. Keep the total skill file under 500 lines for optimal performance
+
+DESCRIPTION PATTERNS:
+Use these patterns in your description for reliable triggering:
+- "Use when the user wants to..."
+- "Apply this skill for..."
+- "This skill should be used when..."
+
+ALLOWED TOOLS:
+Common tools you can specify in allowed-tools:
+- Bash: Execute shell commands
+- Read: Read file contents
+- Write: Write/create files
+- Edit: Edit existing files
+- Glob: Find files by pattern
+- Grep: Search file contents
+- WebFetch: Fetch web content
+- WebSearch: Search the web
+
+If no allowed-tools are specified, the skill inherits default tool access.
+
+SCRIPTS DIRECTORY:
+The scripts/ subdirectory can contain helper scripts that your skill
+references. These are executed via the Bash tool when needed.
+
+For more information, see: https://docs.anthropic.com/en/docs/claude-code
+================================================================================
+-->
+`;
+}
+/**
+ * Generate the complete SKILL.md content
+ */
+function generateSkillMd(params) {
+    const frontmatter = generateFrontmatter(params);
+    const body = generateBody(params);
+    return frontmatter + '\n' + body;
+}

package/dist/utils/errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Error types for the AI Skills Manager CLI
+ */
+/**
+ * Base error class for ASM errors
+ */
+export declare class ASMError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validation error - thrown when user input fails validation
+ */
+export declare class ValidationError extends ASMError {
+    constructor(message: string);
+}
+/**
+ * File system error - thrown when file operations fail
+ */
+export declare class FileSystemError extends ASMError {
+    constructor(message: string);
+}
+/**
+ * User cancelled error - thrown when user cancels an operation
+ */
+export declare class UserCancelledError extends ASMError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,GAAE,MAAsC;CAG5D"}

package/dist/utils/errors.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Error types for the AI Skills Manager CLI
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserCancelledError = exports.FileSystemError = exports.ValidationError = exports.ASMError = void 0;
+/**
+ * Base error class for ASM errors
+ */
+class ASMError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.ASMError = ASMError;
+/**
+ * Validation error - thrown when user input fails validation
+ */
+class ValidationError extends ASMError {
+    constructor(message) {
+        super(message);
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * File system error - thrown when file operations fail
+ */
+class FileSystemError extends ASMError {
+    constructor(message) {
+        super(message);
+    }
+}
+exports.FileSystemError = FileSystemError;
+/**
+ * User cancelled error - thrown when user cancels an operation
+ */
+class UserCancelledError extends ASMError {
+    constructor(message = 'Operation cancelled by user') {
+        super(message);
+    }
+}
+exports.UserCancelledError = UserCancelledError;

package/dist/utils/output.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Output formatting utilities for the CLI
+ */
+/**
+ * Format a success message with a checkmark
+ */
+export declare function success(message: string): string;
+/**
+ * Format an error message
+ */
+export declare function error(message: string): string;
+/**
+ * Format a warning message
+ */
+export declare function warning(message: string): string;
+/**
+ * Format an info message
+ */
+export declare function info(message: string): string;
+/**
+ * Format a file path display
+ */
+export declare function filePath(path: string): string;
+/**
+ * Display created files structure
+ */
+export declare function displayCreatedFiles(skillPath: string, filesCreated: string[]): void;
+/**
+ * Display next steps after successful scaffold
+ */
+export declare function displayNextSteps(skillPath: string, _skillName: string): void;
+/**
+ * Display error with context
+ */
+export declare function displayError(message: string, context?: string): void;
+/**
+ * Display validation error with examples
+ */
+export declare function displayValidationError(field: string, errorMessage: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CASnF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAS5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAKpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAGhF"}

package/dist/utils/output.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Output formatting utilities for the CLI
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.success = success;
+exports.error = error;
+exports.warning = warning;
+exports.info = info;
+exports.filePath = filePath;
+exports.displayCreatedFiles = displayCreatedFiles;
+exports.displayNextSteps = displayNextSteps;
+exports.displayError = displayError;
+exports.displayValidationError = displayValidationError;
+/**
+ * Format a success message with a checkmark
+ */
+function success(message) {
+    return `✓ ${message}`;
+}
+/**
+ * Format an error message
+ */
+function error(message) {
+    return `✗ Error: ${message}`;
+}
+/**
+ * Format a warning message
+ */
+function warning(message) {
+    return `⚠ ${message}`;
+}
+/**
+ * Format an info message
+ */
+function info(message) {
+    return `ℹ ${message}`;
+}
+/**
+ * Format a file path display
+ */
+function filePath(path) {
+    return `  ${path}`;
+}
+/**
+ * Display created files structure
+ */
+function displayCreatedFiles(skillPath, filesCreated) {
+    console.log(success('Skill scaffolded successfully!'));
+    console.log('\nCreated:');
+    console.log(filePath(skillPath + '/'));
+    for (const file of filesCreated) {
+        // Show relative path from skill directory
+        const relativePath = file.replace(skillPath + '/', '');
+        console.log(filePath('  ' + relativePath));
+    }
+}
+/**
+ * Display next steps after successful scaffold
+ */
+function displayNextSteps(skillPath, _skillName) {
+    console.log('\nNext steps:');
+    console.log('  1. Edit the SKILL.md file to add your skill instructions');
+    console.log('  2. Add any scripts to the scripts/ directory');
+    console.log('  3. Test your skill by invoking it in Claude Code');
+    console.log('\nDocumentation:');
+    console.log('  https://docs.claude.com/en/docs/claude-code/skills');
+    console.log('\nSkill location:');
+    console.log(filePath(skillPath));
+}
+/**
+ * Display error with context
+ */
+function displayError(message, context) {
+    console.error(error(message));
+    if (context) {
+        console.error(`  ${context}`);
+    }
+}
+/**
+ * Display validation error with examples
+ */
+function displayValidationError(field, errorMessage) {
+    console.error(error(`Invalid ${field}`));
+    console.error(`  ${errorMessage}`);
+}

package/dist/validators/description.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Skill description validation
+ *
+ * Rules:
+ * - Non-empty
+ * - Maximum length: 1024 characters
+ * - Cannot contain angle brackets (< or >) to prevent XML injection
+ */
+import { ValidationResult } from './name';
+export declare function validateDescription(description: string): ValidationResult;
+//# sourceMappingURL=description.d.ts.map

package/dist/validators/description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description.d.ts","sourceRoot":"","sources":["../../src/validators/description.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAI1C,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CA0BzE"}

package/dist/validators/description.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Skill description validation
+ *
+ * Rules:
+ * - Non-empty
+ * - Maximum length: 1024 characters
+ * - Cannot contain angle brackets (< or >) to prevent XML injection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDescription = validateDescription;
+const MAX_LENGTH = 1024;
+function validateDescription(description) {
+    // Check for empty description
+    if (!description || description.trim() === '') {
+        return {
+            valid: false,
+            error: 'Description cannot be empty',
+        };
+    }
+    // Check maximum length
+    if (description.length > MAX_LENGTH) {
+        return {
+            valid: false,
+            error: `Description must be ${MAX_LENGTH} characters or less (got ${description.length})`,
+        };
+    }
+    // Check for angle brackets (XML tag prevention)
+    if (description.includes('<') || description.includes('>')) {
+        return {
+            valid: false,
+            error: 'Description cannot contain angle brackets (< or >)',
+        };
+    }
+    return { valid: true };
+}

package/dist/validators/frontmatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Frontmatter key validation
+ *
+ * Rules:
+ * - Only allowed top-level keys: name, description, license, allowed-tools, metadata
+ * - Reject any unexpected top-level keys
+ */
+import { ValidationResult } from './name';
+export interface FrontmatterData {
+    [key: string]: unknown;
+}
+export declare function validateFrontmatterKeys(frontmatter: FrontmatterData): ValidationResult;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/validators/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/validators/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAU1C,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,eAAe,GAC3B,gBAAgB,CAwBlB"}

package/dist/validators/frontmatter.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Frontmatter key validation
+ *
+ * Rules:
+ * - Only allowed top-level keys: name, description, license, allowed-tools, metadata
+ * - Reject any unexpected top-level keys
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFrontmatterKeys = validateFrontmatterKeys;
+const ALLOWED_KEYS = new Set([
+    'name',
+    'description',
+    'license',
+    'allowed-tools',
+    'metadata',
+]);
+function validateFrontmatterKeys(frontmatter) {
+    const keys = Object.keys(frontmatter);
+    // Check for empty frontmatter
+    if (keys.length === 0) {
+        return {
+            valid: false,
+            error: 'Frontmatter cannot be empty',
+        };
+    }
+    // Check for unexpected keys
+    const unexpectedKeys = keys.filter((key) => !ALLOWED_KEYS.has(key));
+    if (unexpectedKeys.length > 0) {
+        return {
+            valid: false,
+            error: `Unexpected frontmatter keys: ${unexpectedKeys.join(', ')}. ` +
+                `Allowed keys are: ${Array.from(ALLOWED_KEYS).join(', ')}`,
+        };
+    }
+    return { valid: true };
+}

package/dist/validators/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Validators barrel export
+ */
+export { ValidationResult, validateName } from './name';
+export { validateDescription } from './description';
+export { FrontmatterData, validateFrontmatterKeys } from './frontmatter';
+//# sourceMappingURL=index.d.ts.map

package/dist/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/dist/validators/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Validators barrel export
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFrontmatterKeys = exports.validateDescription = exports.validateName = void 0;
+var name_1 = require("./name");
+Object.defineProperty(exports, "validateName", { enumerable: true, get: function () { return name_1.validateName; } });
+var description_1 = require("./description");
+Object.defineProperty(exports, "validateDescription", { enumerable: true, get: function () { return description_1.validateDescription; } });
+var frontmatter_1 = require("./frontmatter");
+Object.defineProperty(exports, "validateFrontmatterKeys", { enumerable: true, get: function () { return frontmatter_1.validateFrontmatterKeys; } });

package/dist/validators/name.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Skill name validation
+ *
+ * Rules:
+ * - Pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ (lowercase alphanumeric with hyphens, no leading/trailing/consecutive hyphens)
+ * - Maximum length: 64 characters
+ * - Reserved words: "anthropic", "claude" (cannot be used as the name or as part of the name)
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+export declare function validateName(name: string): ValidationResult;
+//# sourceMappingURL=name.d.ts.map

package/dist/validators/name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.d.ts","sourceRoot":"","sources":["../../src/validators/name.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAuC3D"}

package/dist/validators/name.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Skill name validation
+ *
+ * Rules:
+ * - Pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ (lowercase alphanumeric with hyphens, no leading/trailing/consecutive hyphens)
+ * - Maximum length: 64 characters
+ * - Reserved words: "anthropic", "claude" (cannot be used as the name or as part of the name)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateName = validateName;
+const NAME_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+const MAX_LENGTH = 64;
+const RESERVED_WORDS = ['anthropic', 'claude'];
+function validateName(name) {
+    // Check for empty name
+    if (!name || name.trim() === '') {
+        return {
+            valid: false,
+            error: 'Skill name cannot be empty',
+        };
+    }
+    // Check maximum length
+    if (name.length > MAX_LENGTH) {
+        return {
+            valid: false,
+            error: `Skill name must be ${MAX_LENGTH} characters or less (got ${name.length})`,
+        };
+    }
+    // Check pattern (lowercase alphanumeric with hyphens)
+    if (!NAME_PATTERN.test(name)) {
+        return {
+            valid: false,
+            error: 'Skill name must contain only lowercase letters, numbers, and hyphens. ' +
+                'Cannot start or end with a hyphen, or have consecutive hyphens. ' +
+                `Example: "my-skill-name" (got "${name}")`,
+        };
+    }
+    // Check reserved words
+    for (const reserved of RESERVED_WORDS) {
+        if (name === reserved || name.includes(reserved)) {
+            return {
+                valid: false,
+                error: `Skill name cannot contain reserved word "${reserved}"`,
+            };
+        }
+    }
+    return { valid: true };
+}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "ai-skills-manager",
+  "version": "1.0.0",
+  "description": "AI Skills Manager - CLI tool for managing Claude Code Agent Skills",
+  "author": "lwndev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lwndev/ai-skills-manager.git"
+  },
+  "homepage": "https://github.com/lwndev/ai-skills-manager#readme",
+  "bugs": {
+    "url": "https://github.com/lwndev/ai-skills-manager/issues"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "skills",
+    "cli",
+    "anthropic"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "asm": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "audit": "npm audit --audit-level=moderate",
+    "audit:fix": "npm audit fix",
+    "quality": "npm run lint && npm run test:coverage && npm run audit",
+    "prepare": "husky",
+    "prepublishOnly": "npm run quality && npm run build",
+    "preversion": "npm run build && npm test && npm run lint",
+    "version": "git add package.json package-lock.json",
+    "postversion": "git push && git push --tags",
+    "release:patch": "npm version patch",
+    "release:minor": "npm version minor",
+    "release:major": "npm version major"
+  },
+  "dependencies": {
+    "commander": "^14.0.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.17.10",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "jest": "^30.2.0",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.7.4",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.5.3"
+  }
+}