genskills 1.0.0

package/README.md

@@ -0,0 +1,259 @@
+# GenSkills
+
+A comprehensive Claude Code skills library. Install once, get 21 AI-powered skills that supercharge your development workflow.
+
+```bash
+npm install genskills
+```
+
+Skills are automatically installed into your project's `.claude/skills/` directory. No extra setup needed.
+
+---
+
+## What You Get
+
+**21 skills** across 5 categories, ready to use as `/genskills:<skill-name>` in Claude Code.
+
+### Code Quality
+
+| Skill | Command | Description |
+|-------|---------|-------------|
+| Code Review | `/genskills:code-review` | Multi-dimensional code review with security, performance, and best-practice analysis |
+| Refactor | `/genskills:refactor` | Improve code structure and readability while preserving behavior |
+| Security Audit | `/genskills:security-audit` | OWASP Top 10 vulnerability scanning, dependency audit, infrastructure checks |
+| Test Generator | `/genskills:test-generator` | Generate test suites for Jest, Vitest, pytest, and more |
+| Lint Fix | `/genskills:lint-fix` | Auto-fix linting and formatting issues (ESLint, Prettier, Ruff, Black) |
+| Type Check | `/genskills:type-check` | Run type checking and resolve errors (TypeScript, mypy, pyright) |
+
+### Workflow
+
+| Skill | Command | Description |
+|-------|---------|-------------|
+| Git Commit | `/genskills:git-commit` | Conventional commits with smart staging and AI-generated messages |
+| PR Create | `/genskills:pr-create` | Create pull requests with generated titles, descriptions, and test plans |
+| Deploy | `/genskills:deploy` | Guided deployment with pre-deploy checks and post-deploy verification |
+| CI Fix | `/genskills:ci-fix` | Diagnose and fix failing CI/CD pipelines from build logs |
+| Branch Manager | `/genskills:branch-manager` | Create, merge, rebase, and clean up branches |
+
+### Project Management
+
+| Skill | Command | Description |
+|-------|---------|-------------|
+| Task Tracker | `/genskills:task-tracker` | Track TODOs, manage tasks, show project status |
+| Changelog Gen | `/genskills:changelog-gen` | Generate CHANGELOG.md from git history (Keep a Changelog format) |
+| Release Notes | `/genskills:release-notes` | Polished release notes for GitHub Releases |
+
+### Documentation
+
+| Skill | Command | Description |
+|-------|---------|-------------|
+| Doc Gen | `/genskills:doc-gen` | Generate JSDoc, docstrings, and inline documentation |
+| API Docs | `/genskills:api-docs` | Generate OpenAPI specs and API endpoint references |
+| README Gen | `/genskills:readme-gen` | Generate or update project README files |
+
+### Development
+
+| Skill | Command | Description |
+|-------|---------|-------------|
+| Scaffold | `/genskills:scaffold` | Generate components, modules, services following project patterns |
+| Migrate | `/genskills:migrate` | Framework upgrades, dependency migrations, pattern modernization |
+| Debug | `/genskills:debug` | Systematic debugging — trace errors, find root causes, apply fixes |
+| Perf Optimize | `/genskills:perf-optimize` | Identify bottlenecks, optimize queries, reduce bundle size |
+
+---
+
+## CLI
+
+Manage your skills with the `genskills` CLI:
+
+```bash
+npx genskills <command>
+```
+
+| Command | Description |
+|---------|-------------|
+| `genskills list` | List all available skills and their status |
+| `genskills list --installed` | Show only installed skills |
+| `genskills install` | Install or reinstall all enabled skills |
+| `genskills install <skill>` | Install a specific skill |
+| `genskills install --force` | Force reinstall even if unchanged |
+| `genskills enable <name>` | Enable a skill or category |
+| `genskills disable <name>` | Disable and remove a skill or category |
+| `genskills init` | Create a `genskills.config.json` interactively |
+| `genskills init -y` | Create config with all defaults |
+| `genskills update` | Check for and apply skill updates |
+| `genskills update --check` | Dry run — show what would change |
+| `genskills doctor` | Diagnose installation issues |
+| `genskills clean` | Remove orphaned skills |
+| `genskills clean --backups` | Also remove backup directory |
+
+---
+
+## Configuration
+
+Customize which skills are installed by creating a `genskills.config.json` at your project root:
+
+```bash
+npx genskills init
+```
+
+Or create it manually:
+
+```json
+{
+  "$schema": "./node_modules/genskills/schemas/genskills-config.schema.json",
+  "version": "1.0",
+  "categories": {
+    "code-quality": true,
+    "workflow": true,
+    "project-management": true,
+    "documentation": false,
+    "development": true
+  },
+  "skills": {
+    "deploy": {
+      "enabled": false
+    },
+    "code-review": {
+      "enabled": true,
+      "settings": {
+        "defaultMode": "deep",
+        "languages": ["typescript", "python"]
+      }
+    }
+  },
+  "hooks": {
+    "autoRegister": true
+  }
+}
+```
+
+### Config Resolution
+
+- Individual skill `enabled` **overrides** its category setting
+- If a category is `false` but a skill within it is `enabled: true`, that skill gets installed
+- If a category is `true` but a skill is `enabled: false`, that skill is skipped
+- Without a config file, **all skills are installed**
+
+### Per-Skill Settings
+
+Each skill's `settings` object is written as a `_config.json` file alongside its `SKILL.md`. Skills read this file at runtime to customize their behavior.
+
+---
+
+## How It Works
+
+### On Install
+
+When you run `npm install genskills`, the postinstall script:
+
+1. Detects your project root
+2. Reads `genskills.config.json` (if it exists)
+3. Copies enabled skills into `.claude/skills/genskills--<name>/`
+4. Writes a `.genskills-manifest.json` to track versions and checksums
+5. Backs up any previously installed skills before overwriting
+
+### Namespacing
+
+All installed skills are prefixed with `genskills--` to avoid conflicts with your own custom skills:
+
+```
+.claude/skills/
+  genskills--code-review/     # managed by GenSkills
+  genskills--debug/           # managed by GenSkills
+  my-custom-skill/            # yours — never touched
+```
+
+### Updates
+
+When you update the package, the postinstall script compares checksums:
+
+- **Changed skills** are backed up to `.genskills-backup/` then overwritten
+- **New skills** are installed if their category is enabled
+- **Removed skills** are flagged but not deleted (use `genskills clean`)
+
+### Skill Dependencies
+
+Some skills declare soft dependencies on other skills:
+
+```yaml
+genskills-depends:
+  - genskills:git-commit
+```
+
+When you enable a skill, its dependencies are auto-enabled. Dependencies are soft — if a dependency is missing, the skill still works but with reduced capability.
+
+---
+
+## Skill Format
+
+Each skill is a directory containing a `SKILL.md` with YAML frontmatter:
+
+```yaml
+---
+name: genskills:skill-name
+description: >
+  What this skill does and when it should trigger.
+user-invocable: true
+argument-hint: "[arguments description]"
+allowed-tools: "Read, Edit, Grep, Glob, Bash(git *)"
+genskills-version: "1.0.0"
+genskills-category: "category-name"
+genskills-depends: []
+---
+
+# Skill Title
+
+Instructions for Claude on how to execute this skill...
+```
+
+Skills can also include supporting files like reference docs, templates, and scripts in their directory.
+
+---
+
+## Troubleshooting
+
+### Skills not showing up in Claude Code
+
+Run the doctor to check for issues:
+
+```bash
+npx genskills doctor
+```
+
+### Force reinstall all skills
+
+```bash
+npx genskills install --force
+```
+
+### Skills were modified locally
+
+The doctor command detects checksum drift. To reset to the original versions:
+
+```bash
+npx genskills install --force
+```
+
+Your modified versions are backed up to `.claude/skills/.genskills-backup/`.
+
+### Config file not working
+
+Validate your config against the JSON schema:
+
+```json
+{
+  "$schema": "./node_modules/genskills/schemas/genskills-config.schema.json"
+}
+```
+
+---
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Claude Code CLI
+
+## License
+
+MIT

