Skip to content

hoavdc/CodexKit / skills/codexkit-repo-onboarding

codexkit-repo-onboarding

Verified

Rapidly map a new codebase, identify the runtime model, risk zones, and first high-value next steps.

FileKindSize
SKILL.mdskill md2.3 KB
agents/openai.yamlconfig194 B
examples/common-mistakes.mdmarkdown778 B
examples/good-output.mdmarkdown909 B
verification/checklist.mdmarkdown1.3 KB

examples/common-mistakes.md

View on GitHub
# Common Mistakes — Repo Onboarding

> Anti-patterns to watch for when using the Repo Onboarding skill.

## 1. Outdated setup instructions

**What goes wrong:** Guide says 'npm install' but repo uses pnpm — new dev stuck for hours

**How to fix it:** Test setup instructions on a clean machine quarterly. Or better: use a devcontainer.

## 2. Architecture by aspiration

**What goes wrong:** Describing the ideal architecture, not the current messy reality

**How to fix it:** Document what IS, including tech debt. Mark aspirational sections as 'planned'.

## 3. No suggested first task

**What goes wrong:** New dev finishes setup, then stares at 500 files wondering where to start

**How to fix it:** Include 2-3 'good first issues' with file paths and expected outcome.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall