Skip to main content
mgiovani

cc-arsenal

by mgiovaniv1.4.0

Complete toolkit: all commands (dev, docs, git, claude, jira) and skills (agent-browser, jira-cli, skill-creator, find-skills)

Installation guide →
4 skillsproductivityMIT GitHub

Commands

create-command

Create a new slash command following best practices and prompt engineering techniques

create-rule

Create a new memory rule following Claude Code best practices

fix-bug

Fix bugs using test-driven debugging and verification

implement-feature

Implement a feature using senior staff engineer best practices with parallel subagents

review-security

Security review for PRs, commits, or entire codebase

adr

Create numbered ADR documenting architectural decision

check

Validate documentation freshness, completeness, and quality

diagram

Generate Mermaid diagrams from codebase analysis

init

Initialize comprehensive documentation structure for project

rfc

Create numbered RFC for proposing and discussing changes

update

Update documentation by syncing with current codebase state

commit

Generate conventional commits following conventionalcommits.org specification

create-pr

Create a PR with conventional commit format and pre-filled template

daily

Smart standup report generator with activity analysis

todo

Smart daily work planner with intelligent prioritization

Documentation

# Claude Code Arsenal

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
[![Code style: ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

Tools to make Claude Code more useful: track your usage costs, schedule optimal coding windows, and automate common workflows.

## What's included

**Commands & Skills** - Workflow automation
- Git commands with conventional commits and PR creation
- Documentation commands (ADR, RFC, diagrams, and more)
- Jira CLI integration and skill creation guide
- Easy to customize or create your own

**Statusline** - Track your usage and costs in real-time (optional)
- Shows costs, context usage, and time until reset
- Git branch and worktree info
- Example: `🤖 Opus 4.5 │ 📁 cc-arsenal │ 🌿 main │ 📊 22% │ 💰 $0.043 │ 🔄 2h15m`

**Claude Hi Scheduler** - Maximize your 5-hour usage windows (optional)
- Auto-triggers fresh windows at optimal times
- Choose from preset schedules or customize your own
- Perfect for planning intensive coding sessions

## Installation

### Option 1: Claude Code Plugin (recommended)

Add the marketplace and select which plugins to install:
```bash
/plugin marketplace add mgiovani/cc-arsenal
```

This opens the plugin browser where you can select:

| Plugin | What's Included | Best For |
|--------|----------------|----------|
| **cc-arsenal** | All 13 commands + 4 skills + hooks | Complete workflow automation |
| **cc-arsenal-dev** | `/dev:implement-feature` | Feature implementation with parallel subagents |
| **cc-arsenal-docs** | 6 documentation commands | ADR, RFC, diagrams, init, check, update |
| **cc-arsenal-git** | 2 git workflow commands | Conventional commits, PR creation |
| **cc-arsenal-skills** | agent-browser + jira-cli + skill-creator + find-skills | Model-invoked capabilities only |

> **Plugin Variants Pattern:** All variants install from the same repository but load different subsets of components. Install the complete toolkit OR pick individual variants based on your needs. You can also install multiple variants together (e.g., git + docs).

**Quick install (complete toolkit):**
```bash
/plugin install cc-arsenal@cc-arsenal-marketplace
```

After installing, use commands like `/cc-arsenal:docs:adr`, `/cc-arsenal:git:commit`, etc. Skills and hooks activate automatically when relevant.

### Option 2: Agent Skills (`npx skills`)

Install skills using the open [Agent Skills](https://skills.sh) ecosystem. Works with Claude Code, Cursor, Codex, and 30+ other AI agents:

```bash
# Install all skills
npx skills add mgiovani/cc-arsenal

# List available skills first
npx skills add mgiovani/cc-arsenal --list

# Install a specific skill
npx skills add mgiovani/cc-arsenal --skill agent-browser

# Install globally (available across all projects)
npx skills add mgiovani/cc-arsenal -g
```

> **Note:** `npx skills` installs **skills only** (agent-browser, find-skills, jira-cli, skill-creator). For commands and hooks, use the Claude Code Plugin method above.

## Optional Features

After installation, add these features if you want them:

**Statusline** (track usage, cost, and other useful info):
```bash
make statusline-install
```

**Claude Hi Scheduler** (manage 5-hour windows):
```bash
make claude-hi-setup      # Interactive setup
make claude-hi-standard   # Quick 9am/2pm/7pm schedule
```

## Features

### 🛠️ Commands, Skills & Hooks

Workflow automation for your development workflow.

**Commands** - Workflow automation via slash commands:
- **Development**: `/dev:implement-feature` (feature implementation with subagents)
- **Git**: `/git:commit` (conventional commits), `/git:create-pr` (PR with templates)
- **Documentation**: `/docs:init`, `/docs:adr`, `/docs:rfc`, `/docs:diagram`, `/docs:check`, `/docs:update`
- **Claude**: `/claude:create-command`, `/claude:create-rule`
- **Jira**: `/jira:todo`, `/jira:daily`

**Skills** - Domain-specific tools Claude loads when needed:
- `agent-browser` - AI-optimized browser automation (93% less context than Playwright)
- `find-skills` - Discover and install third-party skills from [skills.sh](https://skills.sh)
- `jira-cli` - Manage Jira issues, sprints, and epics
- `skill-creator` - Guide for creating custom skills

See the `commands/` and `skills/` directories for details.

### 📊 Statusline (Optional)

Track costs and usage in your Claude Code prompt:
- Model name and version
- Current directory
- Git branch with uncommitted changes (●)
- Git worktree name (when in worktrees)
- Context window usage percentage
- Session costs
- Lines changed (+added/-removed)
- Session duration
- Time until 5-hour reset

**Example:**
```
🤖 Opus 4.5 │ 📁 ~/projects/cc-arsenal │ 🌿 main ● │ 📊 66% │ 💰 $3.169 │ 📝 +719/-545 │ ⏱️ 21m │ 🔄 4h 23m until reset at 13:00
```

**In a git worktree:**
```
🤖 Opus 4.5 │ 📁 ~/projects/feature │ 🌿 feat-branch ● │ 🌳 feature │ 📊 45% │ 💰 $1.234 │ 📝 +120/-80 │ ⏱️ 15m │ 🔄 2h 10m until reset at 14:00
```

👉 [Statusline documentation](scripts/claude/statusline/STATUSLINE.md)

### 🕐 Claude Hi Scheduler (Optional)

Automatically start fresh 5-hour windows before your peak coding times:

```bash
make claude-hi-setup      # Choose your schedule
make claude-hi-standard   # Quick 9am/2pm/7pm setup
```

👉 [Claude Hi documentation](scripts/claude-hi/README.md)

## Documentation

- [Getting Started](docs/getting-started.md) - Setup and configuration
- [Statusline Guide](scripts/claude/statusline/STATUSLINE.md) - Usage tracking and configuration
- [Claude Hi Guide](scripts/claude-hi/README.md) - Session scheduling
- [Troubleshooting](docs/troubleshooting.md) - Common issues
- [Security Policy](docs/SECURITY.md) - Vulnerability reporting
- [Changelog](docs/CHANGELOG.md) - Version history
- [Code of Conduct](docs/CODE_OF_CONDUCT.md) - Community guidelines

## Contributing

Contributions welcome! Fork the repo, make your changes, and submit a PR.

```bash
git clone https://github.com/mgiovani/cc-arsenal.git
cd cc-arsenal
make dev        # Set up development environment
make test       # Run tests
make check      # Run quality checks
```

See [CONTRIBUTING.md](CONTRIBUTING.md) for details. Please also review our [Code of Conduct](docs/CODE_OF_CONDUCT.md).

## Support

- 🐛 [Report bugs](https://github.com/mgiovani/cc-arsenal/issues)
- 🔒 [Report security vulnerabilities](docs/SECURITY.md)
- 💬 [Discussions](https://github.com/mgiovani/cc-arsenal/discussions)
- 📖 Check `docs/` for guides

## License

MIT License - see [LICENSE](LICENSE) for details.

---

*Built with Claude for Claude users*