@3lineas/grooveskills 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,77 @@
-# Temporary Holding Version
+# GrooveSkills 🚀
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **Multi-Agent AI Skills & Architectural Standards Installer**  
+> Empower your AI coding pairs (Antigravity, Claude Code, Cursor, Gemini) with your team's real-world architectural habits, clean code patterns, and non-negotiables.
+
+---
+
+## 🌟 Features
+
+- **⚡ Zero Configuration (`npx @3lineas/grooveskills`)**: Run inside any project root to inspect the environment and synchronize AI skills instantly.
+- **🎯 Smart Stack Detection**: Automatically inspects `package.json` dependencies and pre-selects matching skills (e.g. Hono, Valibot, React, Next.js).
+- **🤖 Multi-Agent Compatibility**:
+  - **Antigravity**: `.agents/skills/<skill-name>/`
+  - **Claude Code**: `.claude/skills/<skill-name>/`
+  - **Cursor IDE**: `.cursor/rules/<skill-name>.mdc` (auto-adapted to Cursor rules format)
+  - **Gemini Code Assist**: `.gemini/skills/<skill-name>/`
+- **✨ Interactive & Friendly CLI**: Clean terminal experience built with `@clack/prompts` and courteous, persuasive feedback.
+- **🛡️ Battle-tested Architectural Standards**:
+  - **Universal Best Practices**: Multi-language clean code (TypeScript, PHP, Dart, Rust, etc.), early returns, zero barrel files, strict typing, <200 lines per file.
+  - **Hono API Architecture**: Independent routes by domain, isolated Actions layer, database queries exclusively inside Actions, strict Valibot validation, and Cloudflare/Hono RPC.
+
+---
+
+## 🚀 Usage
+
+### 1. Interactive Mode (Recommended)
+
+Run directly in the root of any project:
+
+```bash
+npx @3lineas/grooveskills
+```
+
+GrooveSkills will automatically:
+1. Detect any active AI agent folders (`.agents`, `.claude`, `.cursor`, `.gemini`).
+2. Scan your project dependencies (`package.json`) and pre-select the recommended skills.
+3. Guide you through an interactive multi-select menu.
+4. Install and configure the skills for all chosen AI agents.
+
+---
+
+### 2. Direct / Automated Mode (CI / Scripting)
+
+Install specific skills for targeted agents without interactive prompts:
+
+```bash
+# Install specific skills for selected agents
+npx @3lineas/grooveskills --skills best-practices hono --agents antigravity claude
+
+# Automatically confirm overwrite of existing skills
+npx @3lineas/grooveskills --skills best-practices hono --agents antigravity claude cursor gemini --yes
+```
+
+#### CLI Options
+
+| Flag | Description | Example |
+| :--- | :--- | :--- |
+| `-s, --skills` | Space-separated list of skill IDs to install | `--skills best-practices hono` |
+| `-a, --agents` | Target AI agents (`antigravity`, `claude`, `cursor`, `gemini`) | `--agents antigravity cursor` |
+| `-y, --yes` | Automatically overwrite existing skills | `--yes` |
+| `-h, --help` | Display command help and options | `--help` |
+| `-V, --version` | Display the installed version of GrooveSkills | `--version` |
+
+---
+
+## 📦 Available Skills
+
+| Skill ID | Name | Description | Suggested When |
+| :--- | :--- | :--- | :--- |
+| `best-practices` | **Universal Best Practices** | Multi-language clean code, early returns, no barrel files, strict typing, <200 lines. | **Always suggested by default** (Any language/file) |
+| `hono` | **Hono Architecture (Valibot)** | Enterprise Hono standard: Valibot validation, Actions layer, RPC bindings, AppError. | Detected `hono`, `@hono/valibot-validator`, etc. |
+
+---
+
+## 📄 License
+
+MIT © [3-Lineas](https://github.com/3-Lineas)

package/dist/chunk-75476IDS.js

@@ -0,0 +1,376 @@
+// src/domains/detector/detect-agents.ts
+import { readdirSync } from "fs";
+function detectAgents(targetPath) {
+  const detected = [];
+  try {
+    const entries = new Set(readdirSync(targetPath));
+    if (entries.has(".agents")) {
+      detected.push("antigravity");
+    }
+    if (entries.has(".claude")) {
+      detected.push("claude");
+    }
+    if (entries.has(".cursor")) {
+      detected.push("cursor");
+    }
+    if (entries.has(".gemini")) {
+      detected.push("gemini");
+    }
+  } catch {
+  }
+  return detected;
+}
+
+// src/domains/detector/detect-dependencies.ts
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+function detectDependencies(targetPath) {
+  const packageJsonPath = join(targetPath, "package.json");
+  if (!existsSync(packageJsonPath)) {
+    return { dependencies: [], exists: false };
+  }
+  try {
+    const raw = readFileSync(packageJsonPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    const direct = Object.keys(parsed.dependencies ?? {});
+    const dev = Object.keys(parsed.devDependencies ?? {});
+    const all = Array.from(/* @__PURE__ */ new Set([...direct, ...dev]));
+    return { dependencies: all, exists: true };
+  } catch {
+    return { dependencies: [], exists: true };
+  }
+}
+
+// src/domains/registry/skill-catalog.ts
+var SKILL_CATALOG = [
+  {
+    id: "best-practices",
+    name: "Universal Best Practices",
+    description: "Multi-language clean code standards, early returns, no barrel files, strict typing, <200 lines",
+    dependencies: [],
+    directoryName: "best-practices"
+  },
+  {
+    id: "hono",
+    name: "Hono Architecture (Valibot)",
+    description: "Enterprise Hono API standard with Valibot validation, isolated Actions layer, and RPC bindings",
+    dependencies: ["hono", "@hono/valibot-validator", "@hono/standard-validator"],
+    directoryName: "hono"
+  }
+];
+
+// src/domains/detector/project-detector.ts
+function detectProjectContext(targetPath) {
+  const detectedAgents = detectAgents(targetPath);
+  const { dependencies, exists } = detectDependencies(targetPath);
+  const suggestedSkillIds = ["best-practices"];
+  for (const skill of SKILL_CATALOG) {
+    if (skill.dependencies.length === 0) {
+      continue;
+    }
+    const hasMatch = skill.dependencies.some((dep) => dependencies.includes(dep));
+    if (hasMatch && !suggestedSkillIds.includes(skill.id)) {
+      suggestedSkillIds.push(skill.id);
+    }
+  }
+  return {
+    targetPath,
+    detectedDependencies: dependencies,
+    suggestedSkillIds,
+    detectedAgents,
+    packageJsonExists: exists
+  };
+}
+
+// src/domains/ui/ui-orchestrator.ts
+import * as p4 from "@clack/prompts";
+import pc2 from "picocolors";
+
+// src/domains/ui/banners.ts
+import pc from "picocolors";
+function renderBanner() {
+  const title = pc.bold(pc.white(" GROOVE SKILLS "));
+  const badge = pc.bgMagenta(pc.black(title));
+  const subtitle = pc.dim("Multi-Agent AI Skills & Architectural Standards");
+  return `${badge}  ${subtitle}
+`;
+}
+
+// src/domains/ui/prompt-skills.ts
+import * as p from "@clack/prompts";
+async function promptSkills(suggestedSkillIds) {
+  const options = SKILL_CATALOG.map((skill) => {
+    const isSuggested = suggestedSkillIds.includes(skill.id);
+    return {
+      value: skill.id,
+      label: skill.name,
+      hint: isSuggested ? "Suggested based on your project stack" : skill.description
+    };
+  });
+  const selected = await p.multiselect({
+    message: "Which skills would you like to install in this project?",
+    options,
+    initialValues: suggestedSkillIds,
+    required: true
+  });
+  return selected;
+}
+
+// src/domains/ui/prompt-agents.ts
+import * as p2 from "@clack/prompts";
+async function promptAgents(detectedAgents) {
+  const options = [
+    { value: "antigravity", label: "Antigravity", hint: ".agents/skills (Google Agentic IDE)" },
+    { value: "claude", label: "Claude Code", hint: ".claude/skills (Anthropic Claude Code)" },
+    { value: "cursor", label: "Cursor", hint: ".cursor/rules/*.mdc (Cursor IDE Rules)" },
+    { value: "gemini", label: "Gemini Code Assist", hint: ".gemini/skills (Google Gemini)" }
+  ];
+  const initialValues = detectedAgents.length > 0 ? detectedAgents : ["antigravity"];
+  const selected = await p2.multiselect({
+    message: "Which AI agents should be configured?",
+    options,
+    initialValues,
+    required: true
+  });
+  return selected;
+}
+
+// src/domains/ui/prompt-confirm-overwrite.ts
+import * as p3 from "@clack/prompts";
+async function promptConfirmOverwrite() {
+  return await p3.confirm({
+    message: "Some skills already exist in this project. Would you like to overwrite them with the latest version?",
+    initialValue: true
+  });
+}
+
+// src/domains/installer/verify-skill-exists.ts
+import { existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
+var AGENT_DESTINATION_MAP = {
+  antigravity: (dir) => join2(".agents", "skills", dir),
+  claude: (dir) => join2(".claude", "skills", dir),
+  cursor: (dir) => join2(".cursor", "rules", `${dir}.mdc`),
+  gemini: (dir) => join2(".gemini", "skills", dir)
+};
+function verifySkillExists(targetPath, skillDirectoryName, agents) {
+  for (const agent of agents) {
+    const relativePathResolver = AGENT_DESTINATION_MAP[agent];
+    const destination = join2(targetPath, relativePathResolver(skillDirectoryName));
+    if (existsSync2(destination)) {
+      return true;
+    }
+  }
+  return false;
+}
+
+// src/domains/installer/install-orchestrator.ts
+import { join as join8 } from "path";
+
+// src/domains/adapters/antigravity.adapter.ts
+import { cpSync, mkdirSync, existsSync as existsSync3 } from "fs";
+import { join as join3 } from "path";
+var AntigravityAdapter = class {
+  id = "antigravity";
+  name = "Antigravity";
+  targetRelativeDir = ".agents/skills";
+  async installSkill(targetPath, skill, skillSourceDir) {
+    const destination = join3(targetPath, this.targetRelativeDir, skill.directoryName);
+    if (!existsSync3(destination)) {
+      mkdirSync(destination, { recursive: true });
+    }
+    cpSync(skillSourceDir, destination, { recursive: true });
+    return [destination];
+  }
+};
+
+// src/domains/adapters/claude.adapter.ts
+import { cpSync as cpSync2, mkdirSync as mkdirSync2, existsSync as existsSync4 } from "fs";
+import { join as join4 } from "path";
+var ClaudeAdapter = class {
+  id = "claude";
+  name = "Claude Code";
+  targetRelativeDir = ".claude/skills";
+  async installSkill(targetPath, skill, skillSourceDir) {
+    const destination = join4(targetPath, this.targetRelativeDir, skill.directoryName);
+    if (!existsSync4(destination)) {
+      mkdirSync2(destination, { recursive: true });
+    }
+    cpSync2(skillSourceDir, destination, { recursive: true });
+    return [destination];
+  }
+};
+
+// src/domains/adapters/cursor.adapter.ts
+import { writeFileSync, mkdirSync as mkdirSync3, existsSync as existsSync5, readFileSync as readFileSync2 } from "fs";
+import { join as join5 } from "path";
+var CursorAdapter = class {
+  id = "cursor";
+  name = "Cursor";
+  targetRelativeDir = ".cursor/rules";
+  async installSkill(targetPath, skill, skillSourceDir) {
+    const rulesDir = join5(targetPath, this.targetRelativeDir);
+    if (!existsSync5(rulesDir)) {
+      mkdirSync3(rulesDir, { recursive: true });
+    }
+    const skillMdPath = join5(skillSourceDir, "SKILL.md");
+    let content = "";
+    if (existsSync5(skillMdPath)) {
+      content = readFileSync2(skillMdPath, "utf-8");
+    }
+    const mdcHeader = `---
+description: ${skill.description}
+globs: ["**/*"]
+alwaysApply: false
+---
+
+`;
+    const cleanedBody = content.replace(/^---[\s\S]*?---\s*/, "");
+    const targetFile = join5(rulesDir, `${skill.id}.mdc`);
+    writeFileSync(targetFile, `${mdcHeader}${cleanedBody}`, "utf-8");
+    return [targetFile];
+  }
+};
+
+// src/domains/adapters/gemini.adapter.ts
+import { cpSync as cpSync3, mkdirSync as mkdirSync4, existsSync as existsSync6 } from "fs";
+import { join as join6 } from "path";
+var GeminiAdapter = class {
+  id = "gemini";
+  name = "Gemini Code Assist";
+  targetRelativeDir = ".gemini/skills";
+  async installSkill(targetPath, skill, skillSourceDir) {
+    const destination = join6(targetPath, this.targetRelativeDir, skill.directoryName);
+    if (!existsSync6(destination)) {
+      mkdirSync4(destination, { recursive: true });
+    }
+    cpSync3(skillSourceDir, destination, { recursive: true });
+    return [destination];
+  }
+};
+
+// src/domains/installer/resolve-skills-source.ts
+import { fileURLToPath } from "url";
+import { dirname, resolve, join as join7 } from "path";
+import { existsSync as existsSync7 } from "fs";
+function resolveSkillsSourceRoot() {
+  const currentFilePath = fileURLToPath(import.meta.url);
+  const currentDir = dirname(currentFilePath);
+  const candidate1 = resolve(currentDir, "../../../skills");
+  if (existsSync7(candidate1)) {
+    return candidate1;
+  }
+  const candidate2 = resolve(currentDir, "../../skills");
+  if (existsSync7(candidate2)) {
+    return candidate2;
+  }
+  const candidate3 = resolve(process.cwd(), "skills");
+  if (existsSync7(candidate3)) {
+    return candidate3;
+  }
+  return join7(process.cwd(), "skills");
+}
+
+// src/domains/installer/install-orchestrator.ts
+var ADAPTER_REGISTRY = {
+  antigravity: new AntigravityAdapter(),
+  claude: new ClaudeAdapter(),
+  cursor: new CursorAdapter(),
+  gemini: new GeminiAdapter()
+};
+async function installSkills(options) {
+  const sourceRoot = resolveSkillsSourceRoot();
+  const createdFiles = [];
+  for (const skillId of options.selectedSkillIds) {
+    const skill = SKILL_CATALOG.find((item) => item.id === skillId);
+    if (!skill) {
+      continue;
+    }
+    const skillSourceDir = join8(sourceRoot, skill.directoryName);
+    for (const agentId of options.selectedAgents) {
+      const adapter = ADAPTER_REGISTRY[agentId];
+      if (!adapter) {
+        continue;
+      }
+      const files = await adapter.installSkill(options.targetPath, skill, skillSourceDir);
+      createdFiles.push(...files);
+    }
+  }
+  return {
+    installedSkills: options.selectedSkillIds,
+    configuredAgents: options.selectedAgents,
+    createdFiles
+  };
+}
+
+// src/domains/ui/ui-orchestrator.ts
+async function runInteractiveUi(context) {
+  console.log(renderBanner());
+  p4.intro(pc2.magenta("Welcome to GrooveSkills! Let's tailor your AI agents with clean architectural standards."));
+  if (context.detectedDependencies.length > 0) {
+    p4.note(
+      `Detected dependencies: ${context.detectedDependencies.map((d) => pc2.bold(d)).join(", ")}
+Active AI folders: ${context.detectedAgents.map((a) => pc2.green(a)).join(", ") || "None (will be created)"}`,
+      "Project Environment"
+    );
+  }
+  const selectedSkills = await promptSkills(context.suggestedSkillIds);
+  if (p4.isCancel(selectedSkills)) {
+    p4.cancel("Installation cancelled. Have a wonderful day!");
+    process.exit(0);
+  }
+  const selectedAgents = await promptAgents(context.detectedAgents);
+  if (p4.isCancel(selectedAgents)) {
+    p4.cancel("Installation cancelled. Have a wonderful day!");
+    process.exit(0);
+  }
+  let forceOverwrite = true;
+  const anyExists = selectedSkills.some((skillId) => {
+    const meta = SKILL_CATALOG.find((s2) => s2.id === skillId);
+    return meta ? verifySkillExists(context.targetPath, meta.directoryName, selectedAgents) : false;
+  });
+  if (anyExists) {
+    const confirm2 = await promptConfirmOverwrite();
+    if (p4.isCancel(confirm2) || !confirm2) {
+      p4.cancel("Installation stopped to protect existing skills.");
+      process.exit(0);
+    }
+    forceOverwrite = Boolean(confirm2);
+  }
+  const s = p4.spinner();
+  s.start("Installing and adapting skills across your configured AI agents...");
+  const result = await installSkills({
+    targetPath: context.targetPath,
+    selectedSkillIds: selectedSkills,
+    selectedAgents,
+    forceOverwrite
+  });
+  s.stop(pc2.green("All skills have been successfully installed and configured!"));
+  p4.note(
+    `Configured skills: ${result.installedSkills.map((s2) => pc2.bold(s2)).join(", ")}
+Target agents: ${result.configuredAgents.map((a) => pc2.cyan(a)).join(", ")}`,
+    "Installation Summary"
+  );
+  p4.outro(pc2.green("Your AI programming pair is now empowered with your team's architectural habits! \u{1F680}"));
+}
+
+// src/main.ts
+async function runGrooveSkills(options = {}) {
+  const targetPath = process.cwd();
+  const context = detectProjectContext(targetPath);
+  if (options.skills && options.skills.length > 0 && options.agents && options.agents.length > 0) {
+    await installSkills({
+      targetPath,
+      selectedSkillIds: options.skills,
+      selectedAgents: options.agents,
+      forceOverwrite: Boolean(options.yes)
+    });
+    return;
+  }
+  await runInteractiveUi(context);
+}
+
+export {
+  runGrooveSkills
+};
+//# sourceMappingURL=chunk-75476IDS.js.map

package/dist/chunk-75476IDS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/domains/detector/detect-agents.ts","../src/domains/detector/detect-dependencies.ts","../src/domains/registry/skill-catalog.ts","../src/domains/detector/project-detector.ts","../src/domains/ui/ui-orchestrator.ts","../src/domains/ui/banners.ts","../src/domains/ui/prompt-skills.ts","../src/domains/ui/prompt-agents.ts","../src/domains/ui/prompt-confirm-overwrite.ts","../src/domains/installer/verify-skill-exists.ts","../src/domains/installer/install-orchestrator.ts","../src/domains/adapters/antigravity.adapter.ts","../src/domains/adapters/claude.adapter.ts","../src/domains/adapters/cursor.adapter.ts","../src/domains/adapters/gemini.adapter.ts","../src/domains/installer/resolve-skills-source.ts","../src/main.ts"],"sourcesContent":["import { readdirSync } from \"node:fs\";\nimport type { AgentId } from \"@/types/agent.types\";\n\nexport function detectAgents(targetPath: string): AgentId[] {\n  const detected: AgentId[] = [];\n\n  try {\n    const entries = new Set(readdirSync(targetPath));\n\n    if (entries.has(\".agents\")) {\n      detected.push(\"antigravity\");\n    }\n    if (entries.has(\".claude\")) {\n      detected.push(\"claude\");\n    }\n    if (entries.has(\".cursor\")) {\n      detected.push(\"cursor\");\n    }\n    if (entries.has(\".gemini\")) {\n      detected.push(\"gemini\");\n    }\n  } catch {\n    // If directory cannot be read, return empty list gracefully\n  }\n\n  return detected;\n}\n","import { readFileSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface PackageJsonDetection {\n  dependencies: string[];\n  exists: boolean;\n}\n\nexport function detectDependencies(targetPath: string): PackageJsonDetection {\n  const packageJsonPath = join(targetPath, \"package.json\");\n\n  if (!existsSync(packageJsonPath)) {\n    return { dependencies: [], exists: false };\n  }\n\n  try {\n    const raw = readFileSync(packageJsonPath, \"utf-8\");\n    const parsed = JSON.parse(raw) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n\n    const direct = Object.keys(parsed.dependencies ?? {});\n    const dev = Object.keys(parsed.devDependencies ?? {});\n    const all = Array.from(new Set([...direct, ...dev]));\n\n    return { dependencies: all, exists: true };\n  } catch {\n    return { dependencies: [], exists: true };\n  }\n}\n","import type { SkillMetadata } from \"@/types/skill.types\";\n\nexport const SKILL_CATALOG: SkillMetadata[] = [\n  {\n    id: \"best-practices\",\n    name: \"Universal Best Practices\",\n    description: \"Multi-language clean code standards, early returns, no barrel files, strict typing, <200 lines\",\n    dependencies: [],\n    directoryName: \"best-practices\",\n  },\n  {\n    id: \"hono\",\n    name: \"Hono Architecture (Valibot)\",\n    description: \"Enterprise Hono API standard with Valibot validation, isolated Actions layer, and RPC bindings\",\n    dependencies: [\"hono\", \"@hono/valibot-validator\", \"@hono/standard-validator\"],\n    directoryName: \"hono\",\n  },\n];\n","import { detectAgents } from \"@/domains/detector/detect-agents\";\nimport { detectDependencies } from \"@/domains/detector/detect-dependencies\";\nimport { SKILL_CATALOG } from \"@/domains/registry/skill-catalog\";\nimport type { ProjectContext } from \"@/types/context.types\";\n\nexport function detectProjectContext(targetPath: string): ProjectContext {\n  const detectedAgents = detectAgents(targetPath);\n  const { dependencies, exists } = detectDependencies(targetPath);\n\n  const suggestedSkillIds: string[] = [\"best-practices\"];\n\n  for (const skill of SKILL_CATALOG) {\n    if (skill.dependencies.length === 0) {\n      continue;\n    }\n    const hasMatch = skill.dependencies.some((dep) => dependencies.includes(dep));\n    if (hasMatch && !suggestedSkillIds.includes(skill.id)) {\n      suggestedSkillIds.push(skill.id);\n    }\n  }\n\n  return {\n    targetPath,\n    detectedDependencies: dependencies,\n    suggestedSkillIds,\n    detectedAgents,\n    packageJsonExists: exists,\n  };\n}\n","import * as p from \"@clack/prompts\";\nimport pc from \"picocolors\";\nimport { renderBanner } from \"@/domains/ui/banners\";\nimport { promptSkills } from \"@/domains/ui/prompt-skills\";\nimport { promptAgents } from \"@/domains/ui/prompt-agents\";\nimport { promptConfirmOverwrite } from \"@/domains/ui/prompt-confirm-overwrite\";\nimport { verifySkillExists } from \"@/domains/installer/verify-skill-exists\";\nimport { installSkills } from \"@/domains/installer/install-orchestrator\";\nimport { SKILL_CATALOG } from \"@/domains/registry/skill-catalog\";\nimport type { ProjectContext } from \"@/types/context.types\";\nimport type { AgentId } from \"@/types/agent.types\";\n\nexport async function runInteractiveUi(context: ProjectContext): Promise<void> {\n  console.log(renderBanner());\n  p.intro(pc.magenta(\"Welcome to GrooveSkills! Let's tailor your AI agents with clean architectural standards.\"));\n\n  if (context.detectedDependencies.length > 0) {\n    p.note(\n      `Detected dependencies: ${context.detectedDependencies.map((d) => pc.bold(d)).join(\", \")}\\n` +\n      `Active AI folders: ${context.detectedAgents.map((a) => pc.green(a)).join(\", \") || \"None (will be created)\"}`,\n      \"Project Environment\"\n    );\n  }\n\n  const selectedSkills = await promptSkills(context.suggestedSkillIds);\n  if (p.isCancel(selectedSkills)) {\n    p.cancel(\"Installation cancelled. Have a wonderful day!\");\n    process.exit(0);\n  }\n\n  const selectedAgents = await promptAgents(context.detectedAgents);\n  if (p.isCancel(selectedAgents)) {\n    p.cancel(\"Installation cancelled. Have a wonderful day!\");\n    process.exit(0);\n  }\n\n  let forceOverwrite = true;\n  const anyExists = (selectedSkills as string[]).some((skillId) => {\n    const meta = SKILL_CATALOG.find((s) => s.id === skillId);\n    return meta ? verifySkillExists(context.targetPath, meta.directoryName, selectedAgents as AgentId[]) : false;\n  });\n\n  if (anyExists) {\n    const confirm = await promptConfirmOverwrite();\n    if (p.isCancel(confirm) || !confirm) {\n      p.cancel(\"Installation stopped to protect existing skills.\");\n      process.exit(0);\n    }\n    forceOverwrite = Boolean(confirm);\n  }\n\n  const s = p.spinner();\n  s.start(\"Installing and adapting skills across your configured AI agents...\");\n\n  const result = await installSkills({\n    targetPath: context.targetPath,\n    selectedSkillIds: selectedSkills as string[],\n    selectedAgents: selectedAgents as AgentId[],\n    forceOverwrite,\n  });\n\n  s.stop(pc.green(\"All skills have been successfully installed and configured!\"));\n\n  p.note(\n    `Configured skills: ${result.installedSkills.map((s) => pc.bold(s)).join(\", \")}\\n` +\n    `Target agents: ${result.configuredAgents.map((a) => pc.cyan(a)).join(\", \")}`,\n    \"Installation Summary\"\n  );\n\n  p.outro(pc.green(\"Your AI programming pair is now empowered with your team's architectural habits! 🚀\"));\n}\n","import pc from \"picocolors\";\n\nexport function renderBanner(): string {\n  const title = pc.bold(pc.white(\" GROOVE SKILLS \"));\n  const badge = pc.bgMagenta(pc.black(title));\n  const subtitle = pc.dim(\"Multi-Agent AI Skills & Architectural Standards\");\n\n  return `${badge}  ${subtitle}\\n`;\n}\n","import * as p from \"@clack/prompts\";\nimport { SKILL_CATALOG } from \"@/domains/registry/skill-catalog\";\n\nexport async function promptSkills(suggestedSkillIds: string[]): Promise<string[] | symbol> {\n  const options = SKILL_CATALOG.map((skill) => {\n    const isSuggested = suggestedSkillIds.includes(skill.id);\n    return {\n      value: skill.id,\n      label: skill.name,\n      hint: isSuggested ? \"Suggested based on your project stack\" : skill.description,\n    };\n  });\n\n  const selected = await p.multiselect({\n    message: \"Which skills would you like to install in this project?\",\n    options,\n    initialValues: suggestedSkillIds,\n    required: true,\n  });\n\n  return selected;\n}\n","import * as p from \"@clack/prompts\";\nimport type { AgentId } from \"@/types/agent.types\";\n\nexport async function promptAgents(detectedAgents: AgentId[]): Promise<AgentId[] | symbol> {\n  const options: Array<{ value: AgentId; label: string; hint: string }> = [\n    { value: \"antigravity\", label: \"Antigravity\", hint: \".agents/skills (Google Agentic IDE)\" },\n    { value: \"claude\", label: \"Claude Code\", hint: \".claude/skills (Anthropic Claude Code)\" },\n    { value: \"cursor\", label: \"Cursor\", hint: \".cursor/rules/*.mdc (Cursor IDE Rules)\" },\n    { value: \"gemini\", label: \"Gemini Code Assist\", hint: \".gemini/skills (Google Gemini)\" },\n  ];\n\n  const initialValues: AgentId[] = detectedAgents.length > 0 ? detectedAgents : [\"antigravity\"];\n\n  const selected = await p.multiselect({\n    message: \"Which AI agents should be configured?\",\n    options,\n    initialValues,\n    required: true,\n  });\n\n  return selected as AgentId[] | symbol;\n}\n","import * as p from \"@clack/prompts\";\n\nexport async function promptConfirmOverwrite(): Promise<boolean | symbol> {\n  return await p.confirm({\n    message: \"Some skills already exist in this project. Would you like to overwrite them with the latest version?\",\n    initialValue: true,\n  });\n}\n","import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AgentId } from \"@/types/agent.types\";\n\nconst AGENT_DESTINATION_MAP: Record<AgentId, (dir: string) => string> = {\n  antigravity: (dir) => join(\".agents\", \"skills\", dir),\n  claude: (dir) => join(\".claude\", \"skills\", dir),\n  cursor: (dir) => join(\".cursor\", \"rules\", `${dir}.mdc`),\n  gemini: (dir) => join(\".gemini\", \"skills\", dir),\n};\n\nexport function verifySkillExists(\n  targetPath: string,\n  skillDirectoryName: string,\n  agents: AgentId[]\n): boolean {\n  for (const agent of agents) {\n    const relativePathResolver = AGENT_DESTINATION_MAP[agent];\n    const destination = join(targetPath, relativePathResolver(skillDirectoryName));\n    if (existsSync(destination)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n","import { join } from \"node:path\";\nimport { AntigravityAdapter } from \"@/domains/adapters/antigravity.adapter\";\nimport { ClaudeAdapter } from \"@/domains/adapters/claude.adapter\";\nimport { CursorAdapter } from \"@/domains/adapters/cursor.adapter\";\nimport { GeminiAdapter } from \"@/domains/adapters/gemini.adapter\";\nimport { resolveSkillsSourceRoot } from \"@/domains/installer/resolve-skills-source\";\nimport { SKILL_CATALOG } from \"@/domains/registry/skill-catalog\";\nimport type { AgentAdapter } from \"@/domains/adapters/adapter.interface\";\nimport type { InstallOptions, InstallResult } from \"@/types/installer.types\";\nimport type { AgentId } from \"@/types/agent.types\";\n\nconst ADAPTER_REGISTRY: Record<AgentId, AgentAdapter> = {\n  antigravity: new AntigravityAdapter(),\n  claude: new ClaudeAdapter(),\n  cursor: new CursorAdapter(),\n  gemini: new GeminiAdapter(),\n};\n\nexport async function installSkills(options: InstallOptions): Promise<InstallResult> {\n  const sourceRoot = resolveSkillsSourceRoot();\n  const createdFiles: string[] = [];\n\n  for (const skillId of options.selectedSkillIds) {\n    const skill = SKILL_CATALOG.find((item) => item.id === skillId);\n    if (!skill) {\n      continue;\n    }\n\n    const skillSourceDir = join(sourceRoot, skill.directoryName);\n\n    for (const agentId of options.selectedAgents) {\n      const adapter = ADAPTER_REGISTRY[agentId];\n      if (!adapter) {\n        continue;\n      }\n\n      const files = await adapter.installSkill(options.targetPath, skill, skillSourceDir);\n      createdFiles.push(...files);\n    }\n  }\n\n  return {\n    installedSkills: options.selectedSkillIds,\n    configuredAgents: options.selectedAgents,\n    createdFiles,\n  };\n}\n","import { cpSync, mkdirSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AgentAdapter } from \"@/domains/adapters/adapter.interface\";\nimport type { SkillMetadata } from \"@/types/skill.types\";\n\nexport class AntigravityAdapter implements AgentAdapter {\n  readonly id = \"antigravity\" as const;\n  readonly name = \"Antigravity\";\n  readonly targetRelativeDir = \".agents/skills\";\n\n  async installSkill(\n    targetPath: string,\n    skill: SkillMetadata,\n    skillSourceDir: string\n  ): Promise<string[]> {\n    const destination = join(targetPath, this.targetRelativeDir, skill.directoryName);\n\n    if (!existsSync(destination)) {\n      mkdirSync(destination, { recursive: true });\n    }\n\n    cpSync(skillSourceDir, destination, { recursive: true });\n\n    return [destination];\n  }\n}\n","import { cpSync, mkdirSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AgentAdapter } from \"@/domains/adapters/adapter.interface\";\nimport type { SkillMetadata } from \"@/types/skill.types\";\n\nexport class ClaudeAdapter implements AgentAdapter {\n  readonly id = \"claude\" as const;\n  readonly name = \"Claude Code\";\n  readonly targetRelativeDir = \".claude/skills\";\n\n  async installSkill(\n    targetPath: string,\n    skill: SkillMetadata,\n    skillSourceDir: string\n  ): Promise<string[]> {\n    const destination = join(targetPath, this.targetRelativeDir, skill.directoryName);\n\n    if (!existsSync(destination)) {\n      mkdirSync(destination, { recursive: true });\n    }\n\n    cpSync(skillSourceDir, destination, { recursive: true });\n\n    return [destination];\n  }\n}\n","import { writeFileSync, mkdirSync, existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AgentAdapter } from \"@/domains/adapters/adapter.interface\";\nimport type { SkillMetadata } from \"@/types/skill.types\";\n\nexport class CursorAdapter implements AgentAdapter {\n  readonly id = \"cursor\" as const;\n  readonly name = \"Cursor\";\n  readonly targetRelativeDir = \".cursor/rules\";\n\n  async installSkill(\n    targetPath: string,\n    skill: SkillMetadata,\n    skillSourceDir: string\n  ): Promise<string[]> {\n    const rulesDir = join(targetPath, this.targetRelativeDir);\n\n    if (!existsSync(rulesDir)) {\n      mkdirSync(rulesDir, { recursive: true });\n    }\n\n    const skillMdPath = join(skillSourceDir, \"SKILL.md\");\n    let content = \"\";\n\n    if (existsSync(skillMdPath)) {\n      content = readFileSync(skillMdPath, \"utf-8\");\n    }\n\n    const mdcHeader = `---\ndescription: ${skill.description}\nglobs: [\"**/*\"]\nalwaysApply: false\n---\n\n`;\n\n    const cleanedBody = content.replace(/^---[\\s\\S]*?---\\s*/, \"\");\n    const targetFile = join(rulesDir, `${skill.id}.mdc`);\n\n    writeFileSync(targetFile, `${mdcHeader}${cleanedBody}`, \"utf-8\");\n\n    return [targetFile];\n  }\n}\n","import { cpSync, mkdirSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AgentAdapter } from \"@/domains/adapters/adapter.interface\";\nimport type { SkillMetadata } from \"@/types/skill.types\";\n\nexport class GeminiAdapter implements AgentAdapter {\n  readonly id = \"gemini\" as const;\n  readonly name = \"Gemini Code Assist\";\n  readonly targetRelativeDir = \".gemini/skills\";\n\n  async installSkill(\n    targetPath: string,\n    skill: SkillMetadata,\n    skillSourceDir: string\n  ): Promise<string[]> {\n    const destination = join(targetPath, this.targetRelativeDir, skill.directoryName);\n\n    if (!existsSync(destination)) {\n      mkdirSync(destination, { recursive: true });\n    }\n\n    cpSync(skillSourceDir, destination, { recursive: true });\n\n    return [destination];\n  }\n}\n","import { fileURLToPath } from \"node:url\";\nimport { dirname, resolve, join } from \"node:path\";\nimport { existsSync } from \"node:fs\";\n\nexport function resolveSkillsSourceRoot(): string {\n  const currentFilePath = fileURLToPath(import.meta.url);\n  const currentDir = dirname(currentFilePath);\n\n  const candidate1 = resolve(currentDir, \"../../../skills\");\n  if (existsSync(candidate1)) {\n    return candidate1;\n  }\n\n  const candidate2 = resolve(currentDir, \"../../skills\");\n  if (existsSync(candidate2)) {\n    return candidate2;\n  }\n\n  const candidate3 = resolve(process.cwd(), \"skills\");\n  if (existsSync(candidate3)) {\n    return candidate3;\n  }\n\n  return join(process.cwd(), \"skills\");\n}\n","import { detectProjectContext } from \"@/domains/detector/project-detector\";\nimport { runInteractiveUi } from \"@/domains/ui/ui-orchestrator\";\nimport { installSkills } from \"@/domains/installer/install-orchestrator\";\nimport type { AgentId } from \"@/types/agent.types\";\n\nexport interface CliOptions {\n  skills?: string[];\n  agents?: AgentId[];\n  yes?: boolean;\n}\n\nexport async function runGrooveSkills(options: CliOptions = {}): Promise<void> {\n  const targetPath = process.cwd();\n  const context = detectProjectContext(targetPath);\n\n  if (options.skills && options.skills.length > 0 && options.agents && options.agents.length > 0) {\n    await installSkills({\n      targetPath,\n      selectedSkillIds: options.skills,\n      selectedAgents: options.agents,\n      forceOverwrite: Boolean(options.yes),\n    });\n    return;\n  }\n\n  await runInteractiveUi(context);\n}\n"],"mappings":"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","names":["p","pc","p","p","existsSync","join","join","existsSync","join","cpSync","mkdirSync","existsSync","join","mkdirSync","existsSync","readFileSync","join","cpSync","mkdirSync","existsSync","join","join","existsSync","join","pc","s","confirm"]}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import {
+  runGrooveSkills
+} from "./chunk-75476IDS.js";
+
+// bin/cli.ts
+import { Command } from "commander";
+var program = new Command();
+program.name("grooveskills").description("Multi-agent AI skills and architecture standards installer").version("1.0.0").option("-s, --skills <skills...>", "Specific skill IDs to install (e.g. best-practices hono)").option("-a, --agents <agents...>", "Target AI agents (antigravity claude cursor gemini)").option("-y, --yes", "Automatically confirm overwrite of existing skills", false).action(async (options) => {
+  try {
+    await runGrooveSkills({
+      skills: options.skills,
+      agents: options.agents,
+      yes: options.yes
+    });
+  } catch (error) {
+    console.error("An unexpected error occurred while running GrooveSkills:", error);
+    process.exit(1);
+  }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../bin/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from \"commander\";\nimport { runGrooveSkills } from \"@/main\";\nimport type { AgentId } from \"@/types/agent.types\";\n\nconst program = new Command();\n\nprogram\n  .name(\"grooveskills\")\n  .description(\"Multi-agent AI skills and architecture standards installer\")\n  .version(\"1.0.0\")\n  .option(\"-s, --skills <skills...>\", \"Specific skill IDs to install (e.g. best-practices hono)\")\n  .option(\"-a, --agents <agents...>\", \"Target AI agents (antigravity claude cursor gemini)\")\n  .option(\"-y, --yes\", \"Automatically confirm overwrite of existing skills\", false)\n  .action(async (options: { skills?: string[]; agents?: string[]; yes?: boolean }) => {\n    try {\n      await runGrooveSkills({\n        skills: options.skills,\n        agents: options.agents as AgentId[] | undefined,\n        yes: options.yes,\n      });\n    } catch (error) {\n      console.error(\"An unexpected error occurred while running GrooveSkills:\", error);\n      process.exit(1);\n    }\n  });\n\nprogram.parse();\n"],"mappings":";;;;;;AACA,SAAS,eAAe;AAIxB,IAAM,UAAU,IAAI,QAAQ;AAE5B,QACG,KAAK,cAAc,EACnB,YAAY,4DAA4D,EACxE,QAAQ,OAAO,EACf,OAAO,4BAA4B,0DAA0D,EAC7F,OAAO,4BAA4B,qDAAqD,EACxF,OAAO,aAAa,sDAAsD,KAAK,EAC/E,OAAO,OAAO,YAAqE;AAClF,MAAI;AACF,UAAM,gBAAgB;AAAA,MACpB,QAAQ,QAAQ;AAAA,MAChB,QAAQ,QAAQ;AAAA,MAChB,KAAK,QAAQ;AAAA,IACf,CAAC;AAAA,EACH,SAAS,OAAO;AACd,YAAQ,MAAM,4DAA4D,KAAK;AAC/E,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF,CAAC;AAEH,QAAQ,MAAM;","names":[]}

package/dist/main.d.ts

@@ -0,0 +1,10 @@
+type AgentId = "antigravity" | "claude" | "cursor" | "gemini";
+
+interface CliOptions {
+    skills?: string[];
+    agents?: AgentId[];
+    yes?: boolean;
+}
+declare function runGrooveSkills(options?: CliOptions): Promise<void>;
+
+export { type CliOptions, runGrooveSkills };

package/dist/main.js

@@ -0,0 +1,7 @@
+import {
+  runGrooveSkills
+} from "./chunk-75476IDS.js";
+export {
+  runGrooveSkills
+};
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@3lineas/grooveskills",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Multi-agent CLI to install opinionated AI coding skills and architectural standards (Hono, React, Next.js, and more)",
+  "type": "module",
+  "bin": {
+    "grooveskills": "./dist/cli.js"
+  },
+  "main": "./dist/main.js",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "check-types": "tsc --noEmit",
+    "prepublishOnly": "pnpm run check-types && pnpm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/3-Lineas/GrooveSkills.git"
+  },
+  "keywords": [
+    "skills",
+    "agents",
+    "antigravity",
+    "claude",
+    "cursor",
+    "gemini",
+    "hono",
+    "valibot"
+  ],
+  "author": "3-Lineas",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.9.1",
+    "commander": "^13.1.0",
+    "picocolors": "^1.1.1",
+    "valibot": "^1.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md"
+  ]
+}

package/skills/best-practices/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: best-practices
+description: Universal coding standards, clean architecture, error handling, and file structure guidelines. TRIGGER when writing, creating, or refactoring ANY file, function, module, or component in ANY programming language (TypeScript, PHP, Dart, Rust, Go, Python, etc.) across the project.
+---
+
+# Universal Best Practices & Clean Architecture
+
+Universal guidelines applicable to **any programming language** and **any file** in the project.
+
+---
+
+## 1. Golden Rules (Non-negotiable)
+
+1. **Strict Typing (Zero `any`, Zero `dynamic`)**:
+   - Every variable, parameter, property, and return value must have a concrete type.
+   - For TypeScript: `any` is forbidden. Use generics or `unknown` with type guards.
+   - For Dart: `dynamic` is forbidden. Use generics or `Object`.
+   - For PHP: Use strict typing (`declare(strict_types=1);`), typed properties, arguments, and return types.
+   - For Rust: Explicit types and structured `Result<T, E>` / `Option<T>`.
+
+2. **Always Use Path Aliases (`@/...`)**:
+   - Never use deep relative paths (`../../..`).
+   - Use configured aliases (e.g. `@/actions/...`, `@/domains/...`, or language package namespaces).
+
+3. **Zero Barrel Files (No re-exporting `index.ts`)**:
+   - Never create `index.ts`, `mod.rs`, or library barrel files whose only purpose is re-exporting.
+   - Always import directly and explicitly from the file defining the symbol.
+
+4. **Early Return / Guard Clauses (No Nested `if`)**:
+   - Never nest `if` conditions ("pyramid of doom").
+   - Validate preconditions first and fail fast (return or throw). The happy path stays unindented.
+
+5. **Single Responsibility Principle (SRP per file)**:
+   - Every file must do exactly one thing. One action per action file, one endpoint per route file.
+
+6. **Hard Size Limit: 200 Lines Max**:
+   - No file may exceed 200 lines. If a file approaches 200 lines, extract helper logic into dedicated atomic files.
+
+7. **Structured Logging and Safe Error Handling**:
+   - Wrap I/O operations (network, database, file system) in `try / catch` or `Result`.
+   - Log errors with contextual metadata (`file`, `line`, `details`).
+   - Propagate typed errors (`AppError`) up to the controller/router layer.
+
+8. **Polite, Persuasive, and Professional Communication**:
+   - User-facing messages, validation feedback, and notifications must be courteous, engaging, solution-oriented, and professional in English.
+   - Celebrate user milestones, guide them clearly through errors, and encourage action.
+
+---
+
+## 2. Guard Clauses Example
+
+```ts
+// ✅ CORRECT (Early return / Guard clause):
+export function processTransaction(tx: Transaction): Receipt {
+  if (!tx.isValid) {
+    throw new AppError({
+      message: "Please provide a valid transaction to continue.",
+      statusCode: 400,
+    });
+  }
+
+  if (tx.isExpired) {
+    throw new AppError({
+      message: "Your payment session has timed out. Please initiate a new request.",
+      statusCode: 410,
+    });
+  }
+
+  return executePayment(tx);
+}
+
+// ❌ FORBIDDEN (Nested ifs):
+export function processTransaction(tx: Transaction) {
+  if (tx.isValid) {
+    if (!tx.isExpired) {
+      return executePayment(tx);
+    }
+  }
+}
+```
+
+---
+
+## 3. Direct Import Example
+
+```ts
+// ✅ CORRECT (Direct import with alias):
+import { registerUserAction } from "@/actions/auth/register-user.action.ts";
+import { AppError } from "@/errors/app-error.ts";
+
+// ❌ FORBIDDEN (Barrel import & relative path):
+import { registerUserAction } from "../../actions/auth";
+```

package/skills/hono/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: hono
+description: Use when building or modifying Hono APIs, endpoints, middlewares, or actions. TRIGGER when the project imports 'hono', when modifying routes in src/modules/ or actions in src/actions/, or when the user mentions Hono, API endpoints, or routing. Always validate with Valibot (* as v from 'valibot') and adhere to the 'best-practices' skill.
+---
+
+# Hono Architecture & Opinionated Best Practices
+
+Standardized guide for building robust, scalable, enterprise-grade Hono applications with isolated domain layers, strict Valibot validation, and typed Actions.
+
+---
+
+## 1. Golden Rules (Non-negotiable)
+
+1. **Standard Schema Validator with Valibot**:
+   - Always use **Valibot** (`* as v from "valibot"`) with `@hono/standard-validator` (`sValidator`) or `@hono/valibot-validator`.
+   - Never use Zod.
+2. **Mandatory Path Aliases (`@/...`)**:
+   - Import all internal modules using configured path aliases (`@/actions/...`, `@/schemas/...`, `@/errors/...`).
+3. **Zero Barrel Files**:
+   - Never create `index.ts` files that re-export multiple routes or actions.
+   - Import directly from each specific action and schema file.
+4. **Independent Route per File by Domain**:
+   - Every single endpoint resides in its own file (`src/modules/{domain}/{action}.ts`).
+   - Group them under the domain router `src/modules/{domain}/{domain}.router.ts`.
+5. **Business Logic Exclusively in Actions**:
+   - All business logic lives inside `src/actions/{domain}/{action}.action.ts`.
+   - Routers are slim controllers: validate input, call the action, return the response.
+6. **Database Connections strictly in Actions**:
+   - Never execute SQL, D1, Drizzle, or Prisma queries inside routes or middleware.
+   - The database instance is injected from Hono context (`ctx.get("db")`) into the action function.
+7. **Single Responsibility Principle (SRP)**:
+   - Each action performs **exactly one** business action.
+8. **Hard File Limit**:
+   - Maximum **200 lines per file**.
+9. **Unified Error Handling**:
+   - Throw typed `AppError` instances for business failures.
+   - Wrap I/O operations in `try / catch`, log with structured `Logger`, and re-throw or propagate to `globalErrorHandler`.
+10. **Courteous and Professional User Feedback**:
+    - Return polite, engaging, and solution-oriented messages in English (`ActionResponse<T>`).
+
+---
+
+## 2. Directory Taxonomy
+
+```text
+apps/api/src/
+├── actions/                         # Pure business logic layer
+│   └── auth/
+│       ├── register-user.action.ts  # One atomic action (< 100 lines)
+│       └── login-user.action.ts
+├── modules/                         # Thin HTTP controllers
+│   └── auth/
+│       ├── register-user.ts         # Endpoint definition (< 80 lines)
+│       └── auth.router.ts           # Domain router mounting endpoints (< 60 lines)
+├── schemas/                         # Valibot schemas
+│   └── auth/
+│       └── register-user.schema.ts  # Strict input schema (< 50 lines)
+├── errors/
+│   ├── app-error.ts                 # Base application error with auto-logging
+│   └── error-handler.ts             # Central Hono error handler
+└── routers/
+    └── api.router.ts                # Root router exporting ApiRouter type for RPC
+```
+
+---
+
+## 3. Valibot Validation Example
+
+```ts
+import { sValidator } from "@hono/standard-validator";
+import * as v from "valibot";
+
+export const loginSchema = v.object({
+  email: v.pipe(
+    v.string("Please provide your email address."),
+    v.email("Please provide a valid email address.")
+  ),
+  password: v.pipe(
+    v.string("Password is required."),
+    v.minLength(8, "Your password must be at least 8 characters long.")
+  ),
+});
+
+export type LoginInput = v.InferOutput<typeof loginSchema>;
+```
+
+---
+
+## 4. Standard Response Contract
+
+```ts
+export interface ActionResponse<T = unknown> {
+  success: boolean;
+  message?: string;
+  error?: string;
+  data?: T;
+}
+```

