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/observability/sg-emit.sh

View on GitHub
#!/usr/bin/env sh
# sg-emit - supergoal Board state emitter (opt-in, best-effort, lock-free).
#
# Writes ONE heartbeat JSON per agent, replaced atomically (temp + rename). Correctness comes
# entirely from: one writer per file + atomic rename. No lock anywhere; `branch` is a display
# field, never a mutex, so agents may share a branch freely.
#
# Opt-in: emits only when the Board is enabled (the `$REGDIR/.enabled` flag file that tui/launch.sh
# creates, or SUPERGOAL_TUI=1). With no Board, this is a silent no-op that writes nothing.
# Best-effort: any failure -> one stderr line + exit 0. It must never abort the agent's real work.
#
# Identity is SELF-DERIVED from git in the current dir on every call (Claude Code tool calls do not
# persist exported env across calls, and have no stable per-agent OS pid - so we never rely on either).
# Pass --slot when an orchestrator runs several agents in the SAME worktree+branch, to keep their
# files distinct.
#
# Usage:
#   sg-emit --phase ExactVerify [--mode GREENFIELD] [--task "Add JWT refresh"] \
#           [--task-status in-progress] [--note "2 reds open"] [--slot exec-3f] \
#           [--tasks-file board.json]   # full tasks[] array; else prior board is carried forward
#
# Env: SUPERGOAL_RUN_DIR (default $HOME/.supergoal/runs), SUPERGOAL_TUI=1 to force-enable.

set -u

REGDIR="${SUPERGOAL_RUN_DIR:-$HOME/.supergoal/runs}"

# --- opt-in gate: no Board, no files -------------------------------------------------------------
if [ ! -e "$REGDIR/.enabled" ] && [ "${SUPERGOAL_TUI:-0}" != "1" ]; then
  exit 0
fi

# --- parse args ----------------------------------------------------------------------------------
phase=""; mode=""; task=""; task_status=""; note=""; slot=""; tasks_file=""
while [ $# -gt 0 ]; do
  case "$1" in
    --phase) phase="${2:-}"; shift 2 ;;
    --mode) mode="${2:-}"; shift 2 ;;
    --task) task="${2:-}"; shift 2 ;;
    --task-status) task_status="${2:-}"; shift 2 ;;
    --note) note="${2:-}"; shift 2 ;;
    --slot) slot="${2:-}"; shift 2 ;;
    --tasks-file) tasks_file="${2:-}"; shift 2 ;;
    *) shift ;;  # ignore unknown flags rather than abort
  esac
done

command -v jq >/dev/null 2>&1 || { echo "sg-emit: jq not found, skipped" >&2; exit 0; }

# --- self-derive identity from git (fall back to cwd when not a repo) -----------------------------
repo_path="$(git rev-parse --show-toplevel 2>/dev/null)" || repo_path=""
[ -n "$repo_path" ] || repo_path="$(pwd)"
repo="$(basename "$repo_path")"
branch="$(git rev-parse --abbrev-ref HEAD 2>/dev/null)" || branch="-"
[ -n "$branch" ] || branch="-"
# worktree root: --show-toplevel already resolves linked worktrees to their own root
worktree="$repo_path"
wt_hash="$(printf '%s' "$worktree" | cksum | cut -d' ' -f1)"

slugify() { printf '%s' "$1" | tr '[:upper:]' '[:lower:]' | tr -c 'a-z0-9._-' '-' | sed 's/--*/-/g; s/^-//; s/-$//'; }
agent_id="$(slugify "$repo-$branch-$wt_hash${slot:+-$slot}")"

now="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
pid="${PPID:-0}"          # advisory only; readers use timestamp age as the primary liveness signal
host="$(hostname 2>/dev/null | cut -d. -f1)"; [ -n "$host" ] || host="-"

AGENTS_DIR="$REGDIR/agents"
mkdir -p "$AGENTS_DIR" 2>/dev/null || { echo "sg-emit: cannot mkdir $AGENTS_DIR, skipped" >&2; exit 0; }
DEST="$AGENTS_DIR/$agent_id.json"
TMP="$DEST.tmp.$$"

# --- prior heartbeat: carry forward started_at + tasks[] -----------------------------------------
prior="null"
[ -f "$DEST" ] && prior="$(cat "$DEST" 2>/dev/null || echo null)"
case "$prior" in "") prior="null" ;; esac

# tasks source: explicit file wins; else carry the prior board forward
tasks_json="$(printf '%s' "$prior" | jq -c '.tasks // []' 2>/dev/null || echo '[]')"
if [ -n "$tasks_file" ] && [ -f "$tasks_file" ]; then
  tasks_json="$(jq -c '.' "$tasks_file" 2>/dev/null || printf '%s' "$tasks_json")"
fi

# --- build the heartbeat (atomic write) ----------------------------------------------------------
if jq -n \
  --argjson prior "$prior" \
  --argjson tasks "$tasks_json" \
  --arg agent_id "$agent_id" \
  --arg repo_path "$repo_path" --arg repo "$repo" --arg branch "$branch" --arg worktree "$worktree" \
  --arg mode "$mode" --arg phase "$phase" --arg task "$task" --arg task_status "$task_status" \
  --arg note "$note" --arg now "$now" --arg host "$host" --argjson pid "${pid:-0}" '
  ($prior // {}) as $p
  | ($tasks
      | if $task != "" then
          (map(.title) | index($task)) as $i
          | if $i == null
            then . + [{id: ("t" + ((length)|tostring)), title: $task,
                       status: (if $task_status != "" then $task_status else "in-progress" end)}]
            else (if $task_status != "" then (.[$i].status = $task_status) else . end)
            end
        else . end) as $board
  | {
      schemaVersion: 1,
      agent_id: $agent_id,
      repo_path: $repo_path,
      repo: $repo,
      branch: $branch,
      worktree: $worktree,
      mode: (if $mode != "" then $mode else ($p.mode // null) end),
      phase: (if $phase != "" then $phase else ($p.phase // null) end),
      current_task: (if $task != "" then $task else ($p.current_task // null) end),
      started_at: ($p.started_at // $now),
      updated_at: $now,
      pid: $pid,
      host: $host,
      note: (if $note != "" then $note else null end),
      tasks: $board
    }' > "$TMP" 2>/dev/null && mv -f "$TMP" "$DEST" 2>/dev/null; then
  exit 0
else
  rm -f "$TMP" 2>/dev/null
  echo "sg-emit: write skipped for $agent_id" >&2
  exit 0
fi
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