package/dist/cli/commands/clean.d.ts

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

package/dist/cli/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clean.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8D3D"}

package/dist/cli/commands/clean.js

@@ -0,0 +1,100 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCleanCommand = registerCleanCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const paths_1 = require("../utils/paths");
+const manifest_1 = require("../utils/manifest");
+const logger_1 = require("../utils/logger");
+function registerCleanCommand(program) {
+    program
+        .command("clean")
+        .description("Remove orphaned skills and old backups")
+        .option("--backups", "Also remove backup directory")
+        .action((opts) => {
+        const projectRoot = (0, paths_1.findProjectRoot)();
+        const skillsDir = (0, paths_1.getSkillsDir)(projectRoot);
+        const manifest = (0, manifest_1.readManifest)(projectRoot);
+        logger_1.logger.header("GenSkills — Clean");
+        logger_1.logger.br();
+        if (!fs.existsSync(skillsDir)) {
+            logger_1.logger.info("No skills directory found. Nothing to clean.");
+            return;
+        }
+        // Find all valid skill names from the package
+        const validSkills = new Set();
+        for (const category of (0, paths_1.getCategories)()) {
+            for (const skill of (0, paths_1.getSkillsInCategory)(category)) {
+                validSkills.add(`genskills--${skill}`);
+            }
+        }
+        // Find installed genskills directories
+        const installed = fs
+            .readdirSync(skillsDir, { withFileTypes: true })
+            .filter((d) => d.isDirectory() && d.name.startsWith("genskills--"))
+            .map((d) => d.name);
+        // Remove orphans (installed but no longer in package)
+        let orphanCount = 0;
+        for (const dir of installed) {
+            if (!validSkills.has(dir)) {
+                const fullPath = path.join(skillsDir, dir);
+                fs.rmSync(fullPath, { recursive: true, force: true });
+                delete manifest.skills[dir];
+                logger_1.logger.step(`Removed orphan: ${dir}`);
+                orphanCount++;
+            }
+        }
+        if (orphanCount === 0) {
+            logger_1.logger.success("No orphaned skills found.");
+        }
+        else {
+            logger_1.logger.success(`Removed ${orphanCount} orphaned skill(s).`);
+            (0, manifest_1.writeManifest)(projectRoot, manifest);
+        }
+        // Clean backups
+        if (opts.backups) {
+            const backupDir = (0, paths_1.getBackupDir)(projectRoot);
+            if (fs.existsSync(backupDir)) {
+                fs.rmSync(backupDir, { recursive: true, force: true });
+                logger_1.logger.success("Removed backup directory.");
+            }
+            else {
+                logger_1.logger.info("No backup directory found.");
+            }
+        }
+    });
+}
+//# sourceMappingURL=clean.js.map