package/skills/hono/templates/action.template.md

@@ -0,0 +1,47 @@
+# Action Template (Single Responsibility Principle)
+
+Atomic business logic decoupled from HTTP context. Database queries must be isolated inside Actions.
+
+```ts
+import { AppError } from "@/errors/app-error.ts";
+import { Logger } from "@/logger/logger.ts";
+import type { RegisterUserInput } from "@/schemas/auth/register-user.schema.ts";
+
+export interface DatabaseConnection {
+  findUserByEmail(email: string): Promise<{ id: string; email: string } | null>;
+  createUser(data: RegisterUserInput): Promise<{ id: string; email: string; fullName: string }>;
+}
+
+export async function registerUserAction(
+  db: DatabaseConnection,
+  input: RegisterUserInput
+): Promise<{ id: string; email: string; fullName: string }> {
+  const logger = new Logger("Auth:Action:RegisterUser");
+
+  try {
+    const existing = await db.findUserByEmail(input.email);
+
+    if (existing) {
+      throw new AppError({
+        message: "An account with this email address already exists. Please sign in or use another email.",
+        code: "USER_ALREADY_EXISTS",
+        statusCode: 409,
+        silent: true,
+      });
+    }
+
+    return await db.createUser(input);
+  } catch (error) {
+    if (error instanceof AppError) {
+      throw error;
+    }
+
+    logger.error("Database connection failure while registering user", { file: "register-user.action.ts" }, error);
+    throw new AppError({
+      message: "We encountered a temporary issue while creating your account. Please try again shortly.",
+      code: "DATABASE_ERROR",
+      statusCode: 500,
+    });
+  }
+}
+```

package/skills/hono/templates/app-error.template.md

@@ -0,0 +1,45 @@
+# AppError Template
+
+Use this template to create application errors with automatic logging.
+
+```ts
+import type { ContentfulStatusCode } from "hono/utils/http-status";
+import { Logger } from "@/logger/logger.ts";
+
+export interface AppErrorParams {
+  message: string;
+  statusCode?: ContentfulStatusCode;
+  code?: string;
+  details?: unknown;
+  silent?: boolean;
+}
+
+export class AppError extends Error {
+  public statusCode: ContentfulStatusCode;
+  public code: string;
+  public details?: unknown;
+
+  constructor({
+    message,
+    statusCode = 400,
+    code = "BAD_REQUEST",
+    details,
+    silent = false,
+  }: AppErrorParams) {
+    super(message);
+    this.name = "AppError";
+    this.statusCode = statusCode;
+    this.code = code;
+    this.details = details;
+
+    if (silent) {
+      return;
+    }
+
+    const logger = new Logger(`API:Error:${this.name}`);
+    logger.warn(`${code}: ${message}`, {
+      details: details as Record<string, unknown>,
+    });
+  }
+}
+```

package/skills/hono/templates/error-handler.template.md

@@ -0,0 +1,52 @@
+# Global Error Handler Template
+
+Centralized Hono error handler for AppError, Valibot validation issues, and unexpected crashes.
+
+```ts
+import type { ErrorHandler } from "hono";
+import { AppError } from "@/errors/app-error.ts";
+import { Logger } from "@/logger/logger.ts";
+
+export const globalErrorHandler: ErrorHandler = (error, ctx) => {
+  const logger = new Logger("API:GlobalErrorHandler");
+  const logContext = {
+    file: "error-handler.ts",
+    method: ctx.req.method,
+    url: ctx.req.url,
+  };
+
+  if (error instanceof AppError) {
+    return ctx.json(
+      {
+        success: false,
+        message: error.message,
+        error: error.code,
+      },
+      error.statusCode
+    );
+  }
+
+  if (error.name === "ValiError" || error.message.includes("validation")) {
+    logger.warn("Validation error encountered", logContext, error);
+    return ctx.json(
+      {
+        success: false,
+        message: "Some submitted fields are incomplete or invalid. Please check your data and try again.",
+        error: "VALIDATION_ERROR",
+      },
+      400
+    );
+  }
+
+  logger.error("Unhandled server exception caught in router", logContext, error);
+
+  return ctx.json(
+    {
+      success: false,
+      message: "We encountered an unexpected server issue. Our team is already looking into it. Please try again soon.",
+      error: "INTERNAL_SERVER_ERROR",
+    },
+    500
+  );
+};
+```

package/skills/hono/templates/logger.template.md

@@ -0,0 +1,94 @@
+# Logger Template
+
+Universal structured logger for development (ANSI colored) and Cloudflare Workers (structured JSON).
+
+```ts
+export type LogLevel = "debug" | "info" | "warn" | "error";
+
+export interface LogContext {
+  file?: string;
+  line?: number;
+  [key: string]: unknown;
+}
+
+export class Logger {
+  private serviceName: string;
+
+  constructor(serviceName: string) {
+    this.serviceName = serviceName;
+  }
+
+  private isDev(): boolean {
+    if (typeof process !== "undefined" && process.env) {
+      return (
+        process.env.NODE_ENV === "development" ||
+        process.env.NODE_ENV === "test"
+      );
+    }
+    return true;
+  }
+
+  private log(
+    level: LogLevel,
+    message: string,
+    context?: LogContext,
+    ...args: unknown[]
+  ): void {
+    const timestamp = new Date().toISOString();
+
+    if (this.isDev()) {
+      const colors: Record<LogLevel, string> = {
+        debug: "\x1b[36m",
+        info: "\x1b[32m",
+        warn: "\x1b[33m",
+        error: "\x1b[31m",
+      };
+      const reset = "\x1b[0m";
+      const color = colors[level] || reset;
+      const origin = context?.file ? ` [${context.file}${context.line ? `:${context.line}` : ""}]` : "";
+
+      console.log(
+        `${color}[${timestamp}] [${level.toUpperCase()}] [${this.serviceName}]${origin}:${reset} ${message}`,
+        context ?? "",
+        ...args,
+      );
+      return;
+    }
+
+    const payload = {
+      timestamp,
+      level,
+      serviceName: this.serviceName,
+      message,
+      context,
+      details: args.length > 0 ? args : undefined,
+    };
+
+    if (level === "error") {
+      console.error(JSON.stringify(payload));
+      return;
+    }
+    if (level === "warn") {
+      console.warn(JSON.stringify(payload));
+      return;
+    }
+    console.log(JSON.stringify(payload));
+  }
+
+  debug(message: string, context?: LogContext, ...args: unknown[]): void {
+    this.log("debug", message, context, ...args);
+  }
+
+  info(message: string, context?: LogContext, ...args: unknown[]): void {
+    this.log("info", message, context, ...args);
+  }
+
+  warn(message: string, context?: LogContext, ...args: unknown[]): void {
+    this.log("warn", message, context, ...args);
+  }
+
+  error(message: string, context?: LogContext, ...args: unknown[]): void {
+    this.log("error", message, context, ...args);
+  }
+}
+```

package/skills/hono/templates/router.template.md

@@ -0,0 +1,35 @@
+# Hono Route Template
+
+Slim HTTP controller that validates request body with Valibot and delegates directly to the Action.
+
+```ts
+import { Hono } from "hono";
+import { sValidator } from "@hono/standard-validator";
+import { registerUserSchema } from "@/schemas/auth/register-user.schema.ts";
+import { registerUserAction } from "@/actions/auth/register-user.action.ts";
+import type { DatabaseConnection } from "@/actions/auth/register-user.action.ts";
+
+export interface CustomVariables {
+  db: DatabaseConnection;
+}
+
+export const registerUserRoute = new Hono<{ Variables: CustomVariables }>().post(
+  "/",
+  sValidator("json", registerUserSchema),
+  async (ctx) => {
+    const input = ctx.req.valid("json");
+    const db = ctx.get("db");
+
+    const createdUser = await registerUserAction(db, input);
+
+    return ctx.json(
+      {
+        success: true,
+        message: "Welcome aboard! Your account has been created successfully.",
+        data: createdUser,
+      },
+      201
+    );
+  }
+);
+```

package/skills/hono/templates/schema.template.md

@@ -0,0 +1,24 @@
+# Valibot Schema Template
+
+Type-safe schema validation with courteous, persuasive, and professional error messages.
+
+```ts
+import * as v from "valibot";
+
+export const registerUserSchema = v.object({
+  email: v.pipe(
+    v.string("Please provide your email address."),
+    v.email("Please enter a valid email address to continue.")
+  ),
+  password: v.pipe(
+    v.string("A secure password is required."),
+    v.minLength(8, "For your account safety, your password must be at least 8 characters long.")
+  ),
+  fullName: v.pipe(
+    v.string("Please share your name with us."),
+    v.minLength(2, "Your name should be at least 2 characters long.")
+  ),
+});
+
+export type RegisterUserInput = v.InferOutput<typeof registerUserSchema>;
+```