@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 |

OpenCode Team Agents

This package includes a ready-made senior-level multi-agent team for OpenCode (.opencode/agents/). The team covers the full development lifecycle:

| Agent | Role | Model | |-------|------|-------| | team-lead | Orchestrates the team, makes architectural decisions | claude-opus-4-6 | | planner | Translates requirements into sprint plans, API contracts, ADRs | claude-sonnet-4-6 | | web-developer | Full-stack web (Next.js, Vite/React, Remix, Astro, Vue/Nuxt) | codex-5.3 | | mobile-developer | Android (Kotlin/Compose) + iOS (Swift/SwiftUI) | codex-5.3 | | backend-developer | APIs, database schemas, auth, service layer | codex-5.3 | | code-reviewer | Security (OWASP), performance, a11y, type safety, observability | claude-sonnet-4-6 | | qa-engineer | Unit, integration, and E2E test suites | codex-5.3 | | devops-engineer | CI/CD pipelines, Docker, cloud deployments | codex-5.3 | | ui-designer | Component specs, design tokens, accessibility | claude-sonnet-4-6 | | documentation-writer | README, API docs, changelogs, ADRs | claude-sonnet-4-6 | | bug-triager | Root cause analysis, prioritization, reproduction steps | claude-sonnet-4-6 |

Every agent automatically reads AGENTS.md and project-rules.md before starting any task, respecting the project's specific conventions. Run /analyze once to generate project-rules.md for your project.

How Agents Use Your Project Rules

project-rules.md (generated by /analyze)
       ↓ project-specific stack, naming conventions, file map
AGENTS.md (installed by hd-agent-kit)
       ↓ global standards, TypeScript rules, component architecture
Agent behavior

Priority: project-rules.md > AGENTS.md > general best practices

License

MIT