Contributing

Thanks for wanting to contribute! ECC is a community resource for Claude Code users.

What We’re Looking For

Agents

New agents that handle specific tasks:

Language-specific reviewers (Python, Go, Rust, etc.)
Framework experts (Django, Rails, Laravel, Spring)
DevOps specialists (Kubernetes, Terraform, CI/CD)
Domain experts (ML pipelines, data engineering, mobile)

Skills

Workflow definitions and domain knowledge:

Language best practices
Framework patterns
Testing strategies
Architecture guides

Hooks

Useful automations:

Linting/formatting hooks
Security checks
Validation hooks

Commands

Slash commands that invoke useful workflows.

Quick Start

# 1. Fork the repo
# 2. Create a branch
git checkout -b feat/my-contribution

# 3. Add your contribution (see templates below)

# 4. Test locally
node tests/run-all.js

# 5. Submit PR

Agent Template

Create agents/your-agent.md:

---
name: your-agent
description: What this agent does. Use PROACTIVELY when [trigger conditions].
tools: ["Read", "Grep", "Glob", "Bash", "Edit", "Write"]
model: sonnet
---

You are a specialist in [domain].

## Your Role
- [Responsibility 1]
- [Responsibility 2]

## Process
1. [Step 1]
2. [Step 2]

Skill Template

Create skills/your-skill/SKILL.md:

---
name: your-skill
description: One-line description shown in skill list.
origin: Community
---

# Skill Title

## When to Activate
- [Trigger condition 1]
- [Trigger condition 2]

## Core Principles
### 1. [Principle]
[Explanation with code examples]

Command Template

Create commands/your-command.md:

---
description: Brief description for /help listing.
---

# Your Command

## Goal
[What this command accomplishes]

## Steps
1. [Step 1]
2. [Step 2]

Pull Request Process

Keep PRs focused on a single contribution type
Include tests if adding scripts
Follow file naming: lowercase with hyphens (e.g., python-reviewer.md)
PRs are typically reviewed within 48 hours