Skip to content

cskwork/supergoal-skill / skills/supergoal

supergoal

Unverified

Route objective-driven development, verification, planning, "teach/explain", codebase learning, and skill evaluation through the Supergoal workflow. Use when Supergoal is requested or an autonomous delivery workflow is needed.

FileKindSize
SKILL.mdskill md12.8 KB
agents/analyst.mdmarkdown1.5 KB
agents/architect.mdmarkdown1.7 KB
agents/code-reviewer.mdmarkdown2.5 KB
agents/db-reader.mdmarkdown2.0 KB
agents/debugger.mdmarkdown2.0 KB
agents/designer.mdmarkdown6.3 KB
agents/executor.mdmarkdown2.8 KB
agents/explore.mdmarkdown2.0 KB
agents/qa-auditor.mdmarkdown4.3 KB
agents/qa-tester.mdmarkdown3.2 KB
agents/security-reviewer.mdmarkdown1.2 KB
agents/skill-forger.mdmarkdown1.6 KB
agents/skill-miner.mdmarkdown1.6 KB
reference/agent-browser.mdmarkdown2.8 KB
reference/arch.mdmarkdown5.1 KB
reference/archify.mdmarkdown3.6 KB
reference/db-access.mdmarkdown2.9 KB
reference/debugging.mdmarkdown6.5 KB
reference/delivery-gate.mdmarkdown6.6 KB
reference/domain-context.mdmarkdown7.8 KB
reference/domain-rules.mdmarkdown1.6 KB
reference/engagement.mdmarkdown3.8 KB
reference/functional-ui.mdmarkdown6.4 KB
reference/harness-eval.mdmarkdown28.7 KB
reference/interview.mdmarkdown7.7 KB
reference/learn-domain.mdmarkdown12.7 KB
reference/market-research.mdmarkdown1.7 KB
reference/observability.mdmarkdown5.0 KB
reference/plan-grounding.mdmarkdown4.3 KB
reference/playwright-cli.mdmarkdown2.6 KB
reference/prototype.mdmarkdown4.5 KB
reference/qa-only.mdmarkdown12.7 KB
reference/qa.mdmarkdown7.9 KB
reference/reporting.mdmarkdown1.5 KB
reference/research.mdmarkdown2.7 KB
reference/review-only.mdmarkdown2.4 KB
reference/role-loop.mdmarkdown26.7 KB
reference/rules.mdmarkdown982 B
reference/skill-mine.mdmarkdown7.6 KB
reference/taste-aesthetics.mdmarkdown7.5 KB
reference/taste-skill-v2.mdmarkdown18.8 KB
reference/taste-sources.mdmarkdown3.0 KB
reference/teach.mdmarkdown28.0 KB
reference/ui-ux.mdmarkdown4.0 KB
reference/vercel-host.mdmarkdown3.6 KB
reference/wayfinder.mdmarkdown7.2 KB
templates/GOAL.mdmarkdown1.3 KB
templates/PLAN.mdmarkdown1.4 KB
templates/QA.mdmarkdown1.2 KB
templates/R-LOOP.mdmarkdown569 B
templates/Z-DONE.mdmarkdown301 B
templates/arch-report.htmlother8.1 KB
templates/commit-gate.shexecutablescript11.6 KB
templates/contrast-gate.mjsexecutablescript4.3 KB
templates/db-access/.env.exampleother451 B
templates/db-access/check-connection.shexecutablescript134 B
templates/db-access/db-access.cmdscript39 B
templates/db-access/db-access.mjsexecutablescript5.2 KB
templates/db-access/read-only-query.shexecutablescript138 B
templates/db-access/schema-summary.shexecutablescript132 B
templates/domain-agent/code-map.mdmarkdown744 B
templates/domain-agent/config.jsonconfig291 B
templates/domain-agent/decisions/README.mdmarkdown270 B
templates/domain-agent/flows/README.mdmarkdown800 B
templates/domain-agent/freshness.mdmarkdown1.2 KB
templates/domain-agent/glossary.mdmarkdown781 B
templates/domain-agent/index.mdmarkdown1.3 KB
templates/domain-agent/invariants.mdmarkdown504 B
templates/domain-agent/qa/README.mdmarkdown879 B
templates/domain-agent/qa/nav-map.mdmarkdown1.2 KB
templates/domain-agent/test-map.mdmarkdown432 B
templates/domain-agent/tickets/README.mdmarkdown204 B
templates/domain-onboarding.htmlother9.2 KB
templates/harness-eval-case.yamlconfig4.4 KB
templates/harness-eval-cases/authored/authored-underspec-001-deepmerge.yamlconfig2.2 KB
templates/harness-eval-cases/authored/authored-underspec-002-csvline.yamlconfig2.0 KB
templates/harness-eval-cases/authored/authored-underspec-003-authz-cache.yamlconfig1.6 KB
templates/harness-eval-cases/fixtures/README.mdmarkdown2.8 KB
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/package.jsonmanifest124 B
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/src/cache.mjsscript494 B
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/test/cache.hidden.test.mjsscript2.2 KB
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/test/cache.visible.test.mjsscript950 B
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/package.jsonmanifest125 B
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/src/order.mjsscript1.3 KB
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/test/order.hidden.test.mjsscript2.2 KB
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/test/order.visible.test.mjsscript1.2 KB
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/package.jsonmanifest124 B
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/src/merge.mjsscript84 B
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/test/merge.hidden.test.mjsscript1013 B
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/test/merge.visible.test.mjsscript276 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/package.jsonmanifest122 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/src/csv.mjsscript77 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/test/csv.hidden.test.mjsscript804 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/test/csv.visible.test.mjsscript240 B
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/package.jsonmanifest126 B
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/src/authorizer.mjsscript601 B
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/test/authorizer.hidden.test.mjsscript3.8 KB
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/test/authorizer.visible.test.mjsscript1.2 KB
templates/harness-eval-cases/revfactory-case-001-rest-api.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-002-bug-fix.yamlconfig2.4 KB
templates/harness-eval-cases/revfactory-case-003-refactoring.yamlconfig2.4 KB
templates/harness-eval-cases/revfactory-case-004-documentation.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-005-complex.yamlconfig2.0 KB
templates/harness-eval-cases/revfactory-case-006-research.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-007-interpreter.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-008-microservice.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-009-sql-engine.yamlconfig2.0 KB
templates/harness-eval-cases/revfactory-case-010-crdt.yamlconfig2.0 KB
templates/harness-eval-cases/revfactory-case-011-raft-kv.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-012-spreadsheet.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-013-bytecode-vm.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-014-event-sourcing.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-015-lsp.yamlconfig2.3 KB
templates/harness-eval-cases/run-local-eval.mjsscript43.3 KB
templates/harness-eval-cases/run-underspec-n3.mjsscript41.1 KB
templates/harness-eval-external/deepswe/README.mdmarkdown9.9 KB
templates/harness-eval-external/deepswe/prepare-supergoal-arm.mjsscript4.4 KB
templates/harness-eval-external/deepswe/run-default-suite.mjsscript6.1 KB
templates/harness-eval-external/deepswe/run-full-cycle.mjsscript25.3 KB
templates/harness-eval-external/deepswe/task-set.yamlconfig12.2 KB
templates/harness-eval-external/featadd/README.mdmarkdown3.9 KB
templates/harness-eval-external/featadd/features.tsvother1.6 KB
templates/harness-eval-external/featadd/gen.shscript4.0 KB
templates/harness-eval-external/featadd/package.pyscript6.2 KB
templates/harness-eval-gate.mjsscript24.9 KB
templates/harness-eval-report.mdmarkdown5.8 KB
templates/harness-eval-result.jsonconfig11.9 KB
templates/harness-eval-runner.mjsscript19.9 KB
templates/harness-eval-stats.mjsscript1.8 KB
templates/learn-grounding-gate.mjsscript6.1 KB
templates/observability/heartbeat.schema.jsonconfig2.5 KB
templates/observability/sg-emit.shexecutablescript5.4 KB
templates/qa-gate.shexecutablescript6.9 KB
templates/qa-only-gate.shexecutablescript5.1 KB
templates/qa-report.mdmarkdown2.8 KB
templates/rules.mdmarkdown301 B
templates/run-state-gate.mjsscript2.2 KB
templates/run-state.jsonconfig474 B
templates/skill-frontmatter-gate.mjsscript3.7 KB
templates/skill-install-audit.mjsexecutablescript3.7 KB
templates/skill-mine/mine.mjsscript7.8 KB
templates/skill.md.templateother568 B
templates/teach-lesson-gate.mjsscript5.4 KB
templates/teach/README.mdmarkdown4.1 KB
templates/teach/assets/lesson-book.jsscript5.8 KB
templates/teach/assets/lesson-template.htmlother6.1 KB
templates/teach/assets/lesson.cssother11.8 KB
templates/teach/assets/quiz.jsscript3.2 KB

