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/skill-mine/mine.mjs

View on GitHub
#!/usr/bin/env node
// Mechanical miner for SKILL-MINE mode.
// Reads Claude Code JSONL transcripts, picks an adaptive 7-30d window, and emits
// frequent tool-call n-grams + Bash command signatures + per-session intent hints.
// The mechanical part (frequency) lives here; semantic clustering/naming is the agent's job.
// Pure Node, no external deps. Output: one JSON object on stdout.
//
// Usage: node mine.mjs [--repo <slug>] [--all] [--days <n>] [--minsup <0..1>]
//                      [--base <dir>] [--ngram-min 2] [--ngram-max 4] [--top 40]

import fs from "node:fs";
import os from "node:os";
import path from "node:path";

function parseArgs(argv) {
  const a = { minsup: 0.2, ngramMin: 2, ngramMax: 4, top: 40, all: false };
  for (let i = 0; i < argv.length; i++) {
    const k = argv[i];
    if (k === "--all") a.all = true;
    else if (k === "--repo") a.repo = argv[++i];
    else if (k === "--days") a.days = Number(argv[++i]);
    else if (k === "--minsup") a.minsup = Number(argv[++i]);
    else if (k === "--base") a.base = argv[++i];
    else if (k === "--ngram-min") a.ngramMin = Number(argv[++i]);
    else if (k === "--ngram-max") a.ngramMax = Number(argv[++i]);
    else if (k === "--top") a.top = Number(argv[++i]);
  }
  return a;
}

// Claude Code derives a project dir name by replacing "/" and "." with "-".
function deriveSlug(cwd) {
  return cwd.replace(/[/.]/g, "-");
}

function listSessionFiles(base, slug, all) {
  if (all) {
    const out = [];
    for (const d of safeReaddir(base)) {
      const dir = path.join(base, d);
      if (!isDir(dir)) continue;
      for (const f of safeReaddir(dir)) if (f.endsWith(".jsonl")) out.push(path.join(dir, f));
    }
    return out;
  }
  const dir = path.join(base, slug);
  return safeReaddir(dir).filter((f) => f.endsWith(".jsonl")).map((f) => path.join(dir, f));
}

function safeReaddir(p) { try { return fs.readdirSync(p); } catch { return []; } }
function isDir(p) { try { return fs.statSync(p).isDirectory(); } catch { return false; } }
function ageDays(file) { return (Date.now() - fs.statSync(file).mtimeMs) / 86400000; }

// Collapse a Bash command into a stable signature: verb (+ subcommand or script basename).
function normalizeBash(cmd) {
  if (typeof cmd !== "string") return null;
  const first = cmd.split(/&&|\|\||\||;|\n/)[0].trim();
  const toks = first.replace(/^\(?\s*/, "").split(/\s+/).filter(Boolean);
  if (!toks.length) return null;
  let verb = toks[0].replace(/^\.\//, "");
  if (verb === "sudo" || verb === "env" || verb === "time") { toks.shift(); verb = (toks[0] || "").replace(/^\.\//, ""); }
  // Pure-noise shell builtins carry no procedure signal; drop so concrete tools (git/gh/node) surface.
  const noise = new Set(["echo", "cd", "ls", "pwd", "cat", "true", "false", "set", "export", "printf"]);
  if (noise.has(verb)) return null;
  const runners = new Set(["node", "python3", "python", "npx", "bun", "deno", "bash", "sh", "ts-node", "tsx"]);
  const subcmd = new Set(["git", "npm", "yarn", "pnpm", "cargo", "go", "docker", "gh", "kubectl", "make", "pip", "pip3"]);
  if (runners.has(verb) && toks[1]) return `${verb} ${path.basename(toks[1]).replace(/['"]/g, "")}`;
  if (subcmd.has(verb) && toks[1] && /^[a-z]/i.test(toks[1])) return `${verb} ${toks[1]}`;
  return verb;
}

function firstTextOf(content) {
  if (typeof content === "string") return content;
  if (Array.isArray(content)) {
    for (const b of content) if (b && b.type === "text" && typeof b.text === "string") return b.text;
  }
  return null;
}

// Pull the per-session signal the miner needs out of one transcript file.
function extractSession(file) {
  const id = path.basename(file, ".jsonl");
  const s = { id, ts: null, tools: [], bash: [], skills: [], firstPrompt: null, branch: null };
  let lines = [];
  try { lines = fs.readFileSync(file, "utf8").split("\n"); } catch { return s; }
  for (const line of lines) {
    if (!line) continue;
    let o; try { o = JSON.parse(line); } catch { continue; }
    if (!s.ts && o.timestamp) s.ts = o.timestamp;
    if (!s.branch && o.gitBranch) s.branch = o.gitBranch;
    if (o.attributionSkill) s.skills.push(o.attributionSkill);
    const msg = o.message || {};
    if (o.type === "user" && !s.firstPrompt) {
      const t = firstTextOf(msg.content);
      if (t && !t.startsWith("<") && t.length > 8) s.firstPrompt = t.slice(0, 240);
    }
    const content = msg.content;
    if (!Array.isArray(content)) continue;
    for (const b of content) {
      if (!b || b.type !== "tool_use") continue;
      s.tools.push(b.name);
      if (b.name === "Bash") { const sig = normalizeBash(b.input?.command); if (sig) s.bash.push(sig); }
      if (b.name === "Skill") { const sk = b.input?.skill || b.input?.command; if (sk) s.skills.push(sk); }
    }
  }
  return s;
}

function ngrams(seq, n) {
  const out = [];
  for (let i = 0; i + n <= seq.length; i++) out.push(seq.slice(i, i + n).join(" > "));
  return out;
}

// Support = fraction of sessions that contain the pattern at least once.
function mineSupport(sessions, keyFn) {
  const sessionsWith = new Map();
  const totalCount = new Map();
  for (const s of sessions) {
    const keys = keyFn(s);
    const seen = new Set();
    for (const k of keys) {
      totalCount.set(k, (totalCount.get(k) || 0) + 1);
      if (!seen.has(k)) { seen.add(k); sessionsWith.set(k, (sessionsWith.get(k) || 0) + 1); }
    }
  }
  return { sessionsWith, totalCount };
}

function rank(map, total, minsup, top) {
  const { sessionsWith, totalCount } = map;
  const rows = [];
  for (const [k, sess] of sessionsWith) {
    const support = sess / total;
    if (support < minsup) continue;
    rows.push({ pattern: k, support: +support.toFixed(3), sessions: sess, count: totalCount.get(k) });
  }
  rows.sort((a, b) => b.sessions - a.sessions || b.count - a.count);
  return rows.slice(0, top);
}

function chooseWindow(files, override) {
  if (override) return { days: override, rationale: `override --days ${override}` };
  // Widen until the window holds enough signal; active repos satisfy 7d immediately.
  for (const days of [7, 14, 30]) {
    const inWin = files.filter((f) => ageDays(f) <= days);
    if (inWin.length >= 3 && days < 30) return { days, rationale: `>=3 sessions within ${days}d`, inWin };
    if (days === 30) return { days, rationale: `widened to max 30d (sparse history)`, inWin };
  }
  return { days: 7, rationale: "default" };
}

function main() {
  const a = parseArgs(process.argv.slice(2));
  const base = a.base || path.join(os.homedir(), ".claude", "projects");
  const slug = a.repo || deriveSlug(process.cwd());
  const allFiles = listSessionFiles(base, slug, a.all);
  const win = chooseWindow(allFiles, a.days);
  const files = allFiles.filter((f) => ageDays(f) <= win.days);
  const sessions = files.map(extractSession);
  const totalCalls = sessions.reduce((n, s) => n + s.tools.length, 0);

  const ngramRows = [];
  for (let n = a.ngramMin; n <= a.ngramMax; n++) {
    const m = mineSupport(sessions, (s) => ngrams(s.tools, n));
    for (const r of rank(m, sessions.length || 1, a.minsup, a.top)) ngramRows.push({ n, ...r });
  }
  ngramRows.sort((x, y) => y.sessions - x.sessions || y.count - x.count);

  const bash = rank(mineSupport(sessions, (s) => s.bash), sessions.length || 1, a.minsup, a.top);
  const skillUse = rank(mineSupport(sessions, (s) => s.skills), sessions.length || 1, 0, 50);
  const intents = sessions
    .filter((s) => s.firstPrompt)
    .map((s) => ({ session: s.id, ts: s.ts, branch: s.branch, prompt: s.firstPrompt, topTools: s.tools.slice(0, 6) }));

  process.stdout.write(JSON.stringify({
    repo: a.all ? "ALL" : slug,
    base,
    window: { days: win.days, rationale: win.rationale },
    scanned: { sessionsInWindow: files.length, totalSessions: allFiles.length, toolCalls: totalCalls },
    minsup: a.minsup,
    alreadySkilled: skillUse.slice(0, 30),
    toolNgrams: ngramRows.slice(0, a.top),
    bashSignatures: bash,
    intentHints: intents.slice(0, 40),
  }, null, 2));
}

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