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/teach-lesson-gate.mjs

View on GitHub
#!/usr/bin/env node
// /supergoal TEACH lesson gate -- the executable exit check that a generated lesson is an
// INTERACTIVE teaching unit, not a reading-only document. reference/teach.md already says
// "Reading-only HTML is not a lesson" and ships a scaffold (templates/teach/assets/), but nothing
// enforced it, so real lessons drifted into beautiful static articles (inline <style>, one long
// <article> scroll, a promised "이해 점검" that never renders). This gate removes that failure mode.
//
// It deterministically rejects a lesson that is:
//   - off-scaffold      : does not link the shared assets/lesson.css + quiz.js + lesson-book.js
//   - a long scroll     : has no .book page shell (.pages-track + .pager + >=2 data-title sections)
//   - reading-only      : ships no hydrated .sg-quiz with a data-correct option (nothing to *do*)
//
// The agent cannot fudge these -- the markup either wires the scaffold and a working quiz, or it
// does not. NEVER edit this script to make a failing lesson pass; fix the lesson instead.
//
// Usage: teach-lesson-gate.mjs <lesson.html | lessons-dir> [more...]
//   Each argument is a lesson HTML file or a directory (scanned shallowly for *.html).
//   Exit 0 = every lesson clears every check.
//   Exit 1 = at least one lesson is reading-only / off-scaffold.
//   Exit 2 = usage error / no lessons found.

import { readFileSync, readdirSync, statSync, existsSync } from "node:fs";
import { join } from "node:path";

function usage(message) {
  if (message) process.stderr.write(`teach-lesson-gate: ${message}\n`);
  process.stderr.write("usage: teach-lesson-gate.mjs <lesson.html | lessons-dir> [more...]\n");
  process.exit(2);
}

const args = process.argv.slice(2);
if (args.length === 0) usage("missing lesson path");

// Collect .html files from the given files and directories (directories scanned shallowly,
// matching the flat teach/<topic>/lessons/ layout).
const files = [];
for (const arg of args) {
  if (!existsSync(arg)) usage(`path not found: ${arg}`);
  const stat = statSync(arg);
  if (stat.isDirectory()) {
    for (const name of readdirSync(arg)) {
      if (name.toLowerCase().endsWith(".html")) files.push(join(arg, name));
    }
  } else if (arg.toLowerCase().endsWith(".html")) {
    files.push(arg);
  } else {
    usage(`not an .html file or directory: ${arg}`);
  }
}
if (files.length === 0) usage("no .html lessons found in the given path(s)");

console.log("== /supergoal TEACH lesson gate ==");
console.log(`lessons: ${files.length}`);

const count = (html, re) => (html.match(re) || []).length;

let failed = 0;

for (const file of files) {
  const html = readFileSync(file, "utf8");
  const problems = [];

  // 1. a real, localized HTML document
  if (!/<html[\s>]/i.test(html) || !/<\/html>/i.test(html)) {
    problems.push("not a complete HTML document (<html> ... </html>)");
  }
  if (!/<html[^>]*\blang\s*=/i.test(html)) {
    problems.push("missing <html lang=...> (a11y / i18n)");
  }

  // 2. built from the shared scaffold, not hand-rolled (the "looks like one course" rule)
  if (!/<link\b[^>]*\blesson\.css\b[^>]*>/i.test(html)) {
    problems.push(
      "does not link the shared assets/lesson.css -- build from templates/teach/assets, do not inline a one-off stylesheet",
    );
  }
  if (!/<script\b[^>]*\blesson-book\.js\b[^>]*>/i.test(html)) {
    problems.push("does not load assets/lesson-book.js (book-layout engine)");
  }
  if (!/<script\b[^>]*\bquiz\.js\b[^>]*>/i.test(html)) {
    problems.push("does not load assets/quiz.js (interactive quiz engine)");
  }

  // 3. a paged book shell, not one long scroll
  if (!/<main\b[^>]*class\s*=\s*["'][^"']*\bbook\b/i.test(html)) {
    problems.push('no <main class="book"> shell -- a lesson is a paged book, not a long <article> scroll');
  }
  if (!/\bpages-track\b/.test(html)) {
    problems.push("no .pages-track page container found");
  }
  if (!/class\s*=\s*["'][^"']*\bpager\b/i.test(html)) {
    problems.push("no .pager (prev/next navigation) found");
  }
  const pages = count(html, /<section\b[^>]*\bdata-title\s*=/gi);
  if (pages < 2) {
    problems.push(`only ${pages} <section data-title> page(s); a book lesson needs >= 2 pages`);
  }

  // 4. at least one hydrated, answerable quiz -- the "user must DO something" requirement
  const quizzes = count(html, /class\s*=\s*["'][^"']*\bsg-quiz\b/gi);
  const correct = count(html, /\bdata-correct\b/gi);
  const promisesCheck = /이해\s*점검|이해\s*확인|미니\s*퀴즈|\bquiz\b/i.test(html);
  if (quizzes === 0) {
    problems.push(
      promisesCheck
        ? "promises a check/quiz in prose but ships no .sg-quiz -- reading-only HTML is not a lesson"
        : "no interactive .sg-quiz block -- reading-only HTML is not a lesson",
    );
  } else {
    if (!/\bsg-options\b/.test(html)) {
      problems.push(".sg-quiz present but has no .sg-options list");
    }
    if (correct === 0) {
      problems.push(".sg-quiz present but no option marked data-correct -- the quiz cannot be answered");
    }
  }

  if (problems.length === 0) {
    console.log(`  PASS  ${file}`);
  } else {
    failed++;
    console.log(`  FAIL  ${file}`);
    for (const problem of problems) console.log(`        - ${problem}`);
  }
}

console.log(`  checked ${files.length} lesson(s), ${failed} failed`);
if (failed > 0) {
  console.error(
    `TEACH-LESSON-GATE FAIL: ${failed} lesson(s) are reading-only or off-scaffold -- rebuild from templates/teach/assets; never weaken this gate`,
  );
  process.exit(1);
}
console.log("== TEACH LESSON 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