@patricio0312rev/skillset 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-01-01
+
+### Added
+- Initial release of SkillSet CLI
+- Support for 100+ production-ready development skills
+- Interactive CLI for skill selection and import
+- Support for Claude Code, Cursor, GitHub Copilot, and other AI tools
+- 10 specialized domains: Foundation, Frontend, Backend, AI Engineering, Architecture, CI/CD, Database, Testing, Security, Performance
+- Programmatic API for integration with other tools
+- Tool-specific folder configurations
+- Automatic skill file copying with references and templates
+- README generation for imported skills
+- Non-interactive mode with command-line flags
+- Short alias `ss` for quick access
+
+### Features
+- **Claude Code Support**: `.claude/skills/` with automatic loading
+- **Cursor Support**: `.cursor/rules/` with @-mention integration
+- **GitHub Copilot Support**: `.github/skills/` or `.claude/skills/` for Agent Skills
+- **Universal Format**: Works with any AI coding assistant
+
+[0.1.0]: https://github.com/patricio0312rev/skillset/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Patricio Marroquin
+
+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,176 @@
+# SkillSet 📚
+
+**Import production-ready development skills for Claude Code, Cursor, GitHub Copilot, and other AI coding assistants**
+
+SkillSet is a CLI tool that helps you quickly import and configure development skills from a comprehensive library of 100+ production-ready skills covering every aspect of modern software engineering.
+
+## Features
+
+- **100+ Production-Ready Skills** - From project setup to deployment, security to AI engineering
+- **Multi-Tool Support** - Works with Claude Code, Cursor, GitHub Copilot, and more
+- **10 Specialized Domains** - Foundation, Frontend, Backend, AI Engineering, Architecture, CI/CD, Database, Testing, Security, Performance
+- **Interactive CLI** - Easy-to-use interface for selecting and importing skills
+- **Programmatic API** - Use SkillSet in your own tools and scripts
+
+## Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @patricio0312rev/skillset
+```
+
+### Use with npx (No Installation)
+
+```bash
+npx @patricio0312rev/skillset init
+```
+
+## Quick Start
+
+Initialize skills in your project:
+
+```bash
+skillset init
+```
+
+Or use the short alias:
+
+```bash
+ss init
+```
+
+The interactive CLI will guide you through:
+
+1. **Select your AI tool** - Claude Code, Cursor, GitHub Copilot, or Other
+2. **Choose your folder** - Default locations based on your tool
+3. **Pick domains** - Select from 10 specialized domains
+4. **Select skills** - Choose specific skills from each domain
+
+## Usage Examples
+
+### Interactive Mode (Default)
+
+```bash
+skillset init
+```
+
+### Non-Interactive Mode
+
+```bash
+skillset init \
+  --tool claude-code \
+  --folder .claude/skills \
+  --domains backend,frontend,testing \
+  --skills api-endpoint-generator,unit-test-generator
+```
+
+### Skip All Prompts
+
+```bash
+skillset init \
+  --tool cursor \
+  --domains backend,testing \
+  --skip-prompts
+```
+
+## Available Domains
+
+| Domain | Skills | Description |
+|--------|--------|-------------|
+| 🔧 Foundation | 11 | Project setup, development environment, and documentation |
+| 🎨 Frontend | 10 | React, UI components, and user experience |
+| ⚙️ Backend | 10 | APIs, authentication, and server-side logic |
+| 🤖 AI Engineering | 10 | LLMs, RAG, agents, and AI systems |
+| 🏗️ Architecture | 10 | System design, scalability, and technical decisions |
+| 🔄 CI/CD | 10 | Automation, deployments, and release management |
+| 💾 Database Management | 10 | Migrations, optimization, and data engineering |
+| 🧪 Testing | 10 | Quality assurance and test coverage |
+| 🔒 Security | 10 | Security hardening and privacy protection |
+| 📊 Performance | 10 | Observability, monitoring, and optimization |
+
+## Tool-Specific Configurations
+
+### Claude Code
+- **Folder**: `.claude/skills/`
+- **Format**: `SKILL.md` with YAML frontmatter
+- **Usage**: Skills are automatically loaded
+
+### Cursor
+- **Folder**: `.cursor/rules/`
+- **Format**: `RULE.md`
+- **Usage**: Use @-mentions to reference skills
+
+### GitHub Copilot (Agent Skills)
+- **Folder**: `.github/skills/` (also supports `.claude/skills/`)
+- **Format**: `SKILL.md` with YAML frontmatter
+- **Usage**: Automatically recognized by Copilot
+
+### Other Tools
+- **Folder**: `.claude/skills/`
+- **Format**: Universal `SKILL.md` format
+- **Usage**: Upload or reference in your AI tool
+
+## Programmatic API
+
+Use SkillSet in your own tools:
+
+```javascript
+const skillset = require('@patricio0312rev/skillset');
+
+// Generate skills configuration
+const result = await skillset.generate({
+  tool: 'claude-code',
+  folder: '.claude/skills',
+  domains: ['backend', 'frontend'],
+  skills: ['api-endpoint-generator', 'unit-test-generator']
+});
+
+console.log(`Generated ${result.skillsGenerated} skills`);
+
+// Get available domains
+const domains = skillset.getDomains();
+console.log(Object.keys(domains));
+
+// Get skills for a specific domain
+const backendSkills = skillset.getSkillsForDomain('backend');
+console.log(backendSkills);
+```
+
+## CLI Options
+
+```bash
+skillset init [options]
+
+Options:
+  -t, --tool <tool>        AI tool (claude-code, cursor, copilot, other)
+  -f, --folder <name>      Custom folder name
+  -d, --domains <list>     Comma-separated list of domains
+  --skills <list>          Comma-separated list of specific skills
+  --skip-prompts           Skip all interactive prompts (requires all flags)
+  -h, --help              Display help for command
+  -V, --version           Output the version number
+```
+
+## Contributing
+
+Contributions are welcome! Please check out the [contribution guidelines](https://github.com/patricio0312rev/skillset/blob/main/CONTRIBUTING.md).
+
+## Related Projects
+
+- [Skills Collection](https://github.com/patricio0312rev/skills) - The complete library of 100+ skills
+- [AgentKit](https://github.com/patricio0312rev/agentkit) - Scaffold AI agent configurations
+
+## License
+
+MIT License - See [LICENSE](LICENSE) for details
+
+## Author
+
+**Patricio Marroquin**
+- Website: [patriciomarroquin.dev](https://www.patriciomarroquin.dev)
+- GitHub: [@patricio0312rev](https://github.com/patricio0312rev)
+
+---
+
+Made with 💜 by [Patricio Marroquin](https://www.patriciomarroquin.dev)

package/bin/cli.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+const { program } = require("commander");
+const chalk = require("chalk");
+const packageJson = require("../package.json");
+const { displayBanner } = require("../src/utils/display");
+const initCommand = require("../src/commands/init");
+
+// Display banner
+displayBanner();
+
+program
+  .name("skillset")
+  .description(
+    "Import production-ready development skills for Claude Code, Cursor, Copilot, and more"
+  )
+  .version(packageJson.version);
+
+program
+  .command("init")
+  .description("Initialize development skills in current directory")
+  .option(
+    "-t, --tool <tool>",
+    "AI tool (claude-code, cursor, copilot, other)"
+  )
+  .option("-f, --folder <name>", "Custom folder name")
+  .option("-d, --domains <list>", "Comma-separated list of domains")
+  .option("--skills <list>", "Comma-separated list of specific skills")
+  .option("--skip-prompts", "Skip all interactive prompts (requires all flags)")
+  .action(initCommand);
+
+program.parse(process.argv);
+
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@patricio0312rev/skillset",
+  "displayName": "Skillset",
+  "version": "0.1.0",
+  "description": "CLI tool to import production-ready development skills for Claude Code, Cursor, GitHub Copilot, and other AI coding assistants",
+  "main": "src/index.js",
+  "bin": {
+    "skillset": "./bin/cli.js",
+    "ss": "./bin/cli.js"
+  },
+  "scripts": {
+    "start": "node bin/cli.js",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "echo 'Ready to publish skillset!'"
+  },
+  "keywords": [
+    "ai",
+    "skills",
+    "claude",
+    "cursor",
+    "copilot",
+    "claude-code",
+    "ai-skills",
+    "cli",
+    "scaffolding",
+    "development-skills",
+    "ai-tools",
+    "skillset",
+    "agent-skills"
+  ],
+  "author": "Patricio Marroquin <patricio0312rev@github>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/patricio0312rev/skillset.git"
+  },
+  "bugs": {
+    "url": "https://github.com/patricio0312rev/skillset/issues"
+  },
+  "homepage": "https://github.com/patricio0312rev/skillset#readme",
+  "devDependencies": {
+    "eslint": "^8.56.0",
+    "prettier": "^3.1.1"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^8.2.6",
+    "ora": "^5.4.1"
+  }
+}

package/src/commands/init.js

@@ -0,0 +1,301 @@
+const inquirer = require("inquirer");
+const chalk = require("chalk");
+const ora = require("ora");
+const { generateSkills } = require("../lib/generator");
+const { TOOLS, DOMAINS } = require("../lib/config");
+const { displayError, displayBox } = require("../utils/display");
+
+async function initCommand(options) {
+  console.log(chalk.cyan("\n📚 Let's import your development skills!\n"));
+
+  try {
+    let config = {};
+
+    // Check if all required options provided (non-interactive mode)
+    if (options.skipPrompts) {
+      if (!options.tool || !options.domains) {
+        displayError("--skip-prompts requires --tool and --domains flags");
+        process.exit(1);
+      }
+      config = buildConfigFromFlags(options);
+    } else {
+      // Interactive mode
+      config = await promptUser(options);
+    }
+
+    // Validate configuration
+    const validation = validateConfiguration(config);
+    if (!validation.isValid) {
+      displayError("Configuration validation failed:");
+      validation.errors.forEach((err) => console.log(chalk.red(`  • ${err}`)));
+      process.exit(1);
+    }
+
+    // Generate the configuration
+    await generateConfiguration(config);
+  } catch (error) {
+    displayError(`Failed to initialize: ${error.message}`);
+    if (process.env.DEBUG) {
+      console.error(error);
+    }
+    process.exit(1);
+  }
+}
+
+function buildConfigFromFlags(options) {
+  return {
+    tool: options.tool,
+    folder: options.folder || TOOLS[options.tool]?.folder || ".claude/skills",
+    domains: options.domains.split(",").map((d) => d.trim()),
+    skills: options.skills
+      ? options.skills.split(",").map((s) => s.trim())
+      : [],
+  };
+}
+
+async function promptUser(options) {
+  const answers = {};
+
+  // Step 1: Select AI tool
+  if (!options.tool) {
+    const toolChoices = Object.entries(TOOLS).map(([key, value]) => ({
+      name: `${chalk.bold(value.name)} ${chalk.dim("→")} ${chalk.gray(value.description)}`,
+      value: key,
+      short: value.name,
+    }));
+
+    const toolAnswer = await inquirer.prompt([
+      {
+        type: "list",
+        name: "tool",
+        message: "Which AI tool are you using?",
+        choices: toolChoices,
+        default: "claude-code",
+      },
+    ]);
+    answers.tool = toolAnswer.tool;
+  } else {
+    answers.tool = options.tool;
+  }
+
+  // Step 2: Custom folder name
+  const defaultFolder = TOOLS[answers.tool].folder;
+  if (!options.folder) {
+    const folderAnswer = await inquirer.prompt([
+      {
+        type: "input",
+        name: "folder",
+        message: "Folder name for skills:",
+        default: defaultFolder,
+        validate: (input) => {
+          if (!input.trim()) return "Folder name cannot be empty";
+          if (input.includes(" ")) return "Folder name cannot contain spaces";
+          if (input.includes("\\"))
+            return "Folder name cannot contain backslashes";
+          return true;
+        },
+      },
+    ]);
+    answers.folder = folderAnswer.folder;
+  } else {
+    answers.folder = options.folder;
+  }
+
+  // Step 3: Select domains
+  if (!options.domains) {
+    const domainChoices = Object.entries(DOMAINS).map(([key, value]) => ({
+      name: `${chalk.bold(value.name)} ${chalk.dim(`(${value.skills.length} skills)`)} ${chalk.gray("→ " + value.description)}`,
+      value: key,
+      short: value.name,
+      checked: ["foundation"].includes(key), // Default selections
+    }));
+
+    const domainAnswer = await inquirer.prompt([
+      {
+        type: "checkbox",
+        name: "domains",
+        message: "Select domains to include:",
+        choices: domainChoices,
+        pageSize: 12,
+        validate: (input) => {
+          if (input.length === 0)
+            return "Please select at least one domain";
+          return true;
+        },
+      },
+    ]);
+    answers.domains = domainAnswer.domains;
+  } else {
+    answers.domains = options.domains.split(",").map((d) => d.trim());
+  }
+
+  // Step 4: Select specific skills per domain
+  answers.skills = [];
+
+  if (!options.skills) {
+    console.log(chalk.cyan("\n📋 Select skills for each domain:\n"));
+
+    for (const domain of answers.domains) {
+      const domainInfo = DOMAINS[domain];
+
+      const skillChoices = domainInfo.skills.map((skill) => ({
+        name: skill,
+        value: `${domain}/${skill}`,
+        checked: true, // All selected by default
+      }));
+
+      const skillAnswer = await inquirer.prompt([
+        {
+          type: "checkbox",
+          name: "selectedSkills",
+          message: `${chalk.bold(domainInfo.name)} skills:`,
+          choices: skillChoices,
+          pageSize: 15,
+          validate: (input) => {
+            if (input.length === 0) {
+              return `Please select at least one skill from ${domainInfo.name} (or deselect the domain)`;
+            }
+            return true;
+          },
+        },
+      ]);
+
+      answers.skills.push(...skillAnswer.selectedSkills);
+    }
+  } else {
+    answers.skills = options.skills.split(",").map((s) => s.trim());
+  }
+
+  // Count total skills selected
+  const totalSkills = answers.skills.length;
+  console.log(
+    chalk.dim(`\n  → Total skills selected: ${chalk.bold(totalSkills)}\n`)
+  );
+
+  return answers;
+}
+
+function validateConfiguration(config) {
+  const errors = [];
+
+  // Validate tool
+  if (!config.tool || !TOOLS[config.tool]) {
+    errors.push(
+      `Invalid tool: ${config.tool}. Valid options: ${Object.keys(TOOLS).join(", ")}`
+    );
+  }
+
+  // Validate folder
+  if (!config.folder || typeof config.folder !== "string") {
+    errors.push("Folder name is required and must be a string");
+  }
+
+  // Validate domains
+  if (
+    !config.domains ||
+    !Array.isArray(config.domains) ||
+    config.domains.length === 0
+  ) {
+    errors.push("At least one domain is required");
+  }
+
+  config.domains?.forEach((domain) => {
+    if (!DOMAINS[domain]) {
+      errors.push(
+        `Invalid domain: ${domain}. Valid options: ${Object.keys(DOMAINS).join(", ")}`
+      );
+    }
+  });
+
+  return {
+    isValid: errors.length === 0,
+    errors,
+  };
+}
+
+async function generateConfiguration(config) {
+  const spinner = ora("Generating skills configuration...").start();
+
+  try {
+    const result = await generateSkills(config);
+
+    spinner.succeed(chalk.green("✓ Configuration generated successfully!"));
+
+    // Display results
+    displayResults(config, result);
+  } catch (error) {
+    spinner.fail(chalk.red("Failed to generate configuration"));
+    throw error;
+  }
+}
+
+function displayResults(config, result) {
+  const tool = TOOLS[config.tool];
+
+  // Format file location with proper coloring
+  const locationLine = `Location: ${chalk.yellow(config.folder + "/")}`;
+  const toolLine = `Tool: ${chalk.cyan(tool.name)}`;
+  const domainLine = `Domains: ${config.domains.length}`;
+  const skillsLine = `Skills: ${result.skillsGenerated || 0}`;
+
+  displayBox(
+    "📁 Generated Files",
+    `${locationLine}\n${toolLine}\n${domainLine}\n${skillsLine}`
+  );
+
+  displayBox("📚 Usage Instructions", getUsageInstructions(config.tool, config.folder));
+
+  const step1 = `1. Review files in ${chalk.yellow(config.folder + "/")}`;
+  const step2 = `2. Read ${chalk.yellow(config.folder + "/README.md")}`;
+  const step3 = `3. ${getToolSpecificNextStep(config.tool)}`;
+  const step4 = `4. Commit to version control to share with team`;
+
+  displayBox("🚀 Next Steps", `${step1}\n${step2}\n${step3}\n${step4}`);
+
+  console.log(
+    chalk.dim("💡 Tip: Run ") +
+      chalk.cyan("skillset init") +
+      chalk.dim(" again to regenerate\n")
+  );
+}
+
+function getUsageInstructions(tool, folder) {
+  const instructions = {
+    "claude-code":
+      `With Claude Code:\n` +
+      `Skills are automatically loaded from \`${folder}/\`\n` +
+      `Reference them naturally in your prompts:\n` +
+      chalk.gray("  \"Use the api-endpoint-generator skill...\""),
+
+    cursor:
+      `With Cursor:\n` +
+      `1. Use @-mentions in chat:\n` +
+      chalk.gray(`     @${folder}/api-endpoint-generator/RULE.md\n`) +
+      `2. Or reference in prompts naturally`,
+
+    copilot:
+      `With GitHub Copilot:\n` +
+      `Skills in \`${folder}/\` are automatically recognized\n` +
+      `Copilot will use them for code suggestions`,
+
+    other:
+      `With any AI tool:\n` +
+      `Upload relevant skill files to your AI chat\n` +
+      `and reference them in your prompts.`,
+  };
+
+  return instructions[tool] || instructions.other;
+}
+
+function getToolSpecificNextStep(tool) {
+  const steps = {
+    "claude-code": "Start coding - Skills are automatically available",
+    cursor: "Open Cursor and use @-mentions to reference skills",
+    copilot: "Start coding - Copilot will use the skills automatically",
+    other: "Open your AI tool and upload the skill files",
+  };
+
+  return steps[tool] || steps.other;
+}
+
+module.exports = initCommand;