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/subproject-claude.md

View on GitHub
<!-- Keep this file and docs/ updated when this subproject's conventions change -->

# [PACKAGE NAME]

[One-line description]. Part of the [MONOREPO NAME] monorepo. Built with [TECH STACK].

## Commands

[Subproject-specific build, test, lint commands — run from this directory]

## Documentation

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

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

<!-- init adds one row per doc it actually created for this subproject (docs/testing.md,
docs/styling.md, docs/architecture.md). When skill authoring was detected at the repo level, it
also adds a row routing markdown instruction files to root `.claude/docs/skill-writing-guidelines.md`. -->

## Gotchas

[At most 5 bullets — a ceiling, not a target. Only what is specific to this package and would bite
someone who guessed right about everything else: a command that must run from the repo root
instead of here, generated sources, a dependency on a sibling package's build output, a
convention this package deliberately breaks. Skip anything the manifest or a directory listing
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