Skip to content

ethanplusai/codex-on-crack / plugins/codex-on-crack/skills/crack

Lead substantial Codex builds with one configured implementation worker and lead acceptance. Use when the user requests codex-on-crack, names a model to delegate work to, asks to run subagents through Claude, or requests a lead/worker split. Keep host-only work direct; honor explicit external model choices. Workers must not invoke this orchestrator.

FileKindSize
SKILL.mdskill md8.0 KB
agents/openai.yamlconfig300 B
references/build-records.mdmarkdown2.7 KB
references/checkpoint.mdmarkdown1.3 KB
references/external-lead.mdmarkdown13.9 KB
references/measurement.mdmarkdown1.8 KB
references/model-selection.mdmarkdown2.2 KB
references/parallel.mdmarkdown1.7 KB
references/policy.mdmarkdown494 B
references/replay.mdmarkdown3.2 KB
references/verification.mdmarkdown2.1 KB
references/worker-contract.mdmarkdown1.3 KB
scripts/doctor.mjsscript608 B
scripts/lead.mjsscript26.0 KB
scripts/lib/catalog.mjsscript5.6 KB
scripts/lib/changes.mjsscript13.3 KB
scripts/lib/config.mjsscript6.5 KB
scripts/lib/external-lead.mjsscript56.7 KB
scripts/lib/io.mjsscript3.8 KB
scripts/lib/lead-protocol.mjsscript25.9 KB
scripts/lib/plan.mjsscript9.2 KB
scripts/lib/readiness.mjsscript6.0 KB
scripts/lib/report.mjsscript10.7 KB
scripts/lib/roles.mjsscript8.9 KB
scripts/lib/routing.mjsscript2.7 KB
scripts/lib/toml.mjsscript785 B
scripts/lib/trial.mjsscript12.4 KB
scripts/report.mjsscript2.7 KB
scripts/select.mjsscript3.9 KB
scripts/setup.mjsscript7.0 KB
scripts/trial.mjsscript1.8 KB
scripts/validate-plan.mjsscript2.6 KB
scripts/worktree.mjsscript7.8 KB
templates/checkpoint.mdmarkdown903 B
templates/plan.jsonconfig680 B
templates/spec.mdmarkdown742 B
templates/task-brief.mdmarkdown2.5 KB
templates/task-report.mdmarkdown1.5 KB
viewer/README.mdmarkdown5.9 KB
viewer/bridge.mjsscript16.6 KB
viewer/fixtures/sample.jsonconfig8.2 KB
viewer/package.jsonmanifest187 B
viewer/public/app.mjsscript8.8 KB
viewer/public/index.htmlother1.8 KB
viewer/public/style.cssother4.4 KB
viewer/serve.mjsscript11.2 KB
viewer/src/adapter.mjsscript9.9 KB
viewer/src/emit.mjsscript992 B
viewer/src/model.mjsscript8.9 KB
viewer/src/server.mjsscript4.1 KB
viewer/src/tail.mjsscript1.9 KB
viewer/test/browser.mjsscript2.6 KB
viewer/test/server.test.mjsscript3.2 KB
viewer/test/usage.test.mjsscript9.0 KB
viewer/test/viewer.test.mjsscript5.1 KB

scripts/select.mjs

View on GitHub
#!/usr/bin/env node
// Deterministic advisory selection. Never dispatches or changes configuration.
import { parseArgs } from 'node:util';
import { CrackError, run } from './lib/io.mjs';
import { doctor } from './lib/readiness.mjs';
import { TASK_CATEGORIES, ROLE_NAME } from './lib/roles.mjs';

const USAGE = 'Usage: select.mjs --task CATEGORY [--role NAME] [--vision] [--min-context N] [--home dir] [--codex-home dir] [--profile name]';
run((argv) => {
  let values;
  try { ({ values } = parseArgs({ args: argv, strict: true, options: {
    task: { type: 'string' }, role: { type: 'string' }, vision: { type: 'boolean' },
    'min-context': { type: 'string' }, home: { type: 'string' }, 'codex-home': { type: 'string' }, profile: { type: 'string' },
  } })); } catch { throw new CrackError('usage', 'Invalid selection arguments.', USAGE); }
  if (!TASK_CATEGORIES.includes(values.task) || (values.role !== undefined && !ROLE_NAME.test(values.role))) {
    throw new CrackError('usage', 'Supply a supported task category and valid role name.', USAGE);
  }
  const minimum = values['min-context'] === undefined ? null : Number(values['min-context']);
  if (minimum !== null && (!/^[1-9][0-9]*$/.test(values['min-context']) || !Number.isSafeInteger(minimum))) {
    throw new CrackError('usage', '--min-context must be a positive safe integer.', USAGE);
  }
  const readiness = doctor(values);
  const excluded = [];
  const candidates = readiness.rungs.filter((rung) => rung.kind === 'primary').filter((rung) => {
    const reasons = [];
    if (values.role && rung.role !== values.role) return false;
    const tasks = rung.tasks ?? (rung.role === 'builder' ? ['implementation'] : []);
    if (!values.role && !tasks.includes(values.task)) reasons.push('Task category is not mapped to this role.');
    const needsWrites = ['implementation', 'ui', 'tests'].includes(values.task);
    if (rung.writes !== needsWrites) reasons.push(needsWrites ? 'Task requires a role allowed to write.' : 'Task requires a read-only role.');
    if (values.vision && !rung.vision) reasons.push('Image input capability is not advertised by the catalog.');
    if (minimum !== null && (rung.context_window === null || rung.context_window < minimum)) reasons.push('Catalog context window is unknown or below the requested minimum.');
    if (reasons.length) { excluded.push({ role: rung.role, reasons }); return false; }
    return true;
  }).map((rung) => ({ ...rung, reasons: [values.role ? 'Explicit configured role requested.' : 'Configured task mapping matched.',
    'Role write permission matches the task category.', ...(values.vision ? ['Catalog advertises image input.'] : []),
    ...(minimum === null ? [] : ['Catalog context window meets the requested minimum.'])] }));
  const ready = readiness.delegation.ready;
  return {
    ok: ready, status: !ready ? 'not-ready' : candidates.length === 1 ? 'selected' : 'needs-choice',
    task: values.task, selected: ready && candidates.length === 1 ? candidates[0] : null, candidates, excluded,
    reasons: !ready ? ['Static readiness must pass before a role can be recommended.'] : candidates.length === 0
      ? ['No configured primary role satisfies the request; configure a compatible role or revise the request.']
      : candidates.length > 1 ? ['Multiple user-configured roles qualify; the lead must ask for a choice.'] : ['Exactly one configured primary role qualifies.'],
    readiness: readiness.status, problems: readiness.problems,
    runtime_verified: false, inference_request_made: false,
    unknown: ['Live inference and serving identity', 'Task quality, latency, and cost', 'Active project, UI, CLI, and managed overrides', 'Whether a fresh client session loaded these roles'],
    limitations: [...readiness.warnings, 'Advisory only: no dispatch, fallback selection, model ranking, or root/session/configuration change.',
      'Catalog capabilities are local metadata; absent capabilities do not establish support.'],
  };
});
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