Super Spec
Turn rough intent into a spec another agent can actually build.
What this skill does
Compile messy operator context into a builder-ready product, technical, implementation, ops, or agent handoff spec with proof gates, route receipts, and reviewer prompts.
Install from ClawHub
This skill is mirrored to ClawHub for install-from-the-page convenience.
The ClawHub package is regenerated by scripts/sync-superada-to-clawhub.mjs on every push to main.
Where it lives and how to install it
- Source
- superada-ai/public/skills/super-spec
- Entrypoint
- SKILL.md
- Installability
- Ready for agent install
- Source spec
- https://superada.ai/skills/super-spec/SKILL.md
This page is designed to be the thing you send to another agent. It tells the agent where the source of truth lives, whether install is real today, and what command or manual path to follow.
curl -sSf https://superada.ai/install/super-spec | shInstall the skill described on this page from https://superada.ai/skills/super-spec/SKILL.md. Review the source first, then run: curl -sSf https://superada.ai/install/super-spec | shInstall steps
- Step 1
Review the public skill contract and runner before installing.
- Step 2
Install with the SuperAda curl installer.
- Step 3
Configure a Pro route if you want GPT-5.4 Pro/Oracle output; otherwise run with --no-pro explicitly.
- Step 4
Check the generated route JSON before claiming which model produced the spec.
What it covers
- Skill contract
- Super Spec runner
- Pro preflight helper
- Fail-closed Pro routing notes
- Curl installer
Good use cases
- Create build-ready implementation specs from rough notes
- Write PRD/RFC/ops handoffs with proof gates
- Prepare agent-builder prompts that survive context compaction
- Audit whether a spec was actually produced by Pro or an explicit fallback
Published artifacts
- Skill contract
https://superada.ai/skills/super-spec/SKILL.mdAgent-facing Super Spec usage, output contract, and guardrails.
- Runner
https://superada.ai/skills/super-spec/scripts/run-super-spec.shShell runner that builds prompts, routes to Pro/Oracle when configured, writes specs and route receipts, and fails closed on unexpected fallback.
- Pro preflight
https://superada.ai/skills/super-spec/scripts/gpt54pro-oracle-preflight.shPreflight helper for checking the configured Pro route before a long spec run.
- Curl installer
https://superada.ai/install/super-specInstaller for local agent runtimes.
Current published config examples
super-spec --title "Release gate" --input context.md --no-proexport SUPER_SPEC_ORACLE_BACKGROUND_MODE=on
export SUPER_SPEC_PRO_TIMEOUT=3600
export SUPER_SPEC_PRO_HTTP_TIMEOUT=60m
export SUPER_SPEC_ORACLE_WALL_TIMEOUT=3700s
super-spec --title "Enterprise Local Model Orchestrator" --input context.mdCurrent limits
- Does not replace product judgment; unresolved evidence must stay in Open Questions.
- Long Pro runs may need 60-minute timeouts or split passes.
- Fail-closed behavior means a broken Pro route stops the run unless fallback is explicitly allowed.