← Back to skills
Agent-installable Meta Source review 2 minutes

Super Spec

Turn rough intent into a spec another agent can actually build.

Compile messy operator context into a builder-ready product, technical, implementation, ops, or agent handoff spec with proof gates, route receipts, and reviewer prompts.

ClawHub download
This skill is mirrored to the h-mascot ClawHub account for install-from-the-page convenience.
The ClawHub package is regenerated by scripts/sync-superada-to-clawhub.mjs on every push to main.
Open on ClawHub →
Install contract
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.

Canonical source
https://github.com/henrino3/superada-ai/tree/main/public/skills/super-spec
Install command
curl -sSf https://superada.ai/install/super-spec | sh
Prompt to hand another agent
Install 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 | sh

Install 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.md
Agent-facing Super Spec usage, output contract, and guardrails.
Runner
https://superada.ai/skills/super-spec/scripts/run-super-spec.sh
Shell 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.sh
Preflight helper for checking the configured Pro route before a long spec run.
Curl installer
https://superada.ai/install/super-spec
Installer for local agent runtimes.

Current published config examples

Intentional non-Pro local run
super-spec --title "Release gate" --input context.md --no-pro
Long Pro run with background Responses mode
export 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.md

Current 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.