@devmunna/agent-skillkit 0.1.0

package/dist/generators/workflows.js

@@ -0,0 +1,57 @@
+import path from 'path';
+import fs from 'fs-extra';
+import { logger } from '../utils/logger.js';
+const WORKFLOWS = {
+    'implement-feature.md': [
+        '# Implement Feature Workflow',
+        '',
+        '1. Read the user request and identify the smallest useful change.',
+        '2. Inspect the existing files that own the behavior.',
+        '3. Load only the relevant installed skill files.',
+        '4. Follow existing project patterns before adding new ones.',
+        '5. Implement the feature with focused edits.',
+        '6. Run the cheapest relevant verification command.',
+        '7. Final response: summarize changed behavior and verification.',
+    ].join('\n'),
+    'fix-bug.md': [
+        '# Fix Bug Workflow',
+        '',
+        '1. Reproduce the failure or inspect the failing path.',
+        '2. Identify the smallest responsible module.',
+        '3. Load the relevant installed skill and nearby code.',
+        '4. Patch the root cause, not a broad workaround.',
+        '5. Add or update a focused test when the risk justifies it.',
+        '6. Run focused verification.',
+        '7. Final response: explain cause, fix, and verification.',
+    ].join('\n'),
+    'code-review.md': [
+        '# Code Review Workflow',
+        '',
+        '1. Prioritize bugs, regressions, security risks, and missing tests.',
+        '2. Cite exact files and lines where possible.',
+        '3. Keep summaries brief and after findings.',
+        '4. Avoid style-only comments unless they hide a real risk.',
+        '5. If no issues are found, say that clearly and mention residual risk.',
+    ].join('\n'),
+    'refactor.md': [
+        '# Refactor Workflow',
+        '',
+        '1. Preserve behavior unless the user explicitly asks for behavior change.',
+        '2. Identify tests or commands that prove behavior stayed stable.',
+        '3. Keep edits within the owning module boundaries.',
+        '4. Avoid new abstractions unless they remove real complexity.',
+        '5. Run verification and report any skipped checks.',
+    ].join('\n'),
+};
+export async function generateWorkflows(projectRoot) {
+    const workflowsDir = path.join(projectRoot, '.ai-skills', 'workflows');
+    await fs.ensureDir(workflowsDir);
+    for (const [filename, content] of Object.entries(WORKFLOWS)) {
+        await fs.writeFile(path.join(workflowsDir, filename), `${content}\n`, 'utf-8');
+    }
+    logger.step(`Workflows updated  (${Object.keys(WORKFLOWS).length} file(s))`);
+}
+export function workflowNames() {
+    return Object.keys(WORKFLOWS);
+}
+//# sourceMappingURL=workflows.js.map

package/dist/generators/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/generators/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,SAAS,GAA2B;IACxC,sBAAsB,EAAE;QACtB,8BAA8B;QAC9B,EAAE;QACF,mEAAmE;QACnE,sDAAsD;QACtD,kDAAkD;QAClD,6DAA6D;QAC7D,8CAA8C;QAC9C,oDAAoD;QACpD,iEAAiE;KAClE,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,YAAY,EAAE;QACZ,oBAAoB;QACpB,EAAE;QACF,uDAAuD;QACvD,8CAA8C;QAC9C,uDAAuD;QACvD,kDAAkD;QAClD,6DAA6D;QAC7D,8BAA8B;QAC9B,0DAA0D;KAC3D,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,gBAAgB,EAAE;QAChB,wBAAwB;QACxB,EAAE;QACF,qEAAqE;QACrE,+CAA+C;QAC/C,6CAA6C;QAC7C,4DAA4D;QAC5D,wEAAwE;KACzE,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,aAAa,EAAE;QACb,qBAAqB;QACrB,EAAE;QACF,2EAA2E;QAC3E,kEAAkE;QAClE,oDAAoD;QACpD,+DAA+D;QAC/D,oDAAoD;KACrD,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IACzD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;IACvE,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAEjC,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,GAAG,OAAO,IAAI,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './types/index.js';
+export * from './core/config-manager.js';
+export * from './core/detector.js';
+export * from './core/doctor.js';
+export * from './core/skill-registry.js';
+export * from './core/skill-resolver.js';
+export * from './core/validator.js';
+export * from './generators/agent-installer.js';
+export * from './generators/agents-md.js';
+export * from './generators/claude-md.js';
+export * from './generators/skill-generator.js';
+export * from './generators/workflows.js';
+//# 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":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from './types/index.js';
+export * from './core/config-manager.js';
+export * from './core/detector.js';
+export * from './core/doctor.js';
+export * from './core/skill-registry.js';
+export * from './core/skill-resolver.js';
+export * from './core/validator.js';
+export * from './generators/agent-installer.js';
+export * from './generators/agents-md.js';
+export * from './generators/claude-md.js';
+export * from './generators/skill-generator.js';
+export * from './generators/workflows.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,55 @@
+export type SkillCategory = 'backend' | 'frontend' | 'database' | 'architecture' | 'validation' | 'testing' | 'base';
+export type AiAgent = 'claude' | 'codex';
+export interface AgentInstallTarget {
+    agent: AiAgent;
+    skillsDir: string;
+    contextFile?: string;
+}
+export interface SkillMeta {
+    name: string;
+    version: string;
+    description: string;
+    category: SkillCategory;
+    stack: string[];
+    depends?: string[];
+    conflicts?: string[];
+    tags?: string[];
+}
+export interface SkillProfile {
+    name: string;
+    description: string;
+    skills: string[];
+    stacks: string[];
+}
+export interface ProjectConfig {
+    version: string;
+    installedSkills: InstalledSkill[];
+    outputDir: string;
+    claudeMd: boolean;
+    agents: AiAgent[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface InstalledSkill {
+    name: string;
+    version: string;
+    installedAt: string;
+}
+export interface StackSelection {
+    backend: string[];
+    frontend: string[];
+    database: string[];
+    architecture: string[];
+    validation: string[];
+}
+export interface DetectedStack {
+    packages: string[];
+    suggestedSkills: string[];
+    confidence: Record<string, number>;
+}
+export interface SkillResolution {
+    ordered: string[];
+    missing: string[];
+    conflicts: string[];
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,UAAU,GACV,UAAU,GACV,cAAc,GACd,YAAY,GACZ,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/file-utils.d.ts

@@ -0,0 +1,12 @@
+export declare const getdirname: (importMetaUrl: string) => string;
+export declare const packageRoot: () => string;
+export declare const skillsSourceDir: () => string;
+export declare const skillSourceDir: (skillName: string) => string;
+export declare function pathExists(p: string): Promise<boolean>;
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function readJson<T>(filePath: string): Promise<T>;
+export declare function writeJson(filePath: string, data: unknown): Promise<void>;
+export declare function copyDir(src: string, dest: string): Promise<void>;
+export declare function readFileSafe(filePath: string): Promise<string | null>;
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+//# sourceMappingURL=file-utils.d.ts.map

package/dist/utils/file-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../src/utils/file-utils.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,GAAI,eAAe,MAAM,KAAG,MACP,CAAC;AAE7C,eAAO,MAAM,WAAW,QAAO,MAI9B,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,MACC,CAAC;AAErC,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,KAAG,MACV,CAAC;AAE1C,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5D;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE9D;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM3E;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF"}

package/dist/utils/file-utils.js

@@ -0,0 +1,39 @@
+import { fileURLToPath } from 'url';
+import path from 'path';
+import fs from 'fs-extra';
+export const getdirname = (importMetaUrl) => path.dirname(fileURLToPath(importMetaUrl));
+export const packageRoot = () => {
+    // dist/utils/file-utils.js → up 3 levels to package root
+    const here = getdirname(import.meta.url);
+    return path.resolve(here, '../../');
+};
+export const skillsSourceDir = () => path.join(packageRoot(), 'skills');
+export const skillSourceDir = (skillName) => path.join(skillsSourceDir(), skillName);
+export async function pathExists(p) {
+    return fs.pathExists(p);
+}
+export async function ensureDir(dir) {
+    await fs.ensureDir(dir);
+}
+export async function readJson(filePath) {
+    return fs.readJson(filePath);
+}
+export async function writeJson(filePath, data) {
+    await fs.writeJson(filePath, data, { spaces: 2 });
+}
+export async function copyDir(src, dest) {
+    await fs.copy(src, dest, { overwrite: true });
+}
+export async function readFileSafe(filePath) {
+    try {
+        return await fs.readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeFile(filePath, content) {
+    await fs.ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, content, 'utf-8');
+}
+//# sourceMappingURL=file-utils.js.map

package/dist/utils/file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../src/utils/file-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,aAAqB,EAAU,EAAE,CAC1D,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;AAE7C,MAAM,CAAC,MAAM,WAAW,GAAG,GAAW,EAAE;IACtC,yDAAyD;IACzD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,GAAW,EAAE,CAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;AAErC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAiB,EAAU,EAAE,CAC1D,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,SAAS,CAAC,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,CAAS;IACxC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,QAAgB;IAChD,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAe,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAa;IAC7D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,IAAY;IACrD,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,10 @@
+export declare const logger: {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    step: (msg: string) => void;
+    dim: (msg: string) => void;
+    blank: () => void;
+};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;gBACL,MAAM;mBACH,MAAM;gBACT,MAAM;iBACL,MAAM;gBACP,MAAM;eACP,MAAM;;CAElB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,11 @@
+import chalk from 'chalk';
+export const logger = {
+    info: (msg) => console.log(`${chalk.blue('ℹ')} ${msg}`),
+    success: (msg) => console.log(`${chalk.green('✓')} ${chalk.green(msg)}`),
+    warn: (msg) => console.warn(`${chalk.yellow('⚠')} ${chalk.yellow(msg)}`),
+    error: (msg) => console.error(`${chalk.red('✗')} ${chalk.red(msg)}`),
+    step: (msg) => console.log(`${chalk.cyan('→')} ${msg}`),
+    dim: (msg) => console.log(chalk.dim(msg)),
+    blank: () => console.log(),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IAC/D,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IAChF,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChF,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5E,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IAC/D,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjD,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;CAC3B,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@devmunna/agent-skillkit",
+  "version": "0.1.0",
+  "description": "Install production-grade AI agent development skills for your project stack",
+  "type": "module",
+  "bin": {
+    "ai-skills": "bin/ai-skills.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "prepublishOnly": "npm test",
+    "init": "tsx src/cli/index.ts init"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "ai",
+    "skills",
+    "claude",
+    "copilot",
+    "cursor",
+    "codex",
+    "express",
+    "react",
+    "nextjs",
+    "prisma",
+    "developer-experience",
+    "ai-agent",
+    "mcp"
+  ],
+  "author": "Monir Hasan Munna <dev.munna007@gmail.com>",
+  "homepage": "https://github.com/Monirhasanmunna/agent-skillkit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Monirhasanmunna/agent-skillkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Monirhasanmunna/agent-skillkit/issues"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "semver": "^7.6.3"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.14.0",
+    "@types/semver": "^7.5.8",
+    "tsx": "^4.15.0",
+    "typescript": "^5.5.0"
+  }
+}

package/skills/clean-architecture/SKILL.md

@@ -0,0 +1,324 @@
+---
+name: clean-architecture
+version: 1.0.0
+description: >
+  Apply this skill when implementing Clean Architecture, Domain-Driven Design, or SOLID principles in any Node.js/TypeScript project. Triggers: "clean architecture", "domain layer", "use case", "entity", "repository interface", "dependency injection", "SOLID", "decouple business logic", "inversion of control".
+stack: []
+depends: []
+---
+
+# Clean Architecture Skill
+
+Layered architecture that decouples business logic from frameworks, databases, and delivery mechanisms.
+
+---
+
+## Layer Hierarchy
+
+```
+src/
+├── domain/                   # Enterprise business rules (no dependencies)
+│   ├── entities/             # Core business objects
+│   ├── repositories/         # Repository interfaces (not implementations)
+│   └── errors/               # Domain-specific error classes
+│
+├── application/              # Application business rules
+│   └── use-cases/            # One class per use case
+│
+├── infrastructure/           # Framework + DB implementations
+│   ├── repositories/         # Concrete repository implementations
+│   ├── database/             # ORM config, migrations
+│   └── services/             # External services (email, storage)
+│
+└── presentation/             # Delivery mechanism (HTTP, CLI, etc.)
+    ├── controllers/          # Map HTTP ↔ use case
+    ├── middlewares/
+    └── routes/
+```
+
+**Dependency Rule**: dependencies always point inward. Domain knows nothing about infrastructure. Infrastructure implements domain interfaces.
+
+---
+
+## Domain Layer
+
+### Entities
+
+```ts
+// src/domain/entities/User.ts
+export class User {
+  constructor(
+    public readonly id: string,
+    public readonly email: string,
+    public readonly name: string,
+    private readonly passwordHash: string,
+    public readonly role: UserRole,
+    public readonly createdAt: Date,
+  ) {}
+
+  isAdmin(): boolean {
+    return this.role === UserRole.ADMIN;
+  }
+
+  canDelete(targetUserId: string): boolean {
+    return this.isAdmin() || this.id === targetUserId;
+  }
+}
+
+export enum UserRole {
+  USER = 'USER',
+  ADMIN = 'ADMIN',
+}
+```
+
+### Repository Interfaces
+
+```ts
+// src/domain/repositories/IUserRepository.ts
+import type { User } from '../entities/User';
+
+export interface FindAllParams {
+  page: number;
+  limit: number;
+  search?: string;
+}
+
+export interface PaginatedResult<T> {
+  data: T[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface IUserRepository {
+  findAll(params: FindAllParams): Promise<PaginatedResult<User>>;
+  findById(id: string): Promise<User | null>;
+  findByEmail(email: string): Promise<User | null>;
+  save(user: User): Promise<User>;
+  delete(id: string): Promise<void>;
+}
+```
+
+### Domain Errors
+
+```ts
+// src/domain/errors/DomainError.ts
+export class DomainError extends Error {
+  constructor(message: string, public readonly statusCode: number = 400) {
+    super(message);
+    this.name = 'DomainError';
+  }
+}
+
+export class NotFoundError extends DomainError {
+  constructor(resource: string, id: string) {
+    super(`${resource} with id "${id}" not found`, 404);
+    this.name = 'NotFoundError';
+  }
+}
+
+export class ConflictError extends DomainError {
+  constructor(message: string) {
+    super(message, 409);
+    this.name = 'ConflictError';
+  }
+}
+
+export class ForbiddenError extends DomainError {
+  constructor(message = 'Access denied') {
+    super(message, 403);
+    this.name = 'ForbiddenError';
+  }
+}
+```
+
+---
+
+## Application Layer (Use Cases)
+
+One class per use case. Takes repository interfaces via constructor injection.
+
+```ts
+// src/application/use-cases/user/CreateUserUseCase.ts
+import type { IUserRepository } from '@/domain/repositories/IUserRepository';
+import type { IHashService } from '@/domain/services/IHashService';
+import { User, UserRole } from '@/domain/entities/User';
+import { ConflictError } from '@/domain/errors/DomainError';
+import crypto from 'crypto';
+
+interface CreateUserInput {
+  name: string;
+  email: string;
+  password: string;
+}
+
+export class CreateUserUseCase {
+  constructor(
+    private readonly userRepository: IUserRepository,
+    private readonly hashService: IHashService,
+  ) {}
+
+  async execute(input: CreateUserInput): Promise<User> {
+    const existing = await this.userRepository.findByEmail(input.email);
+    if (existing) throw new ConflictError('Email already registered');
+
+    const passwordHash = await this.hashService.hash(input.password);
+
+    const user = new User(
+      crypto.randomUUID(),
+      input.email,
+      input.name,
+      passwordHash,
+      UserRole.USER,
+      new Date(),
+    );
+
+    return this.userRepository.save(user);
+  }
+}
+```
+
+---
+
+## Infrastructure Layer (Implementations)
+
+```ts
+// src/infrastructure/repositories/PrismaUserRepository.ts
+import type { IUserRepository, FindAllParams, PaginatedResult } from '@/domain/repositories/IUserRepository';
+import type { User } from '@/domain/entities/User';
+import { UserMapper } from './mappers/UserMapper';
+import type { PrismaClient } from '@prisma/client';
+
+export class PrismaUserRepository implements IUserRepository {
+  constructor(private readonly prisma: PrismaClient) {}
+
+  async findAll({ page, limit, search }: FindAllParams): Promise<PaginatedResult<User>> {
+    const skip = (page - 1) * limit;
+    const where = search ? { name: { contains: search, mode: 'insensitive' as const } } : {};
+
+    const [rows, total] = await this.prisma.$transaction([
+      this.prisma.user.findMany({ where, skip, take: limit }),
+      this.prisma.user.count({ where }),
+    ]);
+
+    return { data: rows.map(UserMapper.toDomain), total, page, limit };
+  }
+
+  async findById(id: string): Promise<User | null> {
+    const row = await this.prisma.user.findUnique({ where: { id } });
+    return row ? UserMapper.toDomain(row) : null;
+  }
+
+  async findByEmail(email: string): Promise<User | null> {
+    const row = await this.prisma.user.findUnique({ where: { email } });
+    return row ? UserMapper.toDomain(row) : null;
+  }
+
+  async save(user: User): Promise<User> {
+    const row = await this.prisma.user.upsert({
+      where: { id: user.id },
+      update: UserMapper.toPersistence(user),
+      create: UserMapper.toPersistence(user),
+    });
+    return UserMapper.toDomain(row);
+  }
+
+  async delete(id: string): Promise<void> {
+    await this.prisma.user.delete({ where: { id } });
+  }
+}
+```
+
+---
+
+## Mapper (Domain ↔ Persistence)
+
+```ts
+// src/infrastructure/repositories/mappers/UserMapper.ts
+import type { User as PrismaUser } from '@prisma/client';
+import { User, UserRole } from '@/domain/entities/User';
+
+export class UserMapper {
+  static toDomain(raw: PrismaUser): User {
+    return new User(
+      raw.id,
+      raw.email,
+      raw.name,
+      raw.password,
+      raw.role as UserRole,
+      raw.createdAt,
+    );
+  }
+
+  static toPersistence(user: User): Omit<PrismaUser, 'updatedAt'> {
+    return {
+      id: user.id,
+      email: user.email,
+      name: user.name,
+      password: (user as unknown as { passwordHash: string }).passwordHash,
+      role: user.role,
+      createdAt: user.createdAt,
+    };
+  }
+}
+```
+
+---
+
+## Presentation Layer (Controllers)
+
+```ts
+// src/presentation/controllers/UserController.ts
+import type { CreateUserUseCase } from '@/application/use-cases/user/CreateUserUseCase';
+import type { Request, Response, NextFunction } from 'express';
+
+export class UserController {
+  constructor(private readonly createUserUseCase: CreateUserUseCase) {}
+
+  create = async (req: Request, res: Response, next: NextFunction) => {
+    try {
+      const user = await this.createUserUseCase.execute(req.body);
+      res.status(201).json({ success: true, data: user });
+    } catch (err) {
+      next(err);
+    }
+  };
+}
+```
+
+---
+
+## Dependency Injection (Manual)
+
+```ts
+// src/infrastructure/container.ts
+import { PrismaClient } from '@prisma/client';
+import { PrismaUserRepository } from './repositories/PrismaUserRepository';
+import { BcryptHashService } from './services/BcryptHashService';
+import { CreateUserUseCase } from '@/application/use-cases/user/CreateUserUseCase';
+import { UserController } from '@/presentation/controllers/UserController';
+
+const prisma = new PrismaClient();
+
+// Repositories
+const userRepository = new PrismaUserRepository(prisma);
+
+// Services
+const hashService = new BcryptHashService();
+
+// Use Cases
+const createUserUseCase = new CreateUserUseCase(userRepository, hashService);
+
+// Controllers
+export const userController = new UserController(createUserUseCase);
+```
+
+---
+
+## Rules
+
+- Domain layer has zero imports from express, prisma, mongoose, or any framework
+- Use cases depend only on interfaces, never concrete implementations
+- Mappers translate between domain objects and persistence models — keep this logic isolated
+- If a use case grows beyond ~60 lines, extract domain services
+- Test use cases by injecting mock repositories — no DB required for unit tests