oprogramadorreal/optimus-claude / skills/init
init
UnverifiedBootstraps 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.
references/tech-stack-detection.md
View on GitHub# Tech Stack Detection
Shared detection tables for identifying project type and package manager from manifest files.
## Manifest → Project Type
| Manifest | Type | Package Manager |
|----------|------|-----------------|
| package.json | Node.js | npm, yarn, pnpm, bun |
| Cargo.toml | Rust | cargo |
| pyproject.toml, setup.py, requirements.txt, Pipfile | Python | pip, poetry, uv, pipenv |
| *.csproj, *.sln | C#/.NET | dotnet |
| pom.xml | Java | maven |
| build.gradle(.kts) | Java/Kotlin | gradle |
| go.mod | Go | go |
| CMakeLists.txt, or a Makefile beside C/C++ sources | C/C++ | cmake, make |
| Gemfile | Ruby | bundler |
| composer.json | PHP | composer |
| pubspec.yaml | Dart/Flutter | pub |
| (other manifest file) | Detect language from file contents | Report it as unsupported — the calling skill runs its fallback |
### .NET note
`.sln` files reference `.csproj` projects — they confirm .NET presence but aren't independent project manifests. Don't count a root `.sln` for root-as-project detection. When a single root `.sln` references all `.csproj` files found during detection, treat the entire solution as one project (see .NET solution consolidation in `project-detection.md`). List all solution projects and their roles in documentation.
### Dart/Flutter note
When `build_runner` is in `dev_dependencies`, document both `build_runner build` and `build_runner watch` commands and note that generated files (`.g.dart`, `.freezed.dart`) must not be edited manually.
## Package Manager Detection
Determines command prefixes for all generated commands.
| Type | Check (in priority order) | Result |
|------|---------------------------|--------|
| Node.js | `pnpm-lock.yaml` exists | pnpm |
| Node.js | `yarn.lock` exists | yarn |
| Node.js | `bun.lockb` or `bun.lock` exists | bun |
| Node.js | default / `package-lock.json` | npm |
| Python | `uv.lock` exists OR `[tool.uv]` in pyproject.toml | uv (prefix commands with `uv run`) |
| Python | `poetry.lock` exists OR `[tool.poetry]` in pyproject.toml | poetry (prefix with `poetry run`) |
| Python | `Pipfile` exists | pipenv (prefix with `pipenv run`) |
| Python | default | pip (bare commands: `pytest`, `ruff`, etc.) |
| Dart/Flutter | `pubspec.yaml` has Flutter SDK dependency (`dependencies.flutter.sdk: flutter`) | flutter (prefix commands with `flutter`) |
| Dart/Flutter | `pubspec.yaml` without Flutter SDK dependency (pure Dart package) | dart (prefix commands with `dart`) |
If a lock file matches no row and manifest detection did not settle the package manager, report it as unsupported — the calling skill runs its fallback.
## Command Prefix Rules
Use the detected package manager for all generated commands — e.g., `pnpm run build` not `npm run build`; `uv run pytest` not bare `pytest`; `flutter test` not `dart test` in Flutter projects.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |