@devmunna/agent-skillkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 devmunna
+
+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,147 @@
+# Agent Skillkit
+
+Install stack-aware AI agent development skills for Claude Code and Codex.
+
+`@devmunna/agent-skillkit` copies curated `SKILL.md` packages into a project, adds shared agent instructions, and keeps installed skills refreshable as the package evolves.
+
+## Quick Start
+
+```bash
+npx @devmunna/agent-skillkit init
+```
+
+The installer asks which agent to support:
+
+- Claude Code: installs skills to `.ai-skills/skills` and updates `CLAUDE.md`
+- Codex: installs skills to `.agents/skills` and writes shared `AGENTS.md`
+
+## Non-Interactive Use
+
+```bash
+npx @devmunna/agent-skillkit init --agent codex --profile express-prisma --yes
+npx @devmunna/agent-skillkit init --agent claude --agent codex --stack react --stack tailwind --yes
+npx @devmunna/agent-skillkit init --agent codex --skill node-base --skill zod-validation --yes
+```
+
+## Commands
+
+```bash
+ai-skills init       # Install skills for a selected agent and stack
+ai-skills add        # Add more skills to the configured agents
+ai-skills list       # List installed or available skills
+ai-skills update     # Refresh installed skills from the current package version
+ai-skills validate   # Validate the package skill catalog and files
+ai-skills doctor     # Inspect the current project installation
+```
+
+## Profiles
+
+Profiles install a tested combination of skills:
+
+- `express-prisma`
+- `fastify-api`
+- `next-fullstack`
+- `react-spa`
+- `mern`
+- `node-base`
+
+## Agent Behavior
+
+The package is designed to reduce token usage and hallucination:
+
+- Keep `SKILL.md` files focused on hard rules and activation context
+- Put longer templates and examples in `references/`
+- Generate `AGENTS.md` with rules for reading only relevant skills
+- Install reusable workflows under `.ai-skills/workflows`
+- Provide `doctor` and `validate` commands for drift checks
+
+## Development
+
+Prerequisites:
+
+- Node.js 18 or newer
+- npm
+
+Set up the project:
+
+```bash
+npm install
+npm run typecheck
+npm run build
+npm test
+```
+
+Run the CLI locally while developing:
+
+```bash
+npm run dev -- init
+npm run dev -- list
+npm run dev -- doctor
+```
+
+Check what will be published:
+
+```bash
+npm pack --dry-run
+```
+
+The npm package only publishes the files listed in `package.json`:
+
+- `dist`
+- `bin`
+- `skills`
+
+Source files, tests, editor config, and local dependencies are not included in the published package.
+
+## Contributing
+
+Contributions are welcome. Please keep changes focused and include validation steps in your pull request.
+
+Recommended workflow:
+
+1. Fork the repository.
+2. Create a feature branch.
+3. Install dependencies with `npm install`.
+4. Make your changes.
+5. Run `npm run typecheck`.
+6. Run `npm test`.
+7. Run `npm pack --dry-run` if your change affects published files.
+8. Open a pull request with a short summary and test results.
+
+### Adding or Updating Skills
+
+Skills live in `skills/<skill-name>/SKILL.md`. Larger examples, templates, or optional details should go in `skills/<skill-name>/references/`.
+
+When adding a skill:
+
+1. Create a clear `SKILL.md` with activation context and hard rules.
+2. Move long examples into `references/`.
+3. Register the skill in the package catalog if needed.
+4. Add or update tests when behavior changes.
+5. Run `npm test`.
+
+Keep skill files concise so agents can load only the context they need.
+
+### Pull Request Checklist
+
+- The package builds with `npm run build`.
+- TypeScript passes with `npm run typecheck`.
+- Tests pass with `npm test`.
+- New skills include focused instructions and references only where useful.
+- README or docs are updated when commands, profiles, or behavior change.
+
+### Release Checklist
+
+Before publishing a new version:
+
+```bash
+npm test
+npm pack --dry-run
+npm publish --access public
+```
+
+Use `npm pack --dry-run` to confirm the package contents and size before release.
+
+## License
+
+MIT

package/bin/ai-skills.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import('../dist/cli/index.js').catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

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

@@ -0,0 +1,2 @@
+export declare function addCommand(skillNames: string[]): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAUA,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEpE"}

package/dist/cli/commands/add.js

