Skip to content

rileyhilliard/claude-essentials

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

90 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Essentials

A unified development plugin for Claude Code with essential commands, skills, and specialized agents, all accessible under the ce namespace.

hackerman

What's Included

Commands

Quick workflows for everyday development tasks, accessed with /ce: prefix:

Command Description
/ce:test Run tests and analyze failures
/ce:explain Break down code or concepts
/ce:review Code review with tracked findings and fix workflow
/ce:commit Preflight checks, semantic commit, auto-fix on hook failure
/ce:deps Audit and upgrade dependencies
/ce:fix-issue Fix a GitHub issue by number
/ce:pr Create a pull request with auto-generated description
/ce:execute Execute an implementation plan from the plans folder
/ce:init Bootstrap repo with .claude/ config (rules, permissions, settings)

Skills

Reusable development patterns, accessed with ce: prefix:

Testing & Quality:

Skill Description
ce:writing-tests Testing Trophy methodology, behavior-focused tests
ce:verification-before-completion Verify before claiming success
ce:preflight-checks Auto-detect and run project linters/formatters/checkers

Debugging & Problem Solving:

Skill Description
ce:systematic-debugging Four-phase debugging framework
ce:fixing-flaky-tests Diagnose and fix tests that fail concurrently
ce:condition-based-waiting Replace race conditions with polling
ce:reading-logs Efficient log analysis using targeted search

Code Quality:

Skill Description
ce:refactoring-code Behavior-preserving code improvements
ce:optimizing-performance Measurement-driven optimization
ce:handling-errors Error handling best practices
ce:migrating-code Safe migration patterns for databases, APIs, and frameworks

Planning & Execution:

Skill Description
ce:planning-products Product feature definition from a PM perspective
ce:writing-plans Create implementation plans with devils-advocate review
ce:executing-plans Execute plans with mandatory code review
ce:architecting-systems Clean, scalable system architecture for the build phase
ce:design Frontend design skill

Documentation & Writing:

Skill Description
ce:writer Writing style guide with 7 personas (Architect, Engineer, PM, Marketer, Educator, Contributor, UX Writer)
ce:strategy-writer Executive-quality strategic documents in Economist/HBR style
ce:documentation Route to the right documentation approach (code comments, system docs, templates)

Data & Infrastructure:

Skill Description
ce:managing-databases PostgreSQL, DuckDB, Parquet, and PGVector architecture
ce:managing-pipelines GitHub Actions CI/CD security, performance, and deployment patterns

Meta Skills:

Skill Description
ce:visualizing-with-mermaid Create professional technical diagrams
ce:post-mortem Review sessions to extract actionable improvements
ce:configuring-claude Best practices for writing skills, rules, CLAUDE.md

Agents

Expert AI personas for complex work, accessed with @ce: prefix:

Agent Description
@ce:code-reviewer Comprehensive PR/MR reviews enforcing standards
@ce:haiku Lightweight Haiku agent for simple delegated tasks
@ce:log-reader Efficient log file analysis using targeted search
@ce:devils-advocate Rigorous critique to find flaws in plans and designs

Hooks

  • Session start - Auto-detects project tooling (linters, formatters, type checkers) and injects available skills
  • Notifications - Cross-platform alerts when Claude needs input, with git branch info (macOS + Linux)

Installation

Prerequisites

You need Claude Code installed. If you don't have it yet, head to claude.com/product/claude-code.

Setup

  1. Add this marketplace to Claude Code:
/plugin marketplace add https://github.com/rileyhilliard/claude-essentials
  1. Install the ce plugin:
/plugin install ce

That's it! You now have access to all commands, skills, and agents under the ce namespace.

Verify Installation

Start Claude Code and try these:

# Start Claude Code
claude

# Try a quick command
/ce:explain README.md

# Use a skill
ce:writing-tests

# Use a skill
ce:architecting-systems

Bootstrapping Your Repository

The /ce:init command sets up your repository with Claude Code configuration that follows best practices. This is the recommended first step when starting work on any project.

What It Does

Fresh repositories (no .claude/ directory):

  1. Detects your project stack (Python, TypeScript, Rust, Go, etc.)
  2. Generates a complete .claude/ configuration:
.claude/
├── CLAUDE.md           # Project overview, architecture, quick commands
├── settings.json       # Permissions tailored to your stack
└── rules/
    ├── testing.md          # References ce:writing-tests
    ├── error-handling.md   # References ce:handling-errors
    ├── debugging.md        # References ce:systematic-debugging
    ├── verification.md     # References ce:verification-before-completion
    └── {stack}/            # Stack-specific rules (python/, frontend/, etc.)

Existing configurations (.claude/ already exists):

  1. Audits your current setup against best practices
  2. Identifies missing skill references in rules
  3. Suggests permission and rule improvements
  4. Offers to apply fixes with your confirmation

Quick Start

# Initialize a new project
/ce:init

# Audit an existing configuration
/ce:init --audit

# Force regenerate (overwrites existing)
/ce:init --force

Why This Matters

The generated configuration:

  • Progressive disclosure - Rules stay concise (<100 lines), reference ce:* skills for depth, use references/ subdirectories for domain-specific details
  • Rules reference ce:* skills - Don't duplicate content, point to proven patterns
  • Permissions are stack-aware - Python projects get uv, pytest; Node gets npm, bun, etc.
  • Safety defaults included - Blocks rm -rf, force pushes, hard resets
  • Path-scoped rules - Activate only when working in relevant files

Progressive disclosure structure:

rules/
├── testing.md              # ~50 lines, points to ce:writing-tests
└── api/
    ├── conventions.md      # ~100 lines, overview
    └── references/         # Loaded on-demand
        ├── errors.md       # Detailed error patterns
        └── pagination.md   # Pagination strategies

This keeps context small while maintaining depth. Claude loads reference files only when needed.

Based on Claude platform best practices.


Usage Examples

Typical Workflows

Bootstrap a new project:

cd my-project
/ce:init
# Review the generated config, confirm, done

Fix failing tests:

/ce:test
# If complex, escalate:
ce:systematic-debugging

Review before merge:

/ce:review
# Review findings are tracked as a checklist, fix issues, then:
/ce:commit

Plan and build a feature:

# Define the product spec first:
ce:planning-products
# Then create a technical plan:
ce:writing-plans
# Then execute:
/ce:execute

Clean up legacy code:

/ce:explain src/legacy/payment-processor.js
ce:refactoring-code

Understanding the System

Commands vs Skills vs Agents:

  • Commands (/ce:test, /ce:review) are quick keyboard shortcuts for routine tasks
  • Skills (ce:writing-tests) are reusable workflows that guide specific development patterns
  • Agents (@ce:code-reviewer) are expert personas for complex, multi-step work

Use commands for quick actions, skills for following proven patterns, and agents when you need specialized expertise.

Customization

All components are just markdown files organized in directories. Want to customize? Edit them directly in ~/.claude/plugins/ce/.

Creating Your Own Command

Add a markdown file to ~/.claude/plugins/ce/commands/:

---
description: Your command description
argument-hint: "[optional-arg]"
allowed-tools: Bash, Read
---

Your command instructions here.

This will be accessible as /ce:your-command.

Creating Your Own Skill

Add a directory with SKILL.md to ~/.claude/plugins/ce/skills/:

---
name: my-skill
description: What this skill does and when to use it
---

# Skill Instructions

Your skill workflow here.

This will be accessible as ce:my-skill.

Creating Your Own Agent

Add a markdown file to ~/.claude/plugins/ce/agents/:

---
name: my-agent
description: Expert at specific domain
tools: Read, Grep, Glob, Bash
color: blue
---

Your agent personality and workflow here.

This will be accessible as @ce:my-agent.

Project Structure

~/.claude/
├── CLAUDE.md              # Communication guidelines (copy here manually)
└── plugins/
    └── ce/
        ├── .claude-plugin/
        │   └── plugin.json       # Plugin metadata
        ├── commands/             # 9 commands (/ce:test, /ce:review, /ce:commit, etc.)
        ├── skills/               # 24 skills (ce:writing-tests, ce:planning-products, etc.)
        ├── agents/               # 4 agents (@ce:code-reviewer, @ce:haiku, etc.)
        └── hooks/                # Session automation

Tips

Commands accept arguments: Most commands work with optional parameters.

/ce:test pytest tests/unit
/ce:explain AuthController

Skills are for learning: Invoke a skill to understand a pattern, then apply it.

ce:writing-tests
# Follow the guidance to write tests

Agents need context: Give agents rich context for better results.

# Vague
ce:architecting-systems help with authentication

# Better
ce:architecting-systems We need OAuth2 + JWT authentication for a React SPA with Node backend. 50k users.

Run tests first: Use /ce:test before committing to catch issues early.

Documentation

Contributing

Found a bug? Have an idea? Contributions welcome.

  1. Fork this repo
  2. Create a feature branch
  3. Test your changes locally
  4. Submit a PR with details

Ideas for contributions:

  • New commands for common workflows
  • Additional skills for specific patterns
  • Specialized agents for other domains
  • Documentation improvements

Resources

License

MIT - Use it, share it, make it better.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages