oprogramadorreal/optimus-claude / skills/how-to-run
how-to-run
FlaggedGenerates or updates a project's HOW-TO-RUN.md — one verified document teaching a new developer to set up their environment and run the project locally. Detects toolchain, source dependencies, external services, and env config via a read-only agent; audits an existing file against actual project state and offers a display-only guided walkthrough. Never runs setup commands; writes only HOW-TO-RUN.md.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 4.5 KB |
| SKILL.md | skill md | 15.0 KB |
| agents/how-to-run-auditor.md | markdown | 6.2 KB |
| agents/openai.yaml | config | 198 B |
| agents/project-environment-detector.md | markdown | 34.9 KB |
| agents/shared-constraints.md | markdown | 1.7 KB |
| references/detector-framework-config-services.md | markdown | 4.3 KB |
| references/detector-native-and-embedded.md | markdown | 1.7 KB |
| references/external-services-docker.md | markdown | 29.4 KB |
| references/guided-walkthrough.md | markdown | 5.5 KB |
| references/how-to-run-sections.md | markdown | 20.9 KB |
| references/step6-verification-audits.md | markdown | 11.5 KB |
references/detector-native-and-embedded.md
View on GitHub# Native, game-engine, embedded, and Apple build systems
## Build System Detection (niche)
| File | Build system | Extract |
|------|-------------|---------|
| `CMakeLists.txt` | CMake | `cmake_minimum_required(VERSION ...)`, `project(... LANGUAGES ...)`, `find_package(...)` calls (→ SDKs) |
| `meson.build` | Meson | `project('name', ['cpp'], meson_version : '...')` |
| `BUILD.bazel`, `WORKSPACE` | Bazel | Root `WORKSPACE` dependencies |
| `*.xcodeproj`, `*.xcworkspace` | Xcode | Scheme names, deployment target |
| `*.uproject` | Unreal Engine | `EngineAssociation` field (engine version) |
| `ProjectSettings/ProjectVersion.txt` | Unity | `m_EditorVersion` field |
| `project.godot` | Godot | `config/features=PackedStringArray("4.2", ...)` |
| `platformio.ini` | PlatformIO | `platform`, `board`, `framework` |
| `*.ino` | Arduino | Board from comment headers or `arduino-cli.yaml` |
| `Package.swift` | Swift Package Manager | `swift-tools-version` |
| `Podfile` | CocoaPods | `platform :ios, 'X.Y'` |
## Source Dependencies Detection (niche)
| Source | Pattern | Meaning |
|--------|---------|---------|
| `CMakeLists.txt` / `*.cmake` | `FetchContent_Declare` / `ExternalProject_Add` | CMake auto-fetches at configure time — network required for first configure |
| `CMakeLists.txt` | `add_subdirectory(../<name>)` or `add_subdirectory(${CMAKE_SOURCE_DIR}/../<name>)` | Sibling repo expected — document path + clone URL |
| `west.yml` (Zephyr) | `manifest: projects:` blocks | West workspace — `west init` / `west update` |
| `repo` tool / `default.xml` (AOSP-style) | Any content | `repo sync` flow |
## C++ dependency managers
Check `vcpkg.json`, `conanfile.txt`, `conanfile.py` — a C++ dep-manager bootstrap step belongs in Installation.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |