agentic-code 0.6.2 → 0.6.4

package/.agents/skills/ai-development-guide/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: ai-development-guide
-description: >
-  Detects code smells, anti-patterns, and debugging issues. Guides fail-fast design and implementation completeness.
-  Use when: fixing bugs, reviewing code quality, refactoring, or detecting code smells.
+description: "Detects code smells, anti-patterns, and debugging issues. Use when: fixing bugs, reviewing code quality, or refactoring."
 ---
 
 # AI Developer Guide

package/.agents/skills/coding-rules/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: coding-rules
-description: >
-  Applies coding standards for clean, maintainable code. Covers functions, error handling, and refactoring techniques.
-  Use when: writing functions, handling errors, refactoring, or reviewing code style.
+description: "Applies coding standards for clean, maintainable code. Use when: writing functions, handling errors, refactoring, or reviewing code style."
 ---
 
 # Development Rules

package/.agents/skills/documentation-criteria/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: documentation-criteria
-description: >
-  Guides PRD, ADR, Design Doc, and Work Plan creation with templates and decision matrix.
-  Use when: planning features, writing specs, creating technical documents, or deciding which docs are needed.
+description: "Guides PRD, ADR, Design Doc, and Work Plan creation. Use when: planning features, writing specs, or creating technical documents."
 ---
 
 # Documentation Creation Criteria

package/.agents/skills/implementation-approach/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: implementation-approach
-description: >
-  Selects implementation strategy (vertical slice, horizontal slice, or hybrid) with risk assessment.
-  Use when: planning how to build a feature, deciding development approach, or defining verification levels.
+description: "Selects implementation strategy (vertical/horizontal/hybrid) with risk assessment. Use when: planning features or deciding development approach."
 ---
 
 # Implementation Strategy Selection Framework (Meta-cognitive Approach)

package/.agents/skills/integration-e2e-testing/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: integration-e2e-testing
-description: >
-  Designs integration and E2E tests with mock boundaries and behavior verification rules.
-  Use when: writing E2E tests, integration tests, test skeletons, or reviewing test quality.
+description: "Designs integration and E2E tests with mock boundaries. Use when: writing E2E tests, integration tests, or reviewing test quality."
 ---
 
 # Integration Test & E2E Test Design/Implementation Rules

package/.agents/skills/metacognition/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: metacognition
-description: >
-  Validates approach and checks assumptions before and after tasks. Provides self-assessment protocol.
-  Use when: starting new work, encountering errors, completing tasks, or switching between phases.
+description: "Validates approach and checks assumptions before/after tasks. Use when: starting work, encountering errors, or switching phases."
 ---
 
 # Metacognition Protocol

package/.agents/skills/testing/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: testing
-description: >
-  Applies TDD process, test quality criteria, and mock usage guidelines. Covers unit, integration, and E2E tests.
-  Use when: writing unit tests, using mocks, reviewing test quality, or ensuring test coverage.
+description: "Applies TDD process, test quality criteria, and mock guidelines. Use when: writing unit tests, using mocks, or reviewing test quality."
 ---
 
 # Testing Rules

package/.agents/skills/testing-strategy/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: testing-strategy
-description: >
-  Prioritizes which tests to write based on ROI calculation and critical user journeys.
-  Use when: deciding test coverage, selecting test types, or budgeting test effort.
+description: "Prioritizes tests based on ROI and critical user journeys. Use when: deciding test coverage, selecting test types, or budgeting effort."
 ---
 
 # Test Strategy: ROI-Based Selection

package/README.md

@@ -4,7 +4,7 @@ Your AI (LLM), guided by built-in workflows. Describe what you want, and it foll
 
 [![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![AGENTS.md](https://img.shields.io/badge/AGENTS.md-compliant-blue.svg)](https://agents.md)
-[![Version](https://img.shields.io/badge/version-0.6.2-blue.svg)](package.json)
+[![Version](https://img.shields.io/badge/version-0.6.4-blue.svg)](package.json)
 
 ![Demo: Building a Slack bot with Agentic Code](.github/assets/demo.gif)
 
@@ -114,15 +114,15 @@ cp -r path/to/agentic-code/.agents .
 
 ```bash
 # User scope (all projects)
-npx agentic-code-install-skills --codex
+npx agentic-code skills --codex
 # Installs to ~/.codex/skills/agentic-code/
 
 # Project scope (current project only)
-npx agentic-code-install-skills --codex --project
+npx agentic-code skills --codex --project
 # Installs to ./.codex/skills/agentic-code/
 
 # Custom path
-npx agentic-code-install-skills --path ./custom/skills
+npx agentic-code skills --path ./custom/skills
 # Installs to ./custom/skills/agentic-code/
 ```
 

package/bin/cli.js

@@ -6,6 +6,15 @@ const { execSync } = require('child_process');
 
 // Parse command line arguments
 const args = process.argv.slice(2);
+
+// Subcommand routing
+if (args[0] === 'skills') {
+  // Delegate to install-codex-skills
+  const installSkills = require('./install-codex-skills');
+  installSkills.run(args.slice(1));
+  process.exit(0);
+}
+
 const projectName = args[0];
 
 // Show help if no project name provided
@@ -14,12 +23,15 @@ if (!projectName) {
 🤖 Agentic Code - Task-oriented context engineering framework
 
 Usage:
-  npx github:shinpr/agentic-code <project-name>
+  npx agentic-code <project-name>       Create a new project
+  npx agentic-code skills [options]     Install skills to Codex CLI
 
 Examples:
-  npx github:shinpr/agentic-code my-project
+  npx agentic-code my-project
+  npx agentic-code skills --codex
+  npx agentic-code skills --codex --project
 
-Skills include language-specific references (e.g., .agents/skills/coding-rules/references/typescript.md)
+For skills options, run: npx agentic-code skills --help
 `);
   process.exit(1);
 }

package/bin/install-codex-skills.js

@@ -4,28 +4,12 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-// Parse command line arguments
-const args = process.argv.slice(2);
-
 // Scope types
 const SCOPES = {
   user: 'user',
   project: 'project'
 };
 
-// Get target directory based on target and scope
-function getTargetDir(targetKey, scope) {
-  if (targetKey === 'codex') {
-    if (scope === SCOPES.project) {
-      return path.join(process.cwd(), '.codex', 'skills');
-    }
-    // User scope: respect CODEX_HOME environment variable
-    const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
-    return path.join(codexHome, 'skills');
-  }
-  return null;
-}
-
 // Target configurations
 const TARGETS = {
   codex: {
@@ -36,76 +20,17 @@ const TARGETS = {
   // Future targets can be added here
 };
 
-// Show help
-if (args.includes('--help') || args.includes('-h')) {
-  console.log(`
-Usage: agentic-code-install-skills [options]
-
-Options:
-  --codex         Install skills to Codex CLI (default)
-  --project       Install to project scope instead of user scope
-  --path <path>   Install to custom path
-  --help          Show this help message
-
-Scopes:
-  user (default)  Install to user directory (~/.codex/skills/ or $CODEX_HOME/skills/)
-  project         Install to current project (./.codex/skills/)
-
-Examples:
-  agentic-code-install-skills                    # Install to ~/.codex/skills/ (user scope)
-  agentic-code-install-skills --codex            # Same as above (explicit)
-  agentic-code-install-skills --codex --project  # Install to ./.codex/skills/ (project scope)
-  agentic-code-install-skills --path ./my-skills # Install to ./my-skills/agentic-code
-`);
-  process.exit(0);
-}
-
-// Parse --path option
-function getCustomPath() {
-  const pathIndex = args.indexOf('--path');
-  if (pathIndex === -1) return null;
-
-  const customPath = args[pathIndex + 1];
-  if (!customPath || customPath.startsWith('-')) {
-    console.error('Error: --path requires a path argument');
-    process.exit(1);
-  }
-  return path.resolve(customPath);
-}
-
-const customPath = getCustomPath();
-
-// Determine target (default: codex)
-let targetKey = customPath ? 'custom' : 'codex';
-if (args.includes('--codex')) {
-  targetKey = customPath ? 'custom' : 'codex';
-}
-
-// Determine scope (default: user)
-const scope = args.includes('--project') ? SCOPES.project : SCOPES.user;
-
-// Get skills directory
-let skillsDir;
-let target;
-
-if (customPath) {
-  skillsDir = customPath;
-  target = {
-    name: 'agentic-code',
-    description: 'custom path',
-    postInstall: null
-  };
-} else {
-  target = TARGETS[targetKey];
-  if (!target) {
-    console.error(`Error: Unknown target '${targetKey}'`);
-    process.exit(1);
-  }
-  skillsDir = getTargetDir(targetKey, scope);
-  if (!skillsDir) {
-    console.error(`Error: Cannot determine target directory for '${targetKey}'`);
-    process.exit(1);
+// Get target directory based on target and scope
+function getTargetDir(targetKey, scope) {
+  if (targetKey === 'codex') {
+    if (scope === SCOPES.project) {
+      return path.join(process.cwd(), '.codex', 'skills');
+    }
+    // User scope: respect CODEX_HOME environment variable
+    const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
+    return path.join(codexHome, 'skills');
   }
+  return null;
 }
 
 // Get source directory (from installed package or local)
@@ -142,8 +67,82 @@ function copyDirectory(src, dest) {
   }
 }
 
-// Main
-function main() {
+// Parse --path option
+function getCustomPath(args) {
+  const pathIndex = args.indexOf('--path');
+  if (pathIndex === -1) return null;
+
+  const customPath = args[pathIndex + 1];
+  if (!customPath || customPath.startsWith('-')) {
+    console.error('Error: --path requires a path argument');
+    process.exit(1);
+  }
+  return path.resolve(customPath);
+}
+
+// Main run function
+function run(cliArgs) {
+  const args = cliArgs || process.argv.slice(2);
+
+  // Show help
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log(`
+Usage: npx agentic-code skills [options]
+
+Options:
+  --codex         Install skills to Codex CLI (default)
+  --project       Install to project scope instead of user scope
+  --path <path>   Install to custom path
+  --help          Show this help message
+
+Scopes:
+  user (default)  Install to user directory (~/.codex/skills/ or $CODEX_HOME/skills/)
+  project         Install to current project (./.codex/skills/)
+
+Examples:
+  npx agentic-code skills                    # Install to ~/.codex/skills/ (user scope)
+  npx agentic-code skills --codex            # Same as above (explicit)
+  npx agentic-code skills --codex --project  # Install to ./.codex/skills/ (project scope)
+  npx agentic-code skills --path ./my-skills # Install to ./my-skills/agentic-code
+`);
+    process.exit(0);
+  }
+
+  const customPath = getCustomPath(args);
+
+  // Determine target (default: codex)
+  let targetKey = customPath ? 'custom' : 'codex';
+  if (args.includes('--codex')) {
+    targetKey = customPath ? 'custom' : 'codex';
+  }
+
+  // Determine scope (default: user)
+  const scope = args.includes('--project') ? SCOPES.project : SCOPES.user;
+
+  // Get skills directory
+  let skillsDir;
+  let target;
+
+  if (customPath) {
+    skillsDir = customPath;
+    target = {
+      name: 'agentic-code',
+      description: 'custom path',
+      postInstall: null
+    };
+  } else {
+    target = TARGETS[targetKey];
+    if (!target) {
+      console.error(`Error: Unknown target '${targetKey}'`);
+      process.exit(1);
+    }
+    skillsDir = getTargetDir(targetKey, scope);
+    if (!skillsDir) {
+      console.error(`Error: Cannot determine target directory for '${targetKey}'`);
+      process.exit(1);
+    }
+  }
+
   const sourceDir = getSourceSkillsDir();
 
   if (!sourceDir) {
@@ -187,4 +186,10 @@ function main() {
   }
 }
 
-main();
+// Export for module usage
+module.exports = { run };
+
+// Run if called directly
+if (require.main === module) {
+  run();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-code",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "Task-oriented context engineering framework for LLM coding agents - AGENTS.md standard compliant",
   "files": [
     "bin/",
@@ -8,8 +8,7 @@
     "AGENTS.md"
   ],
   "bin": {
-    "agentic-code": "./bin/cli.js",
-    "agentic-code-install-skills": "./bin/install-codex-skills.js"
+    "agentic-code": "./bin/cli.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"