@hd-agent-kit/cli 1.0.0 → 1.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 AI agent configuration kit for Claude Code, Cursor, Windsurf, and OpenCode.
 
-Sets up `AGENTS.md` and `.agents/skills/` in your project so AI assistants follow consistent rules and have access to slash commands like `/commit`, `/analyze`, `/refactor`, etc.
+Sets up `AGENTS.md` and skill files in your project so AI assistants follow consistent rules and have access to slash commands like `/commit`, `/analyze`, `/refactor`, etc.
 
 ## Installation
 
@@ -11,8 +11,9 @@ npx @hd-agent-kit/cli init
 ```
 
 This will:
-1. Copy `AGENTS.md` and `.agents/skills/` to your project root
-2. Configure global gitignore so these files don't get pushed to your repo
+1. Copy `AGENTS.md` to your project root
+2. Copy skill files to `.claude/skills/` (Claude Code) and `.opencode/skills/` (OpenCode)
+3. Configure global gitignore so these files don't get pushed to your repo
 
 ## Commands
 
@@ -42,16 +43,23 @@ npx @hd-agent-kit/cli gitignore
 
 ```
 your-project/
-├── AGENTS.md                              ← Global AI rules
-└── .agents/
-    └── skills/
-        ├── analyze/SKILL.md               ← /analyze — project analysis
-        ├── commit/SKILL.md                ← /commit — smart commits
-        ├── document/SKILL.md              ← /document — documentation
-        ├── performance-check/SKILL.md     ← /performance-check
-        ├── refactor/SKILL.md              ← /refactor — safe refactoring
-        ├── security-scan/SKILL.md         ← /security-scan
-        └── write-tests/SKILL.md           ← /write-tests — test generation
+├── AGENTS.md                                    ← Global AI rules (all tools read this)
+├── .claude/skills/                              ← Claude Code skills
+│   ├── analyze/SKILL.md
+│   ├── commit/SKILL.md
+│   ├── document/SKILL.md
+│   ├── performance-check/SKILL.md
+│   ├── refactor/SKILL.md
+│   ├── security-scan/SKILL.md
+│   └── write-tests/SKILL.md
+└── .opencode/skills/                            ← OpenCode skills
+    ├── analyze/SKILL.md
+    ├── commit/SKILL.md
+    ├── document/SKILL.md
+    ├── performance-check/SKILL.md
+    ├── refactor/SKILL.md
+    ├── security-scan/SKILL.md
+    └── write-tests/SKILL.md
 ```
 
 ## Global Gitignore
@@ -60,7 +68,8 @@ The `init` and `gitignore` commands add these entries to your global gitignore:
 
 ```
 AGENTS.md
-.agents/
+.claude/
+.opencode/
 project-rules.md
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hd-agent-kit/cli",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "AI agent configuration kit — sets up AGENTS.md and skill files for Claude Code, Cursor, Windsurf, and OpenCode",
   "bin": {
     "hd-agent-kit": "./bin/cli.js"

package/src/index.js

@@ -4,7 +4,11 @@ const { execSync } = require('child_process');
 const readline = require('readline');
 
 const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
-const GITIGNORE_ENTRIES = ['AGENTS.md', '.agents/', 'project-rules.md'];
+const SKILLS_DIR = path.join(TEMPLATES_DIR, 'skills');
+const GITIGNORE_ENTRIES = ['AGENTS.md', '.claude/', '.opencode/', 'project-rules.md'];
+
+// Skill directories for each supported tool
+const SKILL_TARGETS = ['.claude/skills', '.opencode/skills'];
 
 // ── Helpers ──────────────────────────────────────────────
 
@@ -32,6 +36,7 @@ function ask(question) {
 
 function getAllFiles(dir, base = dir) {
   const results = [];
+  if (!fs.existsSync(dir)) return results;
   for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
     const fullPath = path.join(dir, entry.name);
     if (entry.isDirectory()) {
@@ -53,11 +58,9 @@ async function setupGlobalGitignore() {
   try {
     gitignorePath = execSync('git config --global core.excludesFile', { encoding: 'utf-8' }).trim();
   } catch {
-    // No global gitignore configured yet
     gitignorePath = '';
   }
 
-  // Resolve ~ to home directory
   if (gitignorePath.startsWith('~')) {
     gitignorePath = path.join(process.env.HOME || process.env.USERPROFILE, gitignorePath.slice(1));
   }
@@ -70,7 +73,6 @@ async function setupGlobalGitignore() {
     log(`Global gitignore created: ${gitignorePath}`);
   }
 
-  // Read existing content or start fresh
   let content = '';
   if (fs.existsSync(gitignorePath)) {
     content = fs.readFileSync(gitignorePath, 'utf-8');
@@ -98,28 +100,52 @@ async function setupGlobalGitignore() {
 
 // ── Copy Files ───────────────────────────────────────────
 
-async function copyFiles(targetDir, { force = false } = {}) {
+function copyFile(src, dest, relLabel, force) {
+  const destDir = path.dirname(dest);
+  fs.mkdirSync(destDir, { recursive: true });
+  fs.copyFileSync(src, dest);
+  success(relLabel);
+}
+
+async function copyAllFiles(targetDir, { force = false } = {}) {
+  // 1) Copy AGENTS.md to project root
   console.log('\n  \uD83D\uDCC1 Copying agent files...\n');
 
-  const files = getAllFiles(TEMPLATES_DIR);
+  const agentsMdSrc = path.join(TEMPLATES_DIR, 'AGENTS.md');
+  const agentsMdDest = path.join(targetDir, 'AGENTS.md');
 
-  for (const relPath of files) {
-    const src = path.join(TEMPLATES_DIR, relPath);
-    const dest = path.join(targetDir, relPath);
-    const destDir = path.dirname(dest);
+  if (!force && fs.existsSync(agentsMdDest)) {
+    const overwrite = await ask('AGENTS.md already exists. Overwrite?');
+    if (!overwrite) {
+      warn('AGENTS.md skipped');
+    } else {
+      copyFile(agentsMdSrc, agentsMdDest, 'AGENTS.md', force);
+    }
+  } else {
+    copyFile(agentsMdSrc, agentsMdDest, 'AGENTS.md', force);
+  }
 
-    // Check if file exists
-    if (!force && fs.existsSync(dest)) {
-      const overwrite = await ask(`${relPath} already exists. Overwrite?`);
-      if (!overwrite) {
-        warn(`${relPath} skipped`);
-        continue;
+  // 2) Copy skills to each tool's directory
+  const skillFiles = getAllFiles(SKILLS_DIR);
+
+  for (const skillTarget of SKILL_TARGETS) {
+    console.log(`\n  \uD83D\uDCC2 ${skillTarget}/\n`);
+
+    for (const relPath of skillFiles) {
+      const src = path.join(SKILLS_DIR, relPath);
+      const dest = path.join(targetDir, skillTarget, relPath);
+      const label = path.join(skillTarget, relPath);
+
+      if (!force && fs.existsSync(dest)) {
+        const overwrite = await ask(`${label} already exists. Overwrite?`);
+        if (!overwrite) {
+          warn(`${label} skipped`);
+          continue;
+        }
       }
-    }
 
-    fs.mkdirSync(destDir, { recursive: true });
-    fs.copyFileSync(src, dest);
-    success(relPath);
+      copyFile(src, dest, label, force);
+    }
   }
 
   console.log('');
@@ -132,7 +158,7 @@ async function init({ force = false } = {}) {
 
   const targetDir = process.cwd();
 
-  await copyFiles(targetDir, { force });
+  await copyAllFiles(targetDir, { force });
   await setupGlobalGitignore();
 
   console.log('  \u2705 Setup complete!\n');
@@ -143,7 +169,7 @@ async function update() {
 
   const targetDir = process.cwd();
 
-  await copyFiles(targetDir, { force: true });
+  await copyAllFiles(targetDir, { force: true });
 
   console.log('  \u2705 Update complete!\n');
 }

package/templates/{.agents/skills → skills}/analyze/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: analyze
+description: Analyze the project structure, tech stack, and conventions to generate project-rules.md
+---
+
 # /analyze — Proje Analiz Skill'i
 
 > **Tetikleyici:** `/analyze`

package/templates/{.agents/skills → skills}/commit/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: commit
+description: Analyze git changes and propose a meaningful commit message following project conventions
+---
+
 # /commit — Akıllı Commit Skill'i
 
 > **Tetikleyici:** `/commit`

package/templates/{.agents/skills → skills}/document/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: document
+description: Generate JSDoc/TSDoc comments, README, or API documentation for files and modules
+---
+
 # /document — Dokümantasyon Skill'i
 
 > **Tetikleyici:** `/document [dosya/modül/proje]`

package/templates/{.agents/skills → skills}/performance-check/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: performance-check
+description: Analyze bundle size, render performance, and Core Web Vitals with scored report
+---
+
 # /performance-check — Performans Analiz Skill'i
 
 > **Tetikleyici:** `/performance-check [dosya/modül]`

package/templates/{.agents/skills → skills}/refactor/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: refactor
+description: Create a safe step-by-step refactoring plan with impact analysis and risk assessment
+---
+
 # /refactor — Refactoring Skill'i
 
 > **Tetikleyici:** `/refactor [dosya/modül]`

package/templates/{.agents/skills → skills}/security-scan/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: security-scan
+description: Run dependency audit, detect XSS/CSRF risks, check env variables, and report security issues
+---
+
 # /security-scan — Güvenlik Tarama Skill'i
 
 > **Tetikleyici:** `/security-scan`

package/templates/{.agents/skills → skills}/write-tests/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: write-tests
+description: Generate comprehensive test files for components, hooks, and utilities following project conventions
+---
+
 # /write-tests — Test Yazma Skill'i
 
 > **Tetikleyici:** `/write-tests [dosya/modül]`