templates/qa-only-gate.sh

View on GitHub
#!/usr/bin/env bash
# /supergoal QA-ONLY gate — the literal exit condition for a QA-ONLY run (reference/qa-only.md).
# QA-ONLY writes no code and runs no delivery gate, so THIS is its terminal backstop. It enforces:
#   1) the human report exists with its required anchor sections (so the user always gets a readable result),
#   2) the underlying browser/CLI QA evidence passes (delegates to qa-gate.sh — same as in-pipeline QA),
#   3) the run stayed within its action budget (action_count <= action_cap; default cap 100),
#   4) if a DB was read, it was marked read-only and recorded NO write SQL (the read-only backstop).
# NEVER edit this script to make a non-compliant QA-ONLY run pass — re-run QA properly instead.
#
# Usage: qa-only-gate.sh <vault-dir> <browser|cli>
#   <vault-dir>  the run's changelog folder, e.g. docs/changelog/2026-06/05-qa-checkout
#   browser|cli  app type exercised: a browser app or a CLI/library

set -euo pipefail

usage() { echo "usage: qa-only-gate.sh <vault-dir> <browser|cli>" >&2; exit 2; }
[ $# -ge 2 ] || usage
VAULT="$1"; APPTYPE="$2"
VERIF="$VAULT/QA.md"
REPORT="$VAULT/report.md"
STATE="$VAULT/state.json"
LEDGER="$VAULT/qa/scenario-ledger.md"
fail() { echo "QA-ONLY-GATE FAIL: $*" >&2; exit 1; }

case "$APPTYPE" in browser|cli) ;; *) usage ;; esac

echo "== /supergoal QA-ONLY gate =="
echo "vault: $VAULT  app-type: $APPTYPE"

# 1) Human report present with its required anchor sections (English anchors; prose may be any language).
[ -s "$VAULT/brief.md" ] || fail "brief.md missing/empty — QA scope was never recorded"
[ -s "$LEDGER" ] || fail "qa/scenario-ledger.md missing/empty — Impact Matrix and scenario shards were not recorded"
grep -qiF 'Impact Matrix' "$LEDGER" \
  || fail "qa/scenario-ledger.md is missing the Impact Matrix section"
grep -qiE '^[[:space:]]*##[[:space:]]+Shards([[:space:]]|$)' "$LEDGER" \
  || fail "qa/scenario-ledger.md is missing the Shards section"
grep -qiE '^[[:space:]]*(\||[-*])[^\n#]*(PASS|FAIL|BLOCKED|NOT[ -]?COVERED)[^\n#]*(qa/|evidence|reason|risk|blocked|not[ -]?covered)' "$LEDGER" \
  || fail "qa/scenario-ledger.md has no scenario outcome with status and evidence/reason"
[ -s "$REPORT" ] || fail "report.md missing/empty — the human QA report was not written (templates/qa-report.md)"
while IFS= read -r h; do
  # Match as a real heading (start-of-line, optional trailing space), not a substring buried in prose.
  grep -qiE "^[[:space:]]*${h}[[:space:]]*$" "$REPORT" \
    || fail "report.md is missing the '$h' heading (templates/qa-report.md)"
done <<'EOF'
## Impact coverage
## What worked
## What didn't
## What I discovered
## Reproduction notes
## Not covered
## How to re-run
EOF
echo "  ok: report.md has all required anchor headings"

# 2) Underlying QA evidence (browser as-is/to-be + driver, or CLI smoke) via the shared qa-gate.sh.
QAGATE="$(dirname "$0")/qa-gate.sh"
[ -f "$QAGATE" ] || fail "qa-gate.sh not found next to qa-only-gate.sh"
bash "$QAGATE" "$VAULT" "$APPTYPE" || fail "underlying QA evidence gate failed (see qa-gate output above)"

# 3) Action budget: action_count must be recorded and within action_cap (default 100).
[ -s "$STATE" ] || fail "state.json missing/empty — action_count not recorded"
command -v node >/dev/null 2>&1 || fail "node is required for the action-cap check"
counts="$(node -e '
const fs = require("fs");
let j;
try { j = JSON.parse(fs.readFileSync(process.argv[1], "utf8")); }
catch (e) { console.error("state.json is not valid JSON"); process.exit(3); }
const cap = (typeof j.action_cap === "number") ? j.action_cap : 100;
const cnt = j.action_count;
if (typeof cnt !== "number") { console.error("state.json has no numeric action_count"); process.exit(4); }
process.stdout.write(cnt + " " + cap);
' "$STATE" 2>&1)" || fail "action-cap check: $counts"
cnt="${counts%% *}"; cap="${counts##* }"
[ "$cnt" -le "$cap" ] 2>/dev/null \
  || fail "action_count ($cnt) exceeds action_cap ($cap) — re-scope the QA run; do not raise the cap to pass"
echo "  ok: action_count $cnt within cap $cap"

# 4) DB read-only backstop: if a DB was used, EVERY 'DB:' line must be marked read-only and no write
#    statement (DML/DDL/DCL/stored-proc) may be recorded anywhere in QA.md.
if [ -s "$VERIF" ] && grep -qiE '^[[:space:]]*[-*]?[[:space:]]*DB:' "$VERIF"; then
  # Per-line, so a second DB connection cannot ride in unmarked behind a first read-only one.
  while IFS= read -r dbline; do
    printf '%s' "$dbline" | grep -qiF 'read-only' \
      || fail "a '## QA' DB: line is not marked read-only: ${dbline}"
  done < <(grep -iE '^[[:space:]]*[-*]?[[:space:]]*DB:' "$VERIF")
  if grep -qiE 'INSERT[[:space:]]+INTO|REPLACE[[:space:]]+INTO|DELETE[[:space:]]+FROM|UPDATE[[:space:]]+[^[:space:]]+[[:space:]]+SET|MERGE[[:space:]]+INTO|TRUNCATE([[:space:]]|$)|DROP[[:space:]]+(TABLE|DATABASE|INDEX|VIEW|SCHEMA)|ALTER[[:space:]]+(TABLE|DATABASE|INDEX|VIEW|SCHEMA)|CREATE[[:space:]]+(TABLE|DATABASE|INDEX|VIEW|SCHEMA)|GRANT[[:space:]]|REVOKE[[:space:]]|CALL[[:space:]]' "$VERIF"; then
    fail "## QA records a DB write statement — QA-ONLY DB access is read-only (SELECT/SHOW/DESCRIBE/EXPLAIN only)"
  fi
  echo "  ok: DB used, every DB: line marked read-only, no write SQL recorded"
fi

echo "== QA-ONLY GATE PASS =="
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: 472kUpdated 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