claudekit/README.md

Claude Kit

A comprehensive toolkit for Claude Code to accelerate development workflows for teams working with Python and JavaScript/TypeScript.

Features

• 20 Specialized Agents - From planning to deployment
• 20+ Slash Commands - Workflow automation
• 15+ Skills - Framework and language expertise
• CI/CD, Security, and API Extensions - Extended capabilities

Quick Start

1. Copy the .claude folder to your project root
2. Customize .claude/CLAUDE.md for your project
3. Start using commands like /feature, /review, /test

Directory Structure

.claude/
├── CLAUDE.md              # Project context (customize this!)
├── settings.json          # Hooks and permissions
├── agents/                # 20 specialized agents
├── commands/              # 20+ workflow commands
└── skills/                # Framework and language skills

Agents

Core Development

Agent	Description
planner	Task decomposition and planning
researcher	Technology research
debugger	Error analysis and fixing
tester	Test generation
code-reviewer	Code review with security focus
scout	Codebase exploration

Operations

Agent	Description
git-manager	Git operations and PRs
docs-manager	Documentation generation
project-manager	Progress tracking
database-admin	Schema and migrations
ui-ux-designer	UI component creation

Extended

Agent	Description
cicd-manager	CI/CD pipeline management
security-auditor	Security reviews
api-designer	API design and OpenAPI
vulnerability-scanner	Security scanning
pipeline-architect	Pipeline optimization

Commands

Development Workflow

/feature [description]   # Full feature development
/fix [error]            # Debug and fix bugs
/review [file]          # Code review
/test [scope]           # Generate tests
/tdd [feature]          # Test-driven development

Git & Deployment

/commit [message]       # Smart commit
/ship [message]         # Commit + PR
/pr [title]             # Create pull request
/deploy [env]           # Deploy to environment

Documentation & Planning

/plan [task]            # Create implementation plan
/doc [target]           # Generate documentation
/research [topic]       # Research technology

Security & Quality

/security-scan          # Scan for vulnerabilities
/api-gen [resource]     # Generate API code
/refactor [file]        # Improve code structure
/optimize [file]        # Performance optimization

Skills

Languages

• Python, TypeScript, JavaScript

Frameworks

• FastAPI, Django, Next.js, React

Databases

• PostgreSQL, MongoDB

DevOps

• Docker, GitHub Actions

Frontend

• Tailwind CSS, shadcn/ui

Security

• OWASP best practices

Testing

• pytest, vitest

Customization

CLAUDE.md

The .claude/CLAUDE.md file is your project context. Customize it with:

# Project: Your Project Name

## Tech Stack
- **Backend**: FastAPI
- **Frontend**: Next.js
- **Database**: PostgreSQL

## Conventions
- Use type hints
- 80% test coverage
- Conventional commits

## Agent Overrides
### Tester
- Framework: pytest
- Coverage: 90%

Adding Custom Commands

Create a new file in .claude/commands/:

# /my-command

## Purpose
Description of your command.

---

Your prompt content here.

Use $ARGUMENTS for command arguments.

Adding Custom Skills

Create a new skill in .claude/skills/category/skillname/SKILL.md:

# Skill Name

## Description
Brief description for matching.

---

## Patterns
Your patterns and examples here.

Workflow Chains

Feature Development

/feature → planner → implement → code-reviewer → tester → git-manager

Bug Fix

/fix → debugger → scout → implement → tester → code-reviewer

Ship Code

/ship → code-reviewer → tester → security-scan → git-manager

Requirements

• Claude Code 1.0+
• Git
• Node.js or Python (depending on your stack)

License

MIT

---

Built with duthaho