@hd-agent-kit

AI agent configuration kit for Claude Code, Cursor, Windsurf, and OpenCode.

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

npx @hd-agent-kit/cli init

This will:

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

init

Copy agent files to your project and setup global gitignore.

npx @hd-agent-kit/cli init          # prompts before overwriting
npx @hd-agent-kit/cli init --force  # overwrites without asking

update

Update all agent files to the latest version (overwrites existing files).

npx @hd-agent-kit/cli update

gitignore

Only setup the global gitignore (without copying files).

npx @hd-agent-kit/cli gitignore

Options

npx @hd-agent-kit/cli --version   # show version number
npx @hd-agent-kit/cli --help      # show help

What Gets Installed

your-project/
├── AGENTS.md                                    ← Global AI rules (all tools read this)
├── .claude/skills/                              ← Claude Code skills
│   ├── analyze/SKILL.md
│   ├── api-design/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
    ├── api-design/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

The init and gitignore commands add these entries to your global gitignore:

AGENTS.md
.claude/
.opencode/
project-rules.md

This prevents agent config files from being committed to any project.

Available Slash Commands

| Command | Description | |---------|-------------| | /analyze | Analyze project and generate project-rules.md (also handles new project setup) | | /api-design [resource] | Design REST/GraphQL endpoints, Zod schemas, and OpenAPI docs | | /commit | Analyze changes and propose a commit message | | /refactor [file] | Create a step-by-step refactor plan | | /write-tests [file] | Generate test files (components, API endpoints, CLI tools) | | /document [file] | Generate JSDoc/TSDoc or README | | /performance-check | Bundle, render, backend, and Core Web Vitals analysis | | /security-scan | OWASP Top 10 risk analysis, dependency audit, env check |

License

MIT