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/harness-eval-external/featadd/package.py

View on GitHub
#!/usr/bin/env python3
"""Package a FeatAdd-generated regression into a DeepSWE v1.1 debug task.

Input (from gen.sh work dir): base_commit, feature.diff (applied to make the buggy base state),
fix.diff (the gold solution), B (fail-to-pass node ids), P1 (pass-to-pass node ids), test module.

Emits /tmp/deep-swe-sg/tasks/featadd-<id>/ with the same verifier protocol as gen_tasks.py, plus
an environment image that layers feature.diff on sympy-swe-base:v1 so the agent starts from the
broken (feature-applied, B-failing) state and must restore B without reverting the feature.

Usage: package.py <id> <slug> <title> <base_sha> <work_dir> <test_module>
  work_dir must contain feature.diff, fix.diff, B.txt (one node id/line), P1.txt
"""
import json, os, sys, shutil

BASE_IMAGE = "sympy-swe-base:v1"
SKRUB = "/tmp/deep-swe-sg/tasks/skrub-duration-encoding"
OUT = "/tmp/deep-swe-sg/tasks"

# Env image: layer the feature diff onto the shared base, commit -> the buggy starting state.
ENV_DOCKERFILE = """FROM {base_image}
COPY feature.diff /tmp/feature.diff
RUN git checkout -B master {sha} \\
 && git apply --whitespace=nowarn /tmp/feature.diff \\
 && git -c user.name=featadd -c user.email=featadd@local commit -aqm "feature: {id}" \\
 && git remote remove origin 2>/dev/null || true \\
 && git reflog expire --expire=now --all && git gc --prune=now \\
 && git config core.hooksPath /dev/null
CMD ["/bin/bash"]
"""

TESTS_DOCKERFILE = """FROM {image}
COPY test.sh /tests/test.sh
COPY test.patch /tests/test.patch
COPY grader.py /tests/grader.py
COPY config.json /tests/config.json
RUN chmod +x /tests/test.sh
"""

TASK_TOML = """schema_version = "1.1"
artifacts = ["/logs/artifacts/model.patch"]
[task]
name = "local/{task_id}"
description = ""
authors = []
keywords = []
[metadata]
ext_id = "featadd-{task_id}"
task_id = "{task_id}"
display_title = "{title}"
display_description = "{title}"
original_title = "{title}"
category = "bug_fix"
language = "python"
repository_url = "https://github.com/sympy/sympy"
base_commit_hash = "{sha}"
[verifier]
environment_mode = "separate"
timeout_sec = 1800.0
[verifier.env]
[verifier.environment]
build_timeout_sec = 1800.0
cpus = 2
memory_mb = 8192
storage_mb = 20480
allow_internet = false
[agent]
timeout_sec = 5400.0
[environment]
build_timeout_sec = 1800.0
docker_image = "{image}"
os = "linux"
cpus = 2
memory_mb = 8192
storage_mb = 20480
gpus = 0
allow_internet = false
mcp_servers = []
[environment.env]
[solution.env]
"""

PRE_ARTIFACTS = """#!/bin/bash
set -uo pipefail
cd /app || exit 0
mkdir -p /logs/artifacts
git config --global --add safe.directory /app 2>/dev/null || true
# Grade only the agent's work on top of the feature-applied base commit.
git diff --binary HEAD > /logs/artifacts/model.patch 2>/dev/null || true
echo "[pre_artifacts] captured $(wc -c < /logs/artifacts/model.patch) bytes"
"""

SOLVE_SH = """#!/bin/bash
cd /app
git apply --whitespace=nowarn /solution/solution.patch
git add -A
git -c user.name="oracle" -c user.email="oracle@local" commit -q --no-verify -m "Apply reference fix" || true
"""

RUN_TESTS_MIDDLE = """# >>> RUN TESTS (task-specific) <<<
require_cmd() {{ command -v "$1" >/dev/null 2>&1 || {{ log "ERROR: missing $1"; exit 127; }}; }}
require_cmd python3
set +e
run_log python3 -m pytest -q -p no:cacheprovider --junitxml=/logs/verifier/junit.xml {module}
set -e
# >>> END RUN TESTS <<<"""

INSTRUCTION = """{title}

A new feature was recently added to this codebase. After that change, the following existing
tests in `{module}` began to fail:

{failing}

Investigate why the feature broke them and fix the code so those tests pass again. Do not remove
or weaken the new feature, and do not edit the tests.

IMPORTANT: Please work on this in a new branch and commit everything when you are done.
"""


def build_test_sh(module):
    src = open(os.path.join(SKRUB, "tests", "test.sh")).read()
    import re
    middle = RUN_TESTS_MIDDLE.format(module=module)
    out = re.sub(r"# >>> RUN TESTS \(task-specific\) <<<.*?# >>> END RUN TESTS <<<",
                 middle.replace("\\", "\\\\"), src, flags=re.S)
    assert "junitxml=/logs/verifier/junit.xml" in out
    return out


def main():
    _id, slug, title, sha, work, module = sys.argv[1:7]
    task_id = f"featadd-{_id}-{slug}"
    image = f"featadd-{_id}:v1"
    root = os.path.join(OUT, task_id)
    modpath = module[:-3].replace("/", ".")  # sympy/.../test_x.py -> sympy...test_x
    B = [l.strip() for l in open(os.path.join(work, "B.txt")) if l.strip()]
    P1 = [l.strip() for l in open(os.path.join(work, "P1.txt")) if l.strip()]
    to_junit = lambda n: f"{modpath}.{n}"
    f2p = [to_junit(n) for n in B]
    p2p = [to_junit(n) for n in P1]

    if os.path.exists(root):
        shutil.rmtree(root)
    for d in ("tests", "environment", "solution"):
        os.makedirs(os.path.join(root, d))
    w = lambda rel, text, exe=False: (open(os.path.join(root, rel), "w").write(text),
                                      exe and os.chmod(os.path.join(root, rel), 0o755))
    w("task.toml", TASK_TOML.format(task_id=task_id, title=title, sha=sha, image=image))
    w("instruction.md", INSTRUCTION.format(title=title, module=module,
                                           failing="\n".join(f"- {n}" for n in B)))
    w("pre_artifacts.sh", PRE_ARTIFACTS, exe=True)
    shutil.copy(os.path.join(work, "feature.diff"), os.path.join(root, "environment", "feature.diff"))
    w("environment/Dockerfile", ENV_DOCKERFILE.format(base_image=BASE_IMAGE, sha=sha, id=_id))
    w("solution/solution.patch", open(os.path.join(work, "fix.diff")).read())
    w("solution/solve.sh", SOLVE_SH, exe=True)
    w("tests/Dockerfile", TESTS_DOCKERFILE.format(image=image))
    w("tests/test.patch", "")  # tests already in the image; no separate test patch
    w("tests/test.sh", build_test_sh(module))
    shutil.copy(os.path.join(SKRUB, "tests", "grader.py"), os.path.join(root, "tests", "grader.py"))
    w("tests/config.json", json.dumps({
        "base_commit": sha, "f2p_node_ids": f2p, "p2p_node_ids": p2p,
        "grade": {"format": "junit", "tool_label": "pytest-junitxml",
                  "reports": ["/logs/verifier/junit.xml"]}}, indent=1))
    print(f"packaged {task_id}: f2p={len(f2p)} p2p={len(p2p)} image={image} sha={sha[:12]}")
    print(f"  build: docker build -t {image} {root}/environment")


if __name__ == "__main__":
    main()
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