kubecon

Claude Code Helper Commands

A collection of productivity-enhancing commands and agents for Claude Code that streamline the software development workflow from requirements to implementation.

Installation

Using Claude Code Plugin System (Recommended)

1. Add the marketplace:

   /plugin marketplace add niekcandaele/claude-helpers
   

2. Install the plugin:

   /plugin install cata-helpers
   

Commands will be available as /cata-helpers:command-name (e.g., /cata-helpers:commit-and-push).

Legacy Installation

If you're using an older version of Claude Code without plugin support:

curl -sSL https://raw.githubusercontent.com/niekcandaele/claude-helpers/main/install.sh | bash

Required Permissions

Some agents and commands require specific permissions. Add these to your .claude/settings.json or .claude/settings.local.json:

{
  "permissions": {
    "allow": [
      "Bash(git add:*)",
      "Bash(git commit:*)",
      "Bash(git push:*)",
      "Bash(git log:*)",
      "Bash(git rev-parse:*)",
      "Bash(git remote get-url:*)",
      "Bash(gh run list:*)",
      "Bash(gh api:*)",
      "Bash(find:*)",
      "Bash(ls:*)",
      "Bash(mkdir:*)",
      "Bash(codex:*)",
      "Bash(curl:*)",
      "WebSearch",
      "WebFetch(domain:github.com)",
      "WebFetch(domain:raw.githubusercontent.com)"
    ]
  }
}

Optional MCP Servers

Some agents benefit from MCP server integration:

• Playwright MCP - For cata-debugger, cata-tester, and cata-ux-reviewer browser automation
• PostgreSQL MCP - For cata-debugger and cata-researcher database inspection
• Redis MCP - For cata-debugger and cata-researcher cache inspection

Some integrations also require local tooling:

• Codex CLI - Required for cata-codex-reviewer; must be installed locally, authenticated, and allowed outbound network access

Overview

Agents

Specialized agents for specific review and analysis tasks (all follow "Report, Never Fix" philosophy):

Agent	Purpose
cata-reviewer	Strict code review, detects over-engineering and AI patterns
cata-codex-reviewer	Independent general review pass via local Codex CLI for second-model feedback
cata-debugger	Evidence-based troubleshooting with systematic investigation
cata-researcher	Critical research with multi-source verification
cata-tester	No-nonsense test execution (100% pass rate only)
cata-ux-reviewer	User experience evaluation across all interfaces
technical-writer	Documentation editing following Google/Grafana style

Commands

Command	Purpose
/setup-engineer	Create/update repository-specific engineer skill
/create-issue	Transform notes into GitHub issues
/commit-and-push	Quality checks, commit, and push
/create-pr	Create PR/MR with rich descriptions and inline review comments
/check-ci	Monitor CI/CD and fix failures
/catchup	Summarize branch changes
/handoff	Document progress for session continuity
/rebase	Rebase branch onto target with conflict guidance
/ralph-execute	Autonomous full-cycle: execute plan, verify, PR, CI

Commands

Setup Engineer (/setup-engineer)

Create or update a repository-specific engineer skill that captures knowledge about how to work with the codebase.

Usage:

/setup-engineer

What it does:

• First run: Explores the repository to discover tests, scripts, database setup, debugging approaches
• Subsequent runs: Extracts knowledge from the current session and adds it to the skill

Key feature - Session awareness: When you run this command after doing work (debugging, implementing features, etc.), Claude analyzes the conversation and captures useful knowledge:

• Commands that worked
• Debugging techniques
• Gotchas and solutions
• Environment setup requirements

Files created:

• .claude/commands/{repo-name}-engineer.md - The engineer skill (loaded automatically in future sessions)
• Updates CLAUDE.md with reference to the skill

Create Issue (/create-issue)

Transform notes, meeting minutes, or project documentation into well-structured GitHub issues.

Usage:

/create-issue [file path or text description]

What it does:

• Analyzes codebase to understand project context
• Extracts issue details from notes or text
• Generates clear, concise issue title
• Creates comprehensive issue body with markdown formatting
• Intelligently detects and applies relevant labels
• Always adds 'ai' label for transparency
• Creates issue via GitHub CLI (gh)

Example:

/create-issue meetings/sprint-planning.md
/create-issue "Users report login page is slow on mobile devices"

Commit and Push (/commit-and-push)

Automatically runs quality checks, creates a clean commit, and pushes to remote.

Usage:

/commit-and-push