@@ -0,0 +1,66 @@
+import * as clack from '@clack/prompts';
+import { resolveSkills } from '../../core/skill-resolver.js';
+import { getSkillMeta, getAllSkills } from '../../core/skill-registry.js';
+import { ConfigManager } from '../../core/config-manager.js';
+import { agentLabels, installSkillsForAgents } from '../../generators/agent-installer.js';
+import { generateAgentsMd } from '../../generators/agents-md.js';
+import { generateClaudeMd } from '../../generators/claude-md.js';
+import { generateWorkflows } from '../../generators/workflows.js';
+import { logger } from '../../utils/logger.js';
+export async function addCommand(skillNames) {
+    const projectRoot = process.cwd();
+    const configManager = new ConfigManager(projectRoot);
+    const config = await configManager.read();
+    if (!config) {
+        logger.error('No ai-skills config found. Run `ai-skills init` first.');
+        process.exit(1);
+    }
+    let toInstall = skillNames;
+    if (toInstall.length === 0) {
+        const installed = new Set(config?.installedSkills.map((s) => s.name) ?? []);
+        const selected = await clack.multiselect({
+            message: 'Select skills to add',
+            options: getAllSkills()
+                .filter((s) => !installed.has(s.name))
+                .map((s) => ({ value: s.name, label: s.name, hint: s.description })),
+        });
+        if (clack.isCancel(selected)) {
+            clack.outro('Cancelled.');
+            return;
+        }
+        toInstall = selected;
+    }
+    const resolution = resolveSkills(toInstall);
+    if (resolution.missing.length > 0) {
+        logger.warn(`Unknown skills (skipped): ${resolution.missing.join(', ')}`);
+    }
+    if (resolution.ordered.length === 0) {
+        logger.info('No valid skills to install.');
+        return;
+    }
+    const spin = clack.spinner();
+    spin.start(`Adding ${resolution.ordered.length} skill(s) for ${agentLabels(config.agents)}...`);
+    try {
+        await installSkillsForAgents(resolution.ordered, configManager.getInstallTargets(config.agents));
+        await generateWorkflows(projectRoot);
+        for (const name of resolution.ordered) {
+            const meta = getSkillMeta(name);
+            await configManager.addSkill(name, meta?.version ?? '1.0.0');
+        }
+        spin.stop('Done.');
+        const updatedConfig = await configManager.read();
+        if (updatedConfig?.claudeMd) {
+            await generateClaudeMd(projectRoot, updatedConfig.installedSkills, '.ai-skills/skills');
+        }
+        if (updatedConfig?.agents.includes('codex')) {
+            await generateAgentsMd(projectRoot, updatedConfig.installedSkills, '.agents/skills', '.ai-skills/workflows');
+        }
+        logger.success(`Added: ${resolution.ordered.join(', ')}`);
+    }
+    catch (err) {
+        spin.stop('Failed.');
+        logger.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=add.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function doctorCommand(): Promise<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":"AAkBA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBnD"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,33 @@
+import chalk from 'chalk';
+import { inspectProject } from '../../core/doctor.js';
+import { logger } from '../../utils/logger.js';
+const COLORS = {
+    ok: chalk.green,
+    warning: chalk.yellow,
+    error: chalk.red,
+    info: chalk.blue,
+};
+const LABELS = {
+    ok: 'ok',
+    warning: 'warning',
+    error: 'error',
+    info: 'info',
+};
+export async function doctorCommand() {
+    const result = await inspectProject(process.cwd());
+    for (const finding of result.findings) {
+        const label = COLORS[finding.level](LABELS[finding.level]);
+        console.log(`  ${label} ${finding.message}`);
+    }
+    logger.blank();
+    if (result.errors > 0) {
+        logger.error(`Doctor found ${result.errors} error(s) and ${result.warnings} warning(s).`);
+        process.exit(1);
+    }
+    if (result.warnings > 0) {
+        logger.warn(`Doctor found ${result.warnings} warning(s).`);
+        return;
+    }
+    logger.success('Project ai-skills setup looks healthy.');
+}
+//# 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":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,KAAK,CAAC,KAAK;IACf,OAAO,EAAE,KAAK,CAAC,MAAM;IACrB,KAAK,EAAE,KAAK,CAAC,GAAG;IAChB,IAAI,EAAE,KAAK,CAAC,IAAI;CACjB,CAAC;AAEF,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,IAAI;IACR,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEnD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,CAAC;IAEf,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,MAAM,iBAAiB,MAAM,CAAC,QAAQ,cAAc,CAAC,CAAC;QAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,QAAQ,cAAc,CAAC,CAAC;QAC3D,OAAO;IACT,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,10 @@
+export interface InitCommandOptions {
+    agent?: string[];
+    stack?: string[];
+    skill?: string[];
+    profile?: string;
+    yes?: boolean;
+    agentsMd?: boolean;
+}
+export declare function initCommand(options?: InitCommandOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmJjF"}

package/dist/cli/commands/init.js

@@ -0,0 +1,145 @@
+import * as clack from '@clack/prompts';
+import chalk from 'chalk';
+import { resolveSkills } from '../../core/skill-resolver.js';
+import { mapStackToSkills, getSkillMeta, getSkillProfile } from '../../core/skill-registry.js';
+import { ConfigManager } from '../../core/config-manager.js';
+import { agentLabels, installSkillsForAgents } from '../../generators/agent-installer.js';
+import { generateAgentsMd } from '../../generators/agents-md.js';
+import { generateClaudeMd } from '../../generators/claude-md.js';
+import { generateWorkflows } from '../../generators/workflows.js';
+import { detectStack } from '../../core/detector.js';
+import { selectStacks } from '../prompts/stack-selector.js';
+import { selectAgents } from '../prompts/agent-selector.js';
+import { logger } from '../../utils/logger.js';
+export async function initCommand(options = {}) {
+    clack.intro(chalk.bold.cyan(' ai-skills init '));
+    const projectRoot = process.cwd();
+    const configManager = new ConfigManager(projectRoot);
+    if (await configManager.exists()) {
+        const overwrite = await clack.confirm({
+            message: 'ai-skills already initialized. Reinitialize and overwrite?',
+            initialValue: false,
+        });
+        if (clack.isCancel(overwrite) || !overwrite) {
+            clack.outro('Aborted. Use `ai-skills update` to refresh installed skills.');
+            return;
+        }
+    }
+    const agents = options.agent?.length ? parseAgents(options.agent) : await selectAgents();
+    if (!agents) {
+        clack.outro('Cancelled.');
+        return;
+    }
+    // Auto-detect installed packages
+    const detected = await detectStack(projectRoot);
+    if (detected.packages.length > 0) {
+        clack.note(detected.packages.map((p) => `  • ${p}`).join('\n'), 'Auto-detected packages');
+    }
+    const directSkills = options.skill ?? [];
+    const explicitStacks = options.stack ?? [];
+    const profile = options.profile ? getSkillProfile(options.profile) : undefined;
+    if (options.profile && !profile) {
+        logger.error(`Unknown profile: ${options.profile}`);
+        process.exit(1);
+    }
+    let allSelected = [...explicitStacks, ...(profile?.stacks ?? [])];
+    if (directSkills.length === 0 && explicitStacks.length === 0 && !profile) {
+        // Interactive stack selection
+        clack.log.step('Select your project stack:');
+        const selection = await selectStacks();
+        if (!selection) {
+            clack.outro('Cancelled.');
+            return;
+        }
+        allSelected = [
+            ...selection.backend,
+            ...selection.frontend,
+            ...selection.database,
+            ...selection.validation,
+            ...selection.architecture,
+        ];
+    }
+    const requestedSkills = [
+        ...new Set([
+            ...directSkills,
+            ...(profile?.skills ?? []),
+            ...mapStackToSkills(allSelected),
+            ...detected.suggestedSkills,
+        ]),
+    ];
+    // Always ensure node-base is present
+    if (!requestedSkills.includes('node-base')) {
+        requestedSkills.unshift('node-base');
+    }
+    // Resolve with dependency graph
+    const resolution = resolveSkills(requestedSkills);
+    if (resolution.missing.length > 0) {
+        logger.warn(`Unknown skills (skipped): ${resolution.missing.join(', ')}`);
+    }
+    if (resolution.conflicts.length > 0) {
+        logger.warn(`Conflicts: ${resolution.conflicts.join('; ')}`);
+    }
+    const skillsToInstall = resolution.ordered;
+    clack.note(skillsToInstall
+        .map((s) => {
+        const meta = getSkillMeta(s);
+        return `  ${chalk.green('•')} ${chalk.bold(s)} — ${chalk.dim(meta?.description ?? '')}`;
+    })
+        .join('\n'), `Skills to install (${skillsToInstall.length})`);
+    if (!options.yes) {
+        const confirm = await clack.confirm({
+            message: `Install ${skillsToInstall.length} skill(s) for ${agentLabels(agents)}?`,
+            initialValue: true,
+        });
+        if (clack.isCancel(confirm) || !confirm) {
+            clack.outro('Cancelled.');
+            return;
+        }
+    }
+    const spin = clack.spinner();
+    spin.start('Installing skills...');
+    try {
+        await configManager.init(undefined, agents);
+        const targets = configManager.getInstallTargets(agents);
+        await installSkillsForAgents(skillsToInstall, targets);
+        await generateWorkflows(projectRoot);
+        for (const name of skillsToInstall) {
+            const meta = getSkillMeta(name);
+            await configManager.addSkill(name, meta?.version ?? '1.0.0');
+        }
+        spin.stop('Skills installed.');
+        const updatedConfig = await configManager.read();
+        if (updatedConfig?.claudeMd) {
+            await generateClaudeMd(projectRoot, updatedConfig.installedSkills, '.ai-skills/skills');
+        }
+        if (updatedConfig && (updatedConfig.agents.includes('codex') || options.agentsMd)) {
+            await generateAgentsMd(projectRoot, updatedConfig.installedSkills, '.agents/skills', '.ai-skills/workflows');
+        }
+        const locations = targets
+            .map((target) => `  ${chalk.dim(`${target.agent} skills:`)} ${pathRelative(projectRoot, target.skillsDir)}`)
+            .join('\n');
+        clack.outro(`${chalk.green('✓')} Done! ${skillsToInstall.length} skill(s) installed.\n` +
+            `${locations}` +
+            `${updatedConfig?.claudeMd ? `\n  ${chalk.dim('Claude context:')} CLAUDE.md` : ''}`);
+    }
+    catch (err) {
+        spin.stop('Installation failed.');
+        logger.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+function parseAgents(values) {
+    const agents = [...new Set(values.map((value) => value.toLowerCase()))];
+    const supported = new Set(['claude', 'codex']);
+    const invalid = agents.filter((agent) => !supported.has(agent));
+    if (invalid.length > 0) {
+        logger.error(`Unsupported AI agent(s): ${invalid.join(', ')}. Use claude or codex.`);
+        process.exit(1);
+    }
+    return agents;
+}
+function pathRelative(from, to) {
+    const relative = to.startsWith(from) ? to.slice(from.length + 1) : to;
+    return relative.endsWith('/') ? relative : `${relative}/`;
+}
+//# sourceMappingURL=init.js.map

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

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

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

@@ -0,0 +1,5 @@
+export declare function listCommand(options?: {
+    available?: boolean;
+    profiles?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAMA,wBAAsB,WAAW,CAAC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC1G"}

package/dist/cli/commands/list.js

@@ -0,0 +1,55 @@
+import chalk from 'chalk';
+import { ConfigManager } from '../../core/config-manager.js';
+import { getAllProfiles, getAllSkills, getSkillMeta } from '../../core/skill-registry.js';
+import { agentLabels } from '../../generators/agent-installer.js';
+import { logger } from '../../utils/logger.js';
+export async function listCommand(options = {}) {
+    if (options.profiles) {
+        listProfiles();
+        return;
+    }
+    if (options.available) {
+        listAvailable();
+        return;
+    }
+    const configManager = new ConfigManager(process.cwd());
+    const config = await configManager.read();
+    if (!config || config.installedSkills.length === 0) {
+        logger.info('No skills installed. Run `ai-skills init` to get started.');
+        logger.dim('  Tip: use --available to see all skills');
+        return;
+    }
+    console.log(chalk.bold('\n  Installed Skills\n'));
+    for (const installed of config.installedSkills) {
+        const meta = getSkillMeta(installed.name);
+        console.log(`  ${chalk.green('✓')} ${chalk.bold(installed.name.padEnd(28))} ` +
+            `${chalk.dim(`v${installed.version}  •  ${meta?.description ?? ''}`)}`);
+    }
+    console.log(chalk.dim(`\n  ${config.installedSkills.length} skill(s) • ${agentLabels(config.agents)} • Updated ${new Date(config.updatedAt).toLocaleDateString()}\n`));
+}
+function listAvailable() {
+    const byCategory = {};
+    for (const skill of getAllSkills()) {
+        if (!byCategory[skill.category])
+            byCategory[skill.category] = [];
+        byCategory[skill.category].push(skill);
+    }
+    console.log(chalk.bold('\n  Available Skills\n'));
+    for (const [category, skills] of Object.entries(byCategory)) {
+        console.log(`  ${chalk.cyan.bold(category.toUpperCase())}`);
+        for (const skill of skills) {
+            const deps = skill.depends?.length ? chalk.dim(` (needs: ${skill.depends.join(', ')})`) : '';
+            console.log(`    ${chalk.green(skill.name.padEnd(26))}  ${chalk.dim(skill.description)}${deps}`);
+        }
+        console.log();
+    }
+}
+function listProfiles() {
+    console.log(chalk.bold('\n  Available Profiles\n'));
+    for (const profile of getAllProfiles()) {
+        console.log(`  ${chalk.green(profile.name.padEnd(18))} ${chalk.dim(profile.description)}`);
+        console.log(chalk.dim(`    skills: ${profile.skills.join(', ')}`));
+    }
+    console.log();
+}
+//# sourceMappingURL=list.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function updateCommand(): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AASA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAmDnD"}

package/dist/cli/commands/update.js

@@ -0,0 +1,49 @@
+import * as clack from '@clack/prompts';
+import { ConfigManager } from '../../core/config-manager.js';
+import { getSkillMeta } from '../../core/skill-registry.js';
+import { agentLabels, installSkillsForAgents } from '../../generators/agent-installer.js';
+import { generateAgentsMd } from '../../generators/agents-md.js';
+import { generateClaudeMd } from '../../generators/claude-md.js';
+import { generateWorkflows } from '../../generators/workflows.js';
+import { logger } from '../../utils/logger.js';
+export async function updateCommand() {
+    const projectRoot = process.cwd();
+    const configManager = new ConfigManager(projectRoot);
+    const config = await configManager.read();
+    if (!config || config.installedSkills.length === 0) {
+        logger.info('No skills installed. Run `ai-skills init` first.');
+        return;
+    }
+    const skillNames = config.installedSkills.map((s) => s.name);
+    clack.note(skillNames.map((s) => `  • ${s}`).join('\n'), `Updating ${skillNames.length} skill(s) for ${agentLabels(config.agents)}`);
+    const confirm = await clack.confirm({ message: 'Proceed with update?', initialValue: true });
+    if (clack.isCancel(confirm) || !confirm) {
+        clack.outro('Cancelled.');
+        return;
+    }
+    const spin = clack.spinner();
+    spin.start('Updating skills...');
+    try {
+        await installSkillsForAgents(skillNames, configManager.getInstallTargets(config.agents));
+        await generateWorkflows(projectRoot);
+        for (const name of skillNames) {
+            const meta = getSkillMeta(name);
+            await configManager.addSkill(name, meta?.version ?? '1.0.0');
+        }
+        spin.stop('Updated.');
+        const updated = await configManager.read();
+        if (updated?.claudeMd) {
+            await generateClaudeMd(projectRoot, updated.installedSkills, '.ai-skills/skills');
+        }
+        if (updated?.agents.includes('codex')) {
+            await generateAgentsMd(projectRoot, updated.installedSkills, '.agents/skills', '.ai-skills/workflows');
+        }
+        logger.success(`Updated ${skillNames.length} skill(s) for ${agentLabels(config.agents)}.`);
+    }
+    catch (err) {
+        spin.stop('Update failed.');
+        logger.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=update.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function validateCommand(): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAIA,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAsBrD"}

package/dist/cli/commands/validate.js

@@ -0,0 +1,22 @@
+import chalk from 'chalk';
+import { validatePackageSkills } from '../../core/validator.js';
+import { logger } from '../../utils/logger.js';
+export async function validateCommand() {
+    const result = await validatePackageSkills();
+    if (result.issues.length === 0) {
+        logger.success('Skill package validation passed.');
+        return;
+    }
+    for (const issue of result.issues) {
+        const prefix = issue.level === 'error' ? chalk.red('error') : chalk.yellow('warning');
+        const file = issue.file ? chalk.dim(` (${issue.file})`) : '';
+        console.log(`  ${prefix} ${issue.message}${file}`);
+    }
+    logger.blank();
+    if (result.errors > 0) {
+        logger.error(`Validation failed with ${result.errors} error(s) and ${result.warnings} warning(s).`);
+        process.exit(1);
+    }
+    logger.warn(`Validation passed with ${result.warnings} warning(s).`);
+}
+//# sourceMappingURL=validate.js.map