darkroomengineering
OrganizationClaude Code configuration — agents, skills, hooks & settings for Darkroom Engineering
Categories
Indexed Skills (37)
adhd
Parallel divergent ideation — framed generators, then a critic scores, clusters, deepens top 3. Triggers "/adhd", "brainstorm", "ideate", "widen the option space", fuzzy design/debugging. Skip lookups, syntax, known-root-cause bugs.
audit
Eight audit modes (codebase — owns "audit the codebase" — docs/process, performance, threat-model, motion, SEO, debt). Triggers "nuclear review", "whole codebase review", "adversarial audit", "fable audit", "correctness audit", "audit the docs", "doc drift", "process audit", "perf audit", "why is it slow", "bundle audit", "threat model", "attack surface", "motion audit", "seo audit", "aeo", "llms.txt", "debt ledger", "shortcut ledger". Single-page CWV routes to /lighthouse.
checkpoint
Mid-task rollback points — save/restore state before risky ops (refactors, migrations, destructive edits). For end-of-session save use `/handoff`. Triggers "checkpoint", "snapshot", "before this risky op", "rollback to", "list checkpoints", pre-refactor save.
lighthouse
Lighthouse audit + improvement loop until targets met. Triggers "lighthouse", "page speed", "improve scores", "LCP", "CLS", "INP", "core web vitals". Repo-wide perf audits ("perf audit") go to /audit performance mode instead.
qa
Visual + a11y QA — screenshot-first critique, contrast, touch targets, mockup-vs-impl diff. For adversarial logic checks use `/verify`. Triggers "visual QA", "QA check", "does this look right", "a11y check", "contrast check", post-component changes.
tldr
TLDR code analysis — call graphs, semantic search, impact, dataflow, for far fewer tokens than reading the files raw. Triggers "who calls X", "what affects X", "blast radius", before large file reads or refactors.
freeze
Block Edit/Write outside one session directory to contain debugging or parallel agents. Triggers "freeze edits", "lock editing scope", "restrict edits to", "only edit this folder", "unfreeze".
autoresearch
Autonomous skill-prompt optimization — Karpathy-style mutate/score/keep loop on SKILL.md. Triggers "autoresearch", "optimize skill", "tune", "evolve" a skill, "prompt optimization".
build
Build feature/page/integration end-to-end with GO/NO-GO gate. For components use `/component`, hooks `/hook`. Triggers "build a feature/page", "implement feature", "add feature", "build integration".
cc
Sync cc-settings with Claude Code upstream (maintainer) or update a local Claude Code/Codex install (user). Triggers "sync with claude code", "changelog sync", "upstream sync" (sync mode); "update cc-settings", "refresh my install" (update mode).
codex
Claude-Codex bridge for bulk/mechanical execution, independent diff review, or read-only advice. Triggers "use codex", "have codex do", "codex exec", "have codex review", "have codex check", "cross-check with codex", "second opinion from codex", "ask codex".
component
Create UI component / widget / reusable piece. Triggers "create component", "new component", "add component", or naming a component (Button, Header, Card).
consolidate
Audit and prune rules/skills/learnings to prevent context bloat. Triggers "consolidate", "clean up rules", "spa day", "what's redundant", degraded agent perf.
design-tokens
Generate WCAG-checked type, color, spacing, and dark-mode tokens, or consolidate Tailwind v4 tokens with identical rendering. Triggers "design tokens", "type scale", "color palette", "theme setup", "reduce tokens", "dedupe tokens", "consolidate tokens".
explore
Read-only codebase investigation via Explore agent; also handles upward-zoom for unfamiliar code regions. Triggers "how does X work", "where is X", "find X", "understand X", "navigate codebase", "zoom out", "bigger picture", "where does this fit".
fix
Debug and fix bugs/errors/failures, including merge conflicts and failing PR CI checks. Triggers "fix", "broken", "not working", "bug", "error", "failing", "merge conflict", "fix CI", "checks failing", console errors, build/test failures, regression.
handoff
End-of-session save and next-session resume. Triggers "ending session", "wrapping up", "context window", "running out of context", "done for today" (save mode); "continue where we left off", "pick up where", "last session", "previous work", "resume" (resume mode).
harvest
Turn proven session behavior into a skill, rule, profile, AGENTS.md diff, or team learning; artifacts seed /autoresearch evals. Triggers "harvest this workflow", "turn this session into a skill", "preserve this behavior", "model handoff".
hook
Create reusable React hook (useX pattern). Triggers "create hook", "new hook", "custom hook", "useAuth"/"useScroll"-style names, extracting logic from a component.
oracle
Expert agent in advice, risk, or weighted-comparison mode. Triggers "what should I", "advice on"; "what could go wrong", "risks", "premortem"; or "compare approaches", "which is better", "trade-off analysis", "tech selection".
orchestrate
Multi-agent coordination across plan/implement/test/review; fan-out for 3+ workstreams. Triggers "coordinate", "orchestrate", "parallel agents", "fan out", "split work", refactor, "overnight", "autonomous task", "marathon".
plan-ceo-review
CEO/founder-mode plan review — stress-tests a plan through a product lens before committing. Triggers "ceo review", "founder review", "product review", "should we even build this", or before a large architectural commitment.
plan-feature
Pre-implementation planning — interview to clarify scope, then compile into a PRD. Triggers "help me figure out", "vague scope", "define requirements" (discovery phase); "PRD", "requirements document", "product spec", "feature spec", "write requirements" (PRD phase).
refactor
Behavior-preserving restructuring of code NOT in your current diff — extract modules, rename across files, pay down tech debt. For just-changed code use /zero-tech-debt. Triggers "refactor X", "restructure", "extract Y from Z".
retro
Weekly engineering retrospective with persistent metrics — commit patterns, work sessions, code-quality trends. Triggers "retro", "retrospective", "weekly review", "how was my week", "engineering metrics", "velocity", "what did I ship", "show me my stats".
review
Review the local unstaged/staged diff with Darkroom's checklist, or summarize active-PR feedback. Triggers "review my changes", "check this diff", "PR comments", "summarize PR feedback". Native /code-review handles a diff or PR.
share-learning
Promote a team-relevant learning to the shared team-knowledge repo, deduping against existing notes first. Triggers "share this", "promote to the team repo", "add to the knowledge base", or after a gotcha/decision/convention worth team-wide awareness.
ship
Verify and publish by pushing, opening a PR, and watching CI; land mode merges then cleans branches. Triggers "ship it", "create PR", "/ship", "watch the PR", "babysit CI"; land mode "land it", "/ship land", "fix CI and merge".
strategist
Product strategy advice on vision, positioning, and how architecture decisions serve them. Triggers "strategist", "product strategy", "market positioning", "what should we build", "product direction".
verify
Adversarial verification — three competing agents (issue-finder, disprover, judge). Triggers "verify", "double check", "are you sure", "poke holes"; pre-prod, post-critical-fix.
zero-tech-debt
Rewrite an accreted patch into its intended end-state by removing unused compatibility layers, flags, fallbacks, and wrappers. Triggers "zero tech debt", "rewrite as if from scratch", "delete the compat layer", "kill the legacy path", "too many flags".
dr-init
Initialize new Darkroom project from a satus or novus starter (NOT the same as native /init which writes CLAUDE.md). Triggers "new darkroom project", "satus", "novus", "scaffold from starter".
triage
First-pass review of a client or unfamiliar repo — sweep for glaring issues, report ranked findings. READ-ONLY on external repos. Triggers "triage this repo", "point out glaring issues", "first pass on this client repo".
project
GitHub Issues as PLAN.md replacement — agents read/update them. Auto-invoke on issue-linked branches. Triggers "what's the plan", "project status", "sync with github", "close the issue".
proof-of-work
Run the machine-verifiable gate (typecheck/test/lint, plus a screenshot for UI) so an agent's diff is review-ready before a human sees it. Triggers "proof of work", "is this review-ready", "prove it is green".
review-batch
Batch-review diffs from several agents with per-change re-entry cards and reading diffs (real diff, abridged). Triggers "review batch", "batch review", "what's pending review", "reading diff", or after fanning out several agents.
context-doc
Build CONTEXT.md (domain glossary) + docs/adr/ via interview; keeps agent vocab aligned. Triggers "domain language", "glossary", "ADR", inconsistent terminology.
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.