package/dist/cli/commands/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../../src/cli/commands/clean.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/disable.d.ts

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

package/dist/cli/commands/disable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/disable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwC7D"}

package/dist/cli/commands/disable.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDisableCommand = registerDisableCommand;
+const paths_1 = require("../utils/paths");
+const config_loader_1 = require("../utils/config-loader");
+const copy_1 = require("../utils/copy");
+const logger_1 = require("../utils/logger");
+function registerDisableCommand(program) {
+    program
+        .command("disable <name>")
+        .description("Disable a skill or category and remove it")
+        .action((name) => {
+        const projectRoot = (0, paths_1.findProjectRoot)();
+        const config = (0, config_loader_1.loadConfig)(projectRoot);
+        const categories = (0, paths_1.getCategories)();
+        // Check if it's a category
+        if (categories.includes(name)) {
+            config.categories[name] = false;
+            (0, config_loader_1.saveConfig)(projectRoot, config);
+            // Remove all skills in category
+            const skills = (0, paths_1.getSkillsInCategory)(name);
+            let removed = 0;
+            for (const skill of skills) {
+                if ((0, copy_1.removeSkill)(projectRoot, skill))
+                    removed++;
+            }
+            logger_1.logger.success(`Disabled category: ${name} (removed ${removed} skill(s))`);
+            return;
+        }
+        // It's a skill name
+        if (!config.skills[name]) {
+            config.skills[name] = {};
+        }
+        config.skills[name].enabled = false;
+        (0, config_loader_1.saveConfig)(projectRoot, config);
+        if ((0, copy_1.removeSkill)(projectRoot, name)) {
+            logger_1.logger.success(`Disabled and removed skill: ${name}`);
+        }
+        else {
+            logger_1.logger.success(`Disabled skill: ${name} (was not installed)`);
+        }
+    });
+}
+//# sourceMappingURL=disable.js.map

package/dist/cli/commands/disable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable.js","sourceRoot":"","sources":["../../../src/cli/commands/disable.ts"],"names":[],"mappings":";;AAUA,wDAwCC;AAjDD,0CAIwB;AACxB,0DAAgE;AAChE,wCAA4C;AAC5C,4CAAyC;AAEzC,SAAgB,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,2CAA2C,CAAC;SACxD,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE;QACvB,MAAM,WAAW,GAAG,IAAA,uBAAe,GAAE,CAAC;QACtC,MAAM,MAAM,GAAG,IAAA,0BAAU,EAAC,WAAW,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,IAAA,qBAAa,GAAE,CAAC;QAEnC,2BAA2B;QAC3B,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAChC,IAAA,0BAAU,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAEhC,gCAAgC;YAChC,MAAM,MAAM,GAAG,IAAA,2BAAmB,EAAC,IAAI,CAAC,CAAC;YACzC,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,IAAA,kBAAW,EAAC,WAAW,EAAE,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAC;YACjD,CAAC;YAED,eAAM,CAAC,OAAO,CACZ,sBAAsB,IAAI,aAAa,OAAO,YAAY,CAC3D,CAAC;YACF,OAAO;QACT,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC;QACpC,IAAA,0BAAU,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEhC,IAAI,IAAA,kBAAW,EAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC;YACnC,eAAM,CAAC,OAAO,CAAC,+BAA+B,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,eAAM,CAAC,OAAO,CAAC,mBAAmB,IAAI,sBAAsB,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/doctor.d.ts

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

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqH5D"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,151 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDoctorCommand = registerDoctorCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const paths_1 = require("../utils/paths");
+const manifest_1 = require("../utils/manifest");
+const config_loader_1 = require("../utils/config-loader");
+const copy_1 = require("../utils/copy");
+const dependency_resolver_1 = require("../utils/dependency-resolver");
+const logger_1 = require("../utils/logger");
+function registerDoctorCommand(program) {
+    program
+        .command("doctor")
+        .description("Diagnose issues with your genskills installation")
+        .action(() => {
+        const projectRoot = (0, paths_1.findProjectRoot)();
+        let issues = 0;
+        logger_1.logger.header("GenSkills — Doctor");
+        logger_1.logger.br();
+        // 1. Check skills directory exists
+        const skillsDir = (0, paths_1.getSkillsDir)(projectRoot);
+        if (!fs.existsSync(skillsDir)) {
+            logger_1.logger.error(".claude/skills/ directory does not exist");
+            logger_1.logger.info("Run `npx genskills install` to create it.");
+            issues++;
+        }
+        else {
+            logger_1.logger.success(".claude/skills/ directory exists");
+        }
+        // 2. Check manifest
+        const manifest = (0, manifest_1.readManifest)(projectRoot);
+        const installedSkills = (0, copy_1.getInstalledSkills)(projectRoot);
+        if (Object.keys(manifest.skills).length === 0 && installedSkills.length > 0) {
+            logger_1.logger.warn("Skills installed but manifest is empty — run `npx genskills install --force`");
+            issues++;
+        }
+        else {
+            logger_1.logger.success(`Manifest tracks ${Object.keys(manifest.skills).length} skill(s)`);
+        }
+        // 3. Check version
+        const currentVersion = (0, manifest_1.getPackageVersion)();
+        if (manifest.packageVersion !== currentVersion) {
+            logger_1.logger.warn(`Manifest version (${manifest.packageVersion}) differs from package (${currentVersion})`);
+            logger_1.logger.info("Run `npx genskills update` to sync.");
+            issues++;
+        }
+        // 4. Check for checksum drift (user modified installed skills)
+        const config = (0, config_loader_1.loadConfig)(projectRoot);
+        const categories = (0, paths_1.getCategories)();
+        let driftCount = 0;
+        for (const category of categories) {
+            for (const skill of (0, paths_1.getSkillsInCategory)(category)) {
+                const manifestKey = `genskills--${skill}`;
+                const entry = manifest.skills[manifestKey];
+                if (!entry)
+                    continue;
+                const installedDir = path.join(skillsDir, manifestKey);
+                if (fs.existsSync(installedDir)) {
+                    const currentChecksum = (0, manifest_1.computeChecksum)(installedDir);
+                    if (currentChecksum !== entry.checksum) {
+                        logger_1.logger.warn(`Skill "${skill}" has been modified locally`);
+                        driftCount++;
+                    }
+                }
+            }
+        }
+        if (driftCount === 0) {
+            logger_1.logger.success("No checksum drift detected");
+        }
+        else {
+            logger_1.logger.warn(`${driftCount} skill(s) modified. Run \`npx genskills install --force\` to reset.`);
+            issues++;
+        }
+        // 5. Check for duplicate/conflicting skills
+        const allDirs = fs.existsSync(skillsDir)
+            ? fs.readdirSync(skillsDir, { withFileTypes: true })
+                .filter((d) => d.isDirectory() && !d.name.startsWith("."))
+                .map((d) => d.name)
+            : [];
+        const userSkills = allDirs.filter((d) => !d.startsWith("genskills--"));
+        const genskillsNames = new Set(installedSkills);
+        for (const userSkill of userSkills) {
+            if (genskillsNames.has(userSkill)) {
+                logger_1.logger.warn(`Potential conflict: user skill "${userSkill}" overlaps with genskills skill`);
+                issues++;
+            }
+        }
+        if (userSkills.length > 0 && issues === 0) {
+            logger_1.logger.success(`${userSkills.length} user skill(s) — no conflicts`);
+        }
+        // 6. Check dependencies
+        try {
+            const depResult = (0, dependency_resolver_1.resolveDependencies)(projectRoot);
+            if (depResult.missing.length > 0) {
+                for (const m of depResult.missing) {
+                    logger_1.logger.warn(`Missing dependency: "${m.skill}" requires "${m.dependency}"`);
+                }
+                issues += depResult.missing.length;
+            }
+            else {
+                logger_1.logger.success("All skill dependencies satisfied");
+            }
+        }
+        catch {
+            logger_1.logger.success("No dependency issues");
+        }
+        // Summary
+        logger_1.logger.br();
+        if (issues === 0) {
+            logger_1.logger.success("No issues found! Everything looks good.");
+        }
+        else {
+            logger_1.logger.warn(`Found ${issues} issue(s). See above for details.`);
+        }
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,sDAqHC;AAnID,uCAAyB;AACzB,2CAA6B;AAC7B,0CAKwB;AACxB,gDAAqF;AACrF,0DAAoE;AACpE,wCAAmD;AACnD,sEAAmE;AACnE,4CAAyC;AAEzC,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,kDAAkD,CAAC;SAC/D,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,WAAW,GAAG,IAAA,uBAAe,GAAE,CAAC;QACtC,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,eAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACpC,eAAM,CAAC,EAAE,EAAE,CAAC;QAEZ,mCAAmC;QACnC,MAAM,SAAS,GAAG,IAAA,oBAAY,EAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,eAAM,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;YACzD,eAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;YACzD,MAAM,EAAE,CAAC;QACX,CAAC;aAAM,CAAC;YACN,eAAM,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;QACrD,CAAC;QAED,oBAAoB;QACpB,MAAM,QAAQ,GAAG,IAAA,uBAAY,EAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,eAAe,GAAG,IAAA,yBAAkB,EAAC,WAAW,CAAC,CAAC;QAExD,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5E,eAAM,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;YAC5F,MAAM,EAAE,CAAC;QACX,CAAC;aAAM,CAAC;YACN,eAAM,CAAC,OAAO,CAAC,mBAAmB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC;QACpF,CAAC;QAED,mBAAmB;QACnB,MAAM,cAAc,GAAG,IAAA,4BAAiB,GAAE,CAAC;QAC3C,IAAI,QAAQ,CAAC,cAAc,KAAK,cAAc,EAAE,CAAC;YAC/C,eAAM,CAAC,IAAI,CACT,qBAAqB,QAAQ,CAAC,cAAc,2BAA2B,cAAc,GAAG,CACzF,CAAC;YACF,eAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YACnD,MAAM,EAAE,CAAC;QACX,CAAC;QAED,+DAA+D;QAC/D,MAAM,MAAM,GAAG,IAAA,0BAAU,EAAC,WAAW,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,IAAA,qBAAa,GAAE,CAAC;QACnC,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,KAAK,MAAM,KAAK,IAAI,IAAA,2BAAmB,EAAC,QAAQ,CAAC,EAAE,CAAC;gBAClD,MAAM,WAAW,GAAG,cAAc,KAAK,EAAE,CAAC;gBAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAC3C,IAAI,CAAC,KAAK;oBAAE,SAAS;gBAErB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;gBACvD,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;oBAChC,MAAM,eAAe,GAAG,IAAA,0BAAe,EAAC,YAAY,CAAC,CAAC;oBACtD,IAAI,eAAe,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;wBACvC,eAAM,CAAC,IAAI,CAAC,UAAU,KAAK,6BAA6B,CAAC,CAAC;wBAC1D,UAAU,EAAE,CAAC;oBACf,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACrB,eAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,eAAM,CAAC,IAAI,CAAC,GAAG,UAAU,qEAAqE,CAAC,CAAC;YAChG,MAAM,EAAE,CAAC;QACX,CAAC;QAED,4CAA4C;QAC5C,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YACtC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;iBAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;iBACzD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;QACvE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;QAEhD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClC,eAAM,CAAC,IAAI,CACT,mCAAmC,SAAS,iCAAiC,CAC9E,CAAC;gBACF,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1C,eAAM,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,+BAA+B,CAAC,CAAC;QACtE,CAAC;QAED,wBAAwB;QACxB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAA,yCAAmB,EAAC,WAAW,CAAC,CAAC;YACnD,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;oBAClC,eAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;gBAC7E,CAAC;gBACD,MAAM,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,eAAM,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,eAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QACzC,CAAC;QAED,UAAU;QACV,eAAM,CAAC,EAAE,EAAE,CAAC;QACZ,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjB,eAAM,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,eAAM,CAAC,IAAI,CAAC,SAAS,MAAM,mCAAmC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/enable.d.ts

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

package/dist/cli/commands/enable.d.ts.map

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

package/dist/cli/commands/enable.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerEnableCommand = registerEnableCommand;
+const paths_1 = require("../utils/paths");
+const config_loader_1 = require("../utils/config-loader");
+const copy_1 = require("../utils/copy");
+const logger_1 = require("../utils/logger");
+function registerEnableCommand(program) {
+    program
+        .command("enable <name>")
+        .description("Enable a skill or category")
+        .action((name) => {
+        const projectRoot = (0, paths_1.findProjectRoot)();
+        const config = (0, config_loader_1.loadConfig)(projectRoot);
+        const categories = (0, paths_1.getCategories)();
+        // Check if it's a category
+        if (categories.includes(name)) {
+            config.categories[name] = true;
+            (0, config_loader_1.saveConfig)(projectRoot, config);
+            logger_1.logger.success(`Enabled category: ${name}`);
+            // Install newly enabled skills
+            logger_1.logger.step("Installing skills from enabled category...");
+            const result = (0, copy_1.installSkills)(projectRoot);
+            if (result.installed.length > 0) {
+                logger_1.logger.success(`Installed: ${result.installed.join(", ")}`);
+            }
+            return;
+        }
+        // It's a skill name
+        if (!config.skills[name]) {
+            config.skills[name] = {};
+        }
+        config.skills[name].enabled = true;
+        (0, config_loader_1.saveConfig)(projectRoot, config);
+        logger_1.logger.success(`Enabled skill: ${name}`);
+        // Install the specific skill
+        logger_1.logger.step("Installing skill...");
+        const result = (0, copy_1.installSkills)(projectRoot, { specific: name });
+        if (result.installed.length > 0) {
+            logger_1.logger.success(`Installed: ${result.installed.join(", ")}`);
+        }
+        else if (result.errors.length > 0) {
+            for (const err of result.errors)
+                logger_1.logger.error(err);
+        }
+    });
+}
+//# sourceMappingURL=enable.js.map

package/dist/cli/commands/enable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable.js","sourceRoot":"","sources":["../../../src/cli/commands/enable.ts"],"names":[],"mappings":";;AAMA,sDAyCC;AA9CD,0CAAgE;AAChE,0DAAgE;AAChE,wCAA8C;AAC9C,4CAAyC;AAEzC,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE;QACvB,MAAM,WAAW,GAAG,IAAA,uBAAe,GAAE,CAAC;QACtC,MAAM,MAAM,GAAG,IAAA,0BAAU,EAAC,WAAW,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,IAAA,qBAAa,GAAE,CAAC;QAEnC,2BAA2B;QAC3B,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAC/B,IAAA,0BAAU,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAChC,eAAM,CAAC,OAAO,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;YAE5C,+BAA+B;YAC/B,eAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAC1D,MAAM,MAAM,GAAG,IAAA,oBAAa,EAAC,WAAW,CAAC,CAAC;YAC1C,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,eAAM,CAAC,OAAO,CAAC,cAAc,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO;QACT,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;QACnC,IAAA,0BAAU,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAChC,eAAM,CAAC,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QAEzC,6BAA6B;QAC7B,eAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,IAAA,oBAAa,EAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,eAAM,CAAC,OAAO,CAAC,cAAc,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM;gBAAE,eAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/init.d.ts

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