Agent skill

Optimus Prime

by avibebuilder in avibebuilder/claude-prime

Generates a Claude Code configuration tailored to a specific project.

MITAuto-check passedAgent Workflows

Install Optimus Prime

skills CLI
$ npx skills add avibebuilder/claude-prime --skill optimus-prime -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install avibebuilder/claude-prime optimus-prime --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/avibebuilder/claude-prime.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/optimus-prime .claude/skills/optimus-prime && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
optimus-prime
GitHub stars
120
Token cost
~1.5k tokens
SKILL.md length
662 words
Files
3 (incl. references)
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Generates a Claude Code configuration tailored to a specific project.

  • Works in 9 steps: Analyze the repo deeply — stack,… → Propose findings using the Output Format… → Create skills via /skill-creator — every… → …
  • The user wants to prime a project
  • SKILL.md covers Mission, Modes, Flow and Placement Decision Matrix, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Optimus Prime is an agent skill from avibebuilder/claude-prime. Generates a Claude Code configuration tailored to a specific project. Use whenever the user wants to prime a project, set up claude for a repo, bootstrap claude config, or re-prime/refresh an already-primed project (for example after /prime-sync pulled new starter content). Triggers on 'prime', 'prime this project', 'optimus-prime', 're-prime', 'refresh claude config', 'regenerate CLAUDE.md', 'set up claude for this repo'. Deeply analyzes the real codebase and builds project-specific skills, rules, and CLAUDE.md…

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/analysis-checklist.md` and `references/setup-project.md`).

It sits in Agent Workflows, covering Agent instruction files and Project scaffolding. The repository describes itself as: You've heard Claude Code can do amazing things. Skills, hooks, agents, memory systems — but who has time to figure all that out? Claude Prime sets it up for you in one command. The licence is MIT.

When your agent uses it

  • The user wants to prime a project
  • Set up claude for a repo
  • Bootstrap claude config
  • Re-prime/refresh an already-primed project (for example after /prime-sync pulled new starter content)

Example prompts

  • “prime this project”
  • “optimus-prime”
  • “re-prime”
  • “/optimus-prime”

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Analyze the repo deeply — stack, conventions, boundaries, docs, existing config. See analysis-checklist.md.
  2. Propose findings using the Output Format below. Do not touch meaningful files before approval.
  3. Create skills via /skill-creator — every skill must go through skill-creator to ensure quality and project fit. Starters in…
  4. Generate or refine CLAUDE.md — lean, high-signal, always-on context only. Point to docs/READMEs for detail.
  5. Rules only if needed — apply the rule test. Zero rules is valid.
  6. Offer CLAUDE.local.md — personal preferences (role, sandbox URLs, preferred test data, workflow quirks), gitignored.
  7. Clean up — delete .claude/starter-skills/ after processing. Keep protected skills. Confirm all deletions.
  8. Verify — references resolve, stack claims match evidence, config is project-specific not generic.
  9. Offer skill optimization — after everything is set up, offer optimization paths sized to how many new skills were created. ≤3 skills…

What it can do on your machine

Read from SKILL.md and the folder at commit 80bcfa4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Optimus Prime loads about 1.5k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 160 tokens; SKILL.md has 662 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~160
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from avibebuilder/claude-prime at commit 80bcfa4, republished under its MIT licence (© avibebuilder). 662 words, ~1,482 tokens.

Download SKILL.mdSave it as .claude/skills/optimus-prime/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
optimus-prime
description
Generates a Claude Code configuration tailored to a specific project. Use whenever the user wants to prime a project, set up claude for a repo, bootstrap claude config, or re-prime/refresh an already-primed project (for example after `/prime-sync` pulled new starter content). Triggers on 'prime', 'prime this project', 'optimus-prime', 're-prime', 'refresh claude config', 'regenerate CLAUDE.md', 'set up claude for this repo'. Deeply analyzes the real codebase and builds project-specific skills, rules, and CLAUDE.md — not generic boilerplate. For ongoing config health checks and proposal review, use `self-evolve` instead.
argument-hint
additional-context
disable-model-invocation
true

Ultrathink.

Mission

Generate a Claude configuration that fits the specific project. Every skill, rule, and CLAUDE.md entry must exist because this project needs it — not because a template included it. Analyze the real codebase deeply, understand its conventions and patterns, and build a config that makes Claude work well here.

Modes

  • Fresh prime — no claude config yet. Build from scratch.
  • Re-prime — claude config already exists. Preserve intentional project work, refresh what is stale or generic, fill gaps.

Default to re-prime whenever meaningful existing config is found. Never overwrite it wholesale without user approval.

Flow

  1. Analyze the repo deeply — stack, conventions, boundaries, docs, existing config. See analysis-checklist.md.
  2. Propose findings using the Output Format below. Do not touch meaningful files before approval.
  3. Create skills via /skill-creator — every skill must go through skill-creator to ensure quality and project fit. Starters in .claude/starter-skills/ are reference input to accelerate creation, not templates to copy.
  4. Generate or refine CLAUDE.md — lean, high-signal, always-on context only. Point to docs/READMEs for detail.
  5. Rules only if needed — apply the rule test. Zero rules is valid.
  6. Offer CLAUDE.local.md — personal preferences (role, sandbox URLs, preferred test data, workflow quirks), gitignored.
  7. Clean up — delete .claude/starter-skills/ after processing. Keep protected skills. Confirm all deletions.
  8. Verify — references resolve, stack claims match evidence, config is project-specific not generic.
  9. Offer skill optimization — after everything is set up, offer optimization paths sized to how many new skills were created. ≤3 skills: recommend full optimization for all. >3 skills: recommend full optimization for user-designated core skills only + description optimization for the rest (avoids long execution time and token burn). Always emphasize that full optimization takes meaningful time and tokens. Run sequentially — never in parallel; concurrent runs overload the user's machine.

Follow full step-by-step in setup-project.md.

Placement Decision Matrix

Every piece of knowledge must earn its place. Use this to decide where it belongs:

Detected needWhere it belongsTest
General framework/library knowledgeSkill (via /skill-creator)Would a reusable skill teach this across projects?
Project-specific constraint that still produces wrong code with the right skill loaded.claude/rules/<name>.md with paths:With the relevant skill activated, will code still be wrong without this?
Identity, commands, stack, key architecture, reference pointersCLAUDE.mdShould this be always-on for most tasks in this repo?
Detailed architecture or domain explanationsExisting docs/, READMEs — referenced from CLAUDE.mdValuable but too detailed for always-on?
Dense agent-oriented reference material - referenced from CLAUDE.md.claude/project/ (optional)Do agents need a tighter reference than the human docs provide?
Show full SKILL.md (247 more words)Show less

Principles

  • Domain-scoped, project-fitted. Skills target a capability, not the project itself — with this project's patterns baked in. Generic templates and project-named catch-alls both degrade context quality.
  • Repo evidence is the source of truth. Verify conventions from actual source files, configs, and docs. Do not assert what you haven't confirmed.
  • Lean context, high signal. Follow the context engineering philosophy — load only what's needed, when it's needed. CLAUDE.md carries always-on essentials. Skills load on demand. Rules auto-attach by path.
  • Rules are optional and path-scoped. Only create a rule when the rule test passes. Do not modify _apply-all.md — it is a universal boilerplate rule from prime, not project config.
  • Reuse over duplication. If the project has strong docs, point to them. Do not re-author parallel agent docs unless existing material is too noisy or incomplete.

Output Format

Before making non-trivial changes, report findings in this shape:

Current State

What Claude config already exists; what the repo evidence says about stack, tooling, and conventions.

Proposed Changes

What to create, update, keep, or remove — including which skills to build and what each should cover.

Files to Touch

Concrete file list with short purpose notes.

Include these only when non-empty:

  • Decisions Needing User Input — overwrites, deletions, or major structural changes
  • Risks / Assumptions — inferred facts that still need verification

After approval, implement and finish with a short summary of what changed and any follow-ups.

References

ReferenceContent
analysis-checklist.mdWhat to inspect during repo + existing-config review
setup-project.mdFresh-prime / re-prime step-by-step workflow

Additional Context (Optional)

<user-context>$ARGUMENTS</user-context>

© avibebuilder, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .claude/skills/optimus-prime of avibebuilder/claude-prime.

  • SKILL.md
  • references/analysis-checklist.md
  • references/setup-project.md

Open the folder on GitHubat commit 80bcfa4

Compare with similar skills

Optimus Prime next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Optimus Prime compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Optimus Prime this skillavibebuilder/claude-prime120—~1.5kAutomated safety check: PassMIT
Intent Layercrafter-station/skills1121 repos~633Automated safety check: PassMIT
AI Bomcdxgen/cdxgen1.1k—~2.5kAutomated safety check: PassApache-2.0
AI Context Workspace Initkvker/ai-context-workspace101—~948Automated safety check: PassMIT
Add Remote Endpointnextcloud/android-library106—~1.1kAutomated safety check: PassCustom licence
Project Healthjezweb/claude-skills1.1k1 repos~3kAutomated safety check: PassMIT

Similar skills

  • Intent Layer

    crafter-station/skills

    Set up hierarchical Intent Layer (AGENTS.md files) for codebases.

    112 GitHub starsUsed in 1 repo~633 tokens
    Agent WorkflowsAuto-check passed
  • AI Bom

    cdxgen/cdxgen

    Generates AI-BOM, MCP inventory, AI skill inventory, and AI authorship provenance documents with cdxgen, cataloging models, inference services, Hugging Face purls, MCP servers and their…

    1.1k GitHub stars~2.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • AI Context Workspace Init

    kvker/ai-context-workspace

    Turns existing work units or an empty directory into an AI Context Workspace by scanning materials, generating background and conventions, and installing runtime skills.

    101 GitHub stars~948 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Add Remote Endpoint

    nextcloud/android-library

    A skill your agent uses when adding a new remote/network endpoint (a RemoteOperation / OCSRemoteOperation) to this Nextcloud Android library, or when the user says "add an endpoint", "new remote…

    106 GitHub stars~1.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Project Health

    jezweb/claude-skills

    All-in-one project configuration and health management. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3k tokens
    Agent WorkflowsAuto-check passed
  • AGENTS.md Scaffold

    majiayu000/spellbook

    Scans a repository for real evidence and proposes, or on request writes, a small stack of root and scoped AGENTS.md files with validation commands and generated-file boundaries.

    286 GitHub stars~1.5k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from avibebuilder/claude-prime

All 19 skills in this repo
  • Diagnose

    avibebuilder/claude-prime

    Investigate unexpected behavior and mysterious bugs. An agent skill from avibebuilder/claude-prime.

    120 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Frontend Design

    avibebuilder/claude-prime

    Builds distinctive, production-grade UIs that avoid generic AI aesthetics.

    120 GitHub stars~2.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Media Processor

    avibebuilder/claude-prime

    Specialized visual and multimedia processing tools. An agent skill from avibebuilder/claude-prime.

    120 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check: notes
  • Skill Creator

    avibebuilder/claude-prime

    A skill your agent uses when the user wants to work on a Claude Code skill file (SKILL.md): writing one from scratch, testing whether an existing one works well, running evals or benchmarks…

    120 GitHub stars~8.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Self Evolve

    avibebuilder/claude-prime

    The single config quality skill. An agent skill from avibebuilder/claude-prime.

    120 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Cook

    avibebuilder/claude-prime

    Implement, build, create, or add any feature, endpoint, page, component, or functionality.

    120 GitHub stars~970 tokensUpdated 4 mo ago
    Auto-check passed

Categories

Questions about Optimus Prime

What does Optimus Prime do?

Generates a Claude Code configuration tailored to a specific project. Optimus Prime is an agent skill from avibebuilder/claude-prime. Generates a Claude Code configuration tailored to a specific project.

When should I use Optimus Prime?

Optimus Prime fits situations like: the user wants to prime a project; set up claude for a repo; bootstrap claude config; re-prime/refresh an already-primed project (for example after /prime-sync pulled new starter content).

How do I install Optimus Prime in Claude Code?

Run `npx skills add avibebuilder/claude-prime --skill optimus-prime -a claude-code`. Or copy the skill folder (.claude/skills/optimus-prime in avibebuilder/claude-prime) into .claude/skills/optimus-prime in your project. Claude Code loads it when a task matches its description.

How do I install Optimus Prime in Codex?

Run `npx skills add avibebuilder/claude-prime --skill optimus-prime -a codex`. Or copy the skill folder (.claude/skills/optimus-prime in avibebuilder/claude-prime) into .agents/skills/optimus-prime in your project. Codex loads it when a task matches its description.

Can I use Optimus Prime in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add avibebuilder/claude-prime --skill optimus-prime -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/optimus-prime, .gemini/skills/optimus-prime, .github/skills/optimus-prime and .opencode/skills/optimus-prime in your project.

What does Optimus Prime need to run?

SKILL.md names no scripts, command-line tools or credentials: Optimus Prime is instructions for the agent only.

Does Optimus Prime access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Optimus Prime safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Optimus Prime use?

Optimus Prime is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Optimus Prime use?

About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to Optimus Prime?

Skills that share tags, products or a category with Optimus Prime: Intent Layer (crafter-station/skills, 112 stars), AI Bom (cdxgen/cdxgen, 1.1k stars), AI Context Workspace Init (kvker/ai-context-workspace, 101 stars) and Add Remote Endpoint (nextcloud/android-library, 106 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Optimus Prime?

avibebuilder (a GitHub organization) maintains it in avibebuilder/claude-prime, which has 120 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on May 16, 2026.

Source: avibebuilder/claude-prime on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.