Skip to content

oprogramadorreal/optimus-claude / skills/init

Bootstraps a project for Claude Code or Codex — generates routed project guidance from detected structure, reconciles existing docs, and offers test infrastructure. Claude Code can also install formatter hooks. Writes .claude/, CLAUDE.md, AGENTS.md and subproject docs/; may append to README/.gitignore and, with approval, install dev dependencies. Preserves existing guidance through review and recorded ownership. Use for initial setup or upgrades.

templates/single-project-claude.md

View on GitHub
<!-- Keep this file and .claude/docs/ updated when project structure, conventions, or tooling changes -->

# [PROJECT NAME]

[One-line description]. Built with [TECH STACK].

## Commands

```bash
[build command]      # Build the project
[test command]       # Run tests
[lint command]       # Lint source files
```

## Documentation

Read the doc that matches the change — not all of them.

| Changing | Read first |
|---|---|
| Code | `.claude/docs/coding-guidelines.md` |

<!-- init adds one row per doc it actually created. When skill authoring was detected, it also adds:
| A skill, agent, prompt, or command (markdown instruction files) | `.claude/docs/skill-writing-guidelines.md` | -->

## Gotchas

[At most 5 bullets — a ceiling, not a target. Only things that would bite someone who guessed
right about everything else: an invariant a script or CI depends on, a command that must run from
a specific directory, a file that looks editable but is generated, a convention the code
deliberately violates in one place, setup that fails in a non-obvious way, a dependency pinned for
a reason. Skip anything a directory listing, the manifest, or reading one file would reveal.
Write none and delete this section rather than filler.]
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall