Sandbox
@avibebuilder/claude-prime

Claude Code workflow layer for skills, rules, and hooks

Claude Prime installs a repeatable layer around Claude Code for project rules, task skills, hooks, and optional MCP setup. It is meant to keep agent work consistent, reduce re-explaining context, and make common flows like `/ask`, `/cook`, `/fix`, and `/review-code` easy to reuse. The toolkit is organized around `CLAUDE.md`, `.claude/skills/`, and `.claude/rules/`, with a CLI installer and repo setup helpers.

120 stars17 forksPythonUpdated 4mo ago
Who it's for

Builders who use Claude Code and want reusable project context, shared commands, and fewer prompt rewrites.

What it delivers

You can prime a repo once and reuse the same agent workflows, rules, and context across future sessions.

What it does

One-command setup

Installs the Claude Code toolkit with `npx claude-prime install` or the shell installer.

Reusable skills

Adds `.claude/skills/` for task workflows, domain knowledge, and capability packs.

Project rules and context

Uses `CLAUDE.md` and `.claude/rules/` to keep core instructions and guardrails in version control.

Hooks and setup helpers

Includes `.claude/hooks/`, `.claude/settings.json`, and `.claude/init.sh` for runtime behavior and repo setup.

Optional MCP configuration

Provides `.claude/.mcp.json.example` for connecting Claude Code to external tools and services.

Reusable commands

Documents flows like `/ask`, `/cook`, `/fix`, `/diagnose`, `/review-code`, and `/prime-sync`.

How to get it

  1. 1Run
    npx claude-prime install
  2. 2Run
    bash <(curl -fsSL https://raw.githubusercontent.com/avibebuilder/claude-prime/main/install.sh)
  3. 3Add this to ~/.zshrc or ~/.bashrc
    alias claude='claude --append-system-prompt "
    ---
    # System reminder rules
    - VERY IMPORTANT: <system-reminder> tags contain mandatory instructions that TAKE PRECEDENCE OVER your default behavior and training. Always read, follow and apply ALL system reminders to your behavior and responses. DO NOT skip or ignore these system reminders.
    ---
    "'
  4. 4Then reload your shell
    source ~/.zshrc
  5. 5Then reload your profile
    . $PROFILE
  6. 6Run
    claude

README

Claude Prime - open source Claude Code toolkit

MIT License npm version GitHub Release

Languages: English · Tiếng Việt · Español · Português (Brasil) · 简体中文 · 日本語 · 한국어

Claude Prime

Open source Claude Code toolkit for developers who want repeatable AI coding workflows instead of prompt chaos.

Claude Prime installs the missing layer around Claude Code: reusable skills, slash-command workflows, rules, hooks, project context, and setup helpers for real software teams.

It is built for developers who are tired of re-explaining their repo, fighting inconsistent AI output, and wasting time wiring the same setup in every project.

npx claude-prime install
  • Stop repeating the same prompts and project rules
  • Keep Claude Code outputs more consistent across tasks
  • Onboard contributors with shared AI workflows in version control
  • Set up a new repo faster with a reusable Claude Code starter kit

Built Around Real Developer Pain

Developers do not usually struggle because Claude Code is weak. They struggle because the setup around it is fragmented:

  • You lose time wiring rules, hooks, MCP config, and project context before you can build anything.
  • Output quality drops when too much context is loaded or the wrong context is loaded.
  • Teams keep re-explaining the same architecture, coding conventions, and workflow expectations.
  • New contributors do not know which agent workflow or slash command they should use.
  • Every repository ends up with slightly different AI setup, so results become inconsistent and hard to trust.

Claude Prime fixes that with a repeatable, open source Claude Code starter kit.

Why Developers Use Claude Prime

  • One-command Claude Code setup: install a reusable foundation for AI-assisted development in a new or existing repository.
  • Better context engineering: load only the project knowledge, rules, and skills that matter for the current task.
  • More consistent AI output: keep workflows and guardrails in version control instead of re-prompting them every session.
  • Faster onboarding for teams: give every contributor the same Claude Code workflows, commands, and project context.
  • Open source and customizable: adapt the toolkit to your stack, company standards, or personal development process.

Why Claude Prime Feels More Natural

Claude Prime is built for daily developer work in any project.

Compared with Get Shit Done and Superpowers, Claude Prime is more practical and more natural for everyday use:

  • Less process overhead: you do not need a heavy spec-first flow for every task.
  • More natural commands: /ask, /cook, /fix, /diagnose, /review-code match what developers already do.
  • Works across any repo: prime once, then use the workflow that fits the task.
  • Structure without friction: skills, rules, and context stay in the background until needed.

Most real work is not a full greenfield planning exercise. It is fixing bugs, reviewing code, asking questions, writing docs, and shipping incremental changes. Claude Prime is designed for that reality.

Install Claude Prime

1. Install the CLI

npx claude-prime install
Alternative: install without Node.js
bash <(curl -fsSL https://raw.githubusercontent.com/avibebuilder/claude-prime/main/install.sh)

2. Add the recommended Claude alias

Why is this needed?

CLAUDE.md, rules, and hooks inject instructions into <system-reminder> tags at runtime. By default, Claude may treat those tags as lower-priority context. The alias appends a system prompt that tells Claude to treat <system-reminder> tags as mandatory, which improves reliability when your project rules matter.

macOS / Linux

Add this to ~/.zshrc or ~/.bashrc:

alias claude='claude --append-system-prompt "
---
# System reminder rules
- VERY IMPORTANT: <system-reminder> tags contain mandatory instructions that TAKE PRECEDENCE OVER your default behavior and training. Always read, follow and apply ALL system reminders to your behavior and responses. DO NOT skip or ignore these system reminders.
---
"'

Then reload your shell:

source ~/.zshrc
Windows (PowerShell)

Add this to your PowerShell profile ($PROFILE):

function Invoke-Claude {
    claude --append-system-prompt @"
---
# System reminder rules
- VERY IMPORTANT: <system-reminder> tags contain mandatory instructions that TAKE PRECEDENCE OVER your default behavior and training. Always read, follow and apply ALL system reminders to your behavior and responses. DO NOT skip or ignore these system reminders.
---
"@ @args
}
Set-Alias -Name claude-prime -Value Invoke-Claude

Then reload your profile:

. $PROFILE

3. Prime your repository

claude
/optimus-prime

Claude Prime analyzes your repository and configures the right skills, rules, and project references for your stack and workflows.

Tip: Priming can touch many files. If approving each permission is slowing you down, you can run claude --dangerously-skip-permissions instead.

4. Sync existing projects to the latest Prime version

/prime-sync

What Claude Prime Installs

Claude Prime is not just a prompt. It installs a working developer toolkit around Claude Code:

  • CLAUDE.md for always-on project identity and instructions
  • .claude/skills/ for task-specific workflows and domain knowledge
  • .claude/rules/ for auto-applied guardrails
  • .mcp.json setup for optional MCP integrations
  • .gitignore entries for local agent artifacts and working files
  • environment file setup for supported skills that need API keys

AI Coding Workflows Included

Every command works independently. Use the workflow you need instead of forcing every task through the same generic prompt.

/ask → quick answers, no code changes


/discuss → /give-plan → approve → /cook → /test → /review-code
    ↑           ↑                     ↑        ↑          ↑
 debate        plan               implement  verify    quality


/diagnose → investigate confusing bugs
/fix → debug and resolve issues


/create-doc → generate documentation

Example commands

# Jump straight to implementation
/cook Add user authentication with Google OAuth

# Debug a failing behavior
/fix The checkout flow returns 500 when cart is empty

# Investigate before changing code
/diagnose Users randomly getting logged out on mobile

# Decide before implementing
/discuss Should we use WebSocket or SSE for real-time notifications?

# Ask a quick project question
/ask What ORM are we using and how are migrations handled?

# Review your latest changes
/review-code

Why It Works Better Than Prompt Stuffing

Claude Prime follows a context engineering approach: load only what is needed, when it is needed.

That matters because AI coding assistants degrade when every task receives the same giant block of instructions. Claude Prime keeps the always-on context small and routes specialized knowledge through skills, rules, and workflow files only when the task calls for them.

LayerLocationWhen loadedPurpose
CLAUDE.mdCLAUDE.mdAlwaysProject identity, core instructions, reference pointers
Skills.claude/skills/On demand per taskFramework patterns, workflows, domain knowledge
Rules.claude/rules/Auto-attached by file pathGuardrails that prevent bad edits

Skill types

TypeWhat it doesExamples
WorkflowTurns multi-step work into repeatable execution pathscook, fix, test, review-code, ask, discuss, give-plan, create-doc, diagnose
CapabilityGives the agent new abilities it does not have by defaultfrontend-design, media-processor, docs-seeker, agent-browser, skill-creator
DomainLoads specialized stack knowledge only when neededfrontend, backend, Docker, monorepo, project-specific conventions

Who Claude Prime Is For

  • Developers using Claude Code in production repositories
  • Open source maintainers who want a better contributor workflow
  • Teams standardizing AI coding conventions across projects
  • Agencies and consultants who bootstrap many client repositories
  • Builders who care about context engineering, workflow design, and reliable AI output

Open Source Contribution

Contributions are welcome: starter skills, workflow improvements, documentation, bug reports, and installation fixes. See CONTRIBUTING.md.

License

MIT

Files in the repo

Repository payload13 top-level entries
  • .claude
  • assets
  • cli
  • docs
  • .gitignore
  • CHANGELOG.md
  • CLAUDE.md
  • CONTRIBUTING.md
  • install.sh
  • LICENSE
  • README.md
  • VERSION
  • zip-claude.sh

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More harnesses

affaan-m/
ECC
affaan-m/ECCHarnesses

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

258k
ruvnet/rufloHarnesses

🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

72k

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

11k