Skip to content

code-yeongyu/oh-my-openagent / packages/shared-skills/skills/ulw-research

ulw-research

Unverified

Runs maximum-saturation research with a cooperating team, claim-graph gating, and a cited, QA'd deliverable. Use when the user explicitly asks for research or a deep investigation, including any 'ulw' research wording.

FileKindSize
AGENTS.mdmarkdown9.2 KB
ATTRIBUTION.mdmarkdown2.4 KB
SKILL.mdskill md42.2 KB
references/deliverable-phase.mdmarkdown49.1 KB
references/fact-ledger-grammar.mdmarkdown6.8 KB
references/fact-ledger.mdmarkdown24.4 KB
references/fidelity-claim-kinds.mdmarkdown5.2 KB
references/markdown-blocks.mdmarkdown721 B
references/report-gates.mdmarkdown32.0 KB
references/report-visualization.mdmarkdown15.4 KB
references/research-collection.mdmarkdown26.8 KB
references/research-delivery.mdmarkdown14.3 KB
references/unit-rules.mdmarkdown16.3 KB
scripts/claim-kinds.mjsscript11.2 KB
scripts/claim-kinds.test.tsscript13.5 KB
scripts/claim-prefix.test.tsscript4.9 KB
scripts/claims-index.mjsscript5.3 KB
scripts/claims-index.test.tsscript5.7 KB
scripts/cli-support.mjsscript4.1 KB
scripts/cli-support.test.tsscript4.3 KB
scripts/contracts-validation.test.tsscript3.3 KB
scripts/contracts.mjsscript26.1 KB
scripts/contracts.test.tsscript7.9 KB
scripts/conversion-altered.test.tsscript11.0 KB
scripts/conversion-originals.test.tsscript22.7 KB
scripts/conversion-probe-classes.test.tsscript45.2 KB
scripts/conversion-probe.mjsscript13.5 KB
scripts/conversion-probe.test.tsscript11.6 KB
scripts/copy-returns-fidelity-policy.test.tsscript10.4 KB
scripts/copy-returns-polish.test.tsscript12.1 KB
scripts/copy-returns.test.tsscript10.6 KB
scripts/css-hiding.mjsscript9.1 KB
scripts/css-lite.mjsscript7.6 KB
scripts/css-lite.test.tsscript6.4 KB
scripts/delivery-barrier-meaning.test.tsscript12.3 KB
scripts/delivery-barrier.test.tsscript11.4 KB
scripts/design-spec.mjsscript7.2 KB
scripts/design-spec.test.tsscript6.7 KB
scripts/entities.mjsscript2.5 KB
scripts/entry-guard.mjsscript794 B
scripts/fact-commands-fill.mjsscript6.6 KB
scripts/fact-commands-meaning.mjsscript12.6 KB
scripts/fact-commands-polish.mjsscript10.3 KB
scripts/fact-commands-verify.mjsscript12.6 KB
scripts/fact-commands.mjsscript13.8 KB
scripts/fact-derive-2.test.tsscript7.2 KB
scripts/fact-derive.mjsscript4.9 KB
scripts/fact-derive.test.tsscript10.8 KB
scripts/fact-expr.mjsscript4.5 KB
scripts/fact-fill.mjsscript11.7 KB
scripts/fact-fill.test.tsscript10.7 KB
scripts/fact-ledger-grammar.test.tsscript11.8 KB
scripts/fact-ledger-kinds.mjsscript16.5 KB
scripts/fact-ledger-kinds.test.tsscript9.3 KB
scripts/fact-ledger-legacy.test.tsscript8.9 KB
scripts/fact-ledger-schema.mjsscript11.9 KB
scripts/fact-ledger-schema.test.tsscript1.5 KB
scripts/fact-ledger.mjsscript5.5 KB
scripts/fact-ledger.test.tsscript9.7 KB
scripts/fact-locate.mjsscript12.1 KB
scripts/fact-locate.test.tsscript7.2 KB
scripts/fact-pairs.mjsscript8.3 KB
scripts/fact-pairs.test.tsscript6.6 KB
scripts/fact-recompute.mjsscript4.8 KB
scripts/fact-unit-dimensions-2.test.tsscript8.4 KB
scripts/fact-unit-dimensions.test.tsscript11.9 KB
scripts/fact-unit-rules.test.tsscript8.9 KB
scripts/fidelity-binding.mjsscript6.7 KB
scripts/fidelity-binding.test.tsscript4.0 KB
scripts/fidelity-brief.mjsscript6.4 KB
scripts/fidelity-brief.test.tsscript7.8 KB
scripts/fidelity-claims.mjsscript5.1 KB
scripts/fidelity-csv.mjsscript1.1 KB
scripts/fidelity-lexicon.mjsscript8.1 KB
scripts/fidelity-lexicon.test.tsscript6.0 KB
scripts/fidelity-originals.mjsscript9.9 KB
scripts/fidelity-policy.mjsscript10.1 KB
scripts/fidelity-records.mjsscript13.4 KB
scripts/fidelity-snapshot-readability.mjsscript2.2 KB
scripts/fidelity-sources.mjsscript4.3 KB
scripts/fidelity-state.mjsscript2.1 KB
scripts/fidelity-state.test.tsscript1.7 KB
scripts/fidelity-trace.mjsscript6.1 KB
scripts/fidelity-trace.test.tsscript3.3 KB
scripts/fidelity-value-unit.mjsscript13.3 KB
scripts/fidelity-values.mjsscript16.1 KB
scripts/fidelity-values.test.tsscript15.8 KB
scripts/format-extract-css.mjsscript5.1 KB
scripts/format-extract.mjsscript10.3 KB
scripts/format-extract.test.tsscript11.2 KB
scripts/gates-context.test.tsscript2.6 KB
scripts/gates-fidelity.mjsscript6.3 KB
scripts/gates-fidelity.test.tsscript3.3 KB
scripts/gates-figures.mjsscript9.9 KB
scripts/gates-layout.mjsscript6.6 KB
scripts/gates-layout.test.tsscript12.4 KB
scripts/gates-static-headings.test.tsscript961 B
scripts/gates-static.mjsscript8.1 KB
scripts/gates-static.test.tsscript14.9 KB
scripts/gates-structure.mjsscript4.7 KB
scripts/gates-text.mjsscript7.2 KB
scripts/glossary-vocabulary.test.tsscript1.7 KB
scripts/html-foreign-object.mjsscript2.8 KB
scripts/html-lite.mjsscript9.7 KB
scripts/html-lite.test.tsscript7.9 KB
scripts/html-markup.mjsscript7.0 KB
scripts/html-text-map.mjsscript4.8 KB
scripts/html-text-map.test.tsscript15.2 KB
scripts/layout-probe.mjsscript4.6 KB
scripts/layout-probe.test.tsscript4.2 KB
scripts/lexicon.mjsscript2.6 KB
scripts/lexicon.test.tsscript3.2 KB
scripts/markdown-closers.mjsscript4.9 KB
scripts/md-lite-boundaries.test.tsscript2.2 KB
scripts/md-lite.mjsscript7.8 KB
scripts/md-lite.test.tsscript10.3 KB
scripts/meaning-check.mjsscript9.7 KB
scripts/meaning-check.test.tsscript12.0 KB
scripts/number-grammar.mjsscript2.1 KB
scripts/number-grammar.test.tsscript1.8 KB
scripts/numerals.mjsscript12.0 KB
scripts/numerals.test.tsscript6.1 KB
scripts/outcome-start.mjsscript3.8 KB
scripts/outcome-start.test.tsscript5.0 KB
scripts/outcome.mjsscript10.5 KB
scripts/outcome.test.tsscript12.8 KB
scripts/page-source-locator.test.tsscript11.7 KB
scripts/particles-ko.mjsscript4.8 KB
scripts/particles-ko.test.tsscript4.3 KB
scripts/placeholder.mjsscript9.3 KB
scripts/placeholder.test.tsscript3.8 KB
scripts/polish-apply.mjsscript6.8 KB
scripts/polish-apply.test.tsscript19.7 KB
scripts/polish-diff.mjsscript1.7 KB
scripts/polish-diff.test.tsscript10.1 KB
scripts/polish-markup.test.tsscript14.0 KB
scripts/polish-partial.test.tsscript2.5 KB
scripts/polish-project.mjsscript5.8 KB
scripts/polish-rules.mjsscript9.8 KB
scripts/rational.mjsscript5.2 KB
scripts/rational.test.tsscript1.9 KB
scripts/raw-decode.mjsscript4.5 KB
scripts/raw-locator.mjsscript2.4 KB
scripts/raw-snapshot.test.tsscript7.3 KB
scripts/references-fences.test.tsscript1.2 KB
scripts/repair-tracker.mjsscript7.5 KB
scripts/repair-tracker.test.tsscript10.8 KB
scripts/report-tools-2.test.tsscript16.1 KB
scripts/report-tools-3.test.tsscript9.3 KB
scripts/report-tools-4.test.tsscript10.1 KB
scripts/report-tools-5.test.tsscript14.6 KB
scripts/report-tools-commands.mjsscript12.9 KB
scripts/report-tools.mjsscript2.6 KB
scripts/report-tools.test.tsscript12.1 KB
scripts/sentence-split.mjsscript3.0 KB
scripts/sentence-split.test.tsscript4.5 KB
scripts/snapshot-readability.test.tsscript7.0 KB
scripts/source-commands.mjsscript12.4 KB
scripts/source-integrity.test.tsscript18.1 KB
scripts/source-refresh.mjsscript5.2 KB
scripts/source-snapshot.mjsscript9.9 KB
scripts/source-snapshot.test.tsscript6.3 KB
scripts/source-view.mjsscript5.0 KB
scripts/sources-citation.mjsscript12.1 KB
scripts/sources-citation.test.tsscript14.8 KB
scripts/tests/contracts-support.tsscript3.5 KB
scripts/tests/delivery-barrier-session.tsscript3.3 KB
scripts/tests/derive-clock.tsscript341 B
scripts/tests/fact-derive-support.tsscript1.9 KB
scripts/tests/fact-unit-dimensions-support.tsscript1.5 KB
scripts/tests/fact-unit-rules-support.tsscript16.8 KB
scripts/tests/fidelity-values-support.tsscript1.6 KB
scripts/tests/fixtures/assets/figure-1.svgother141 B
scripts/tests/fixtures/bad-report.htmlother2.1 KB
scripts/tests/fixtures/boxes.jsonconfig3.2 KB
scripts/tests/fixtures/conversion-probe.htmlother485 B
scripts/tests/fixtures/design-spec.mdmarkdown458 B
scripts/tests/fixtures/fidelity-brief-locked.mdmarkdown571 B
scripts/tests/fixtures/fidelity-brief-pending.mdmarkdown574 B
scripts/tests/fixtures/fidelity/assets/share.csvother40 B
scripts/tests/fixtures/fidelity/claim-graph.mdmarkdown449 B
scripts/tests/fixtures/fidelity/gen-legacy-dev.mjsscript5.0 KB
scripts/tests/fixtures/fidelity/ledger-basic.jsonconfig5.1 KB
scripts/tests/fixtures/fidelity/ledger-legacy-dev.jsonconfig18.3 KB
scripts/tests/fixtures/fidelity/ledger-verify.jsonconfig9.1 KB
scripts/tests/fixtures/fidelity/polish-edits.jsonconfig303 B
scripts/tests/fixtures/fidelity/report-bad.htmlother821 B
scripts/tests/fixtures/fidelity/report-good.htmlother2.4 KB
scripts/tests/fixtures/fidelity/sources/S4.htmlother680 B
scripts/tests/fixtures/fidelity/sources/S4/acronyms.jsonconfig36 B
scripts/tests/fixtures/fidelity/sources/S4/meta.jsonconfig256 B
scripts/tests/fixtures/fidelity/sources/S4/sentences.jsonlother623 B
scripts/tests/fixtures/fidelity/sources/S4/text.txtmarkdown300 B
scripts/tests/fixtures/fidelity/sources/S5/acronyms.jsonconfig3 B
scripts/tests/fixtures/fidelity/sources/S5/meta.jsonconfig235 B
scripts/tests/fixtures/fidelity/sources/S5/sentences.jsonlother53 B
scripts/tests/fixtures/fidelity/sources/S5/text.txtmarkdown10 B
scripts/tests/fixtures/fidelity/sources/S9.txtmarkdown128 B
scripts/tests/fixtures/good-report.htmlother2.7 KB
scripts/tests/fixtures/reference-report.htmlother2.5 KB

scripts/source-commands.mjs

View on GitHub
// source-commands.mjs - the `source snapshot`, `source refresh` and `claims index` subcommands of
// report-tools. A source dir is immutable: the same id with identical bytes is a no-op, different
// bytes fail (exit 1, snapshot_exists), because ledger rows pin the old hash; `source refresh`
// (source-refresh.mjs) is the one explicit repin. `--replace` swaps in a corrected capture under the
// same id (the conversion_altered_number recovery) only while no active ledger row cites the id
// (exit 1, snapshot_pinned, listing them). `--url` fetches with plain fetch (30 s timeout,
// no browser) and records extractor tool:source-snapshot@1; `--html` imports a browser-lane page
// capture and `--raw` alone a saved file's bytes (extractor model). `--text` alone registers a converted-only source (no raw bytes:
// quotes only); `--raw <bytes> --text <extraction> --extractor NAME@VERSION` keeps the original
// bytes and declares the text their extraction. `--command` runs an argv without a shell and
// snapshots its stdout, with the argv, cwd, exit status, and output hashes in command.json.
// node: builtins and sibling imports only.

import { spawnSync } from "node:child_process"
import { existsSync, readFileSync, writeFileSync } from "node:fs"
import { join, resolve } from "node:path"

import { indexClaims } from "./claims-index.mjs"
import { CliError, parseArgs, sha256Of, writeJsonAtomic } from "./cli-support.mjs"
import { runConversionProbe } from "./conversion-probe.mjs"
import { readLedger } from "./fact-ledger.mjs"
import { parseFidelityBlock } from "./fidelity-brief.mjs"
import { parseSourceFloor } from "./fidelity-policy.mjs"
import { encodingOf, headerCharset } from "./raw-decode.mjs"
import { writeSnapshot } from "./source-snapshot.mjs"
import { readSnapshot } from "./source-view.mjs"

const FETCH_TIMEOUT_MS = 30_000
const TOOL_EXTRACTOR = "tool:source-snapshot@1"
export const SNAPSHOT_USAGE =
  "usage: source probe-conversion <raw-file> <converted-file> | source snapshot --id S<n> (--url <u> | --html <file> | --raw <file> [--text <file> --extractor NAME@VERSION] | --text <file> (converted-only) | --command '<argv json>' --cwd DIR) [--charset NAME] [--kind page|command|document|converted-only] [--provenance primary|secondary] [--revision R] [--replace] --session-dir D"

function readInput(path) {
  try {
    return readFileSync(path, "utf8")
  } catch (error) {
    throw new CliError(`cannot read ${path}: ${error.code ?? error.message}`)
  }
}

/** The session dir from --session-dir or SESSION_DIR; a usage error when neither is set. */
export function sessionDirOf(flags) {
  const dir = flags["session-dir"] ?? process.env.SESSION_DIR
  if (!dir || dir === true) throw new CliError("--session-dir is required (or set SESSION_DIR)")
  return resolve(dir)
}

/** The snapshot as source-view.mjs reads it ({ meta, raw, sha256, drift, view }); unreadable is a usage error. */
export function snapshotOf(sessionDir, id) {
  const dir = join(sessionDir, "sources", String(id))
  if (!existsSync(join(dir, "meta.json")))
    throw new CliError(`source ${id} has no snapshot; run source snapshot --id ${id} first`)
  try {
    return readSnapshot(dir)
  } catch (error) {
    throw new CliError(`source ${id}: ${error.message}`)
  }
}

/**
 * Whether the brief's source floor lists this source as pointed at (`pointed only: a, b`). An absent
 * or pending floor points at nothing; a malformed floor is a usage error (parseSourceFloor's CliError).
 */
export function pointedFlag(sessionDir, url) {
  const brief = join(sessionDir, "brief.md")
  const floor = existsSync(brief) ? (parseFidelityBlock(readInput(brief)).fields?.["source floor"] ?? "") : ""
  if (floor === "" || floor === "pending") return false
  const rule = parseSourceFloor(floor)
  return rule?.kind === "pointed" && rule.list.includes(url)
}

async function fetchSource(url) {
  if (!URL.canParse(url)) throw new CliError(`--url is not a URL: ${url}`)
  let response
  try {
    response = await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) })
  } catch (error) {
    throw new CliError(`fetch failed for ${url}: ${error.message}`)
  }
  if (!response.ok) {
    await response.body?.cancel()
    throw new CliError(`fetch failed: HTTP ${response.status} for ${url}`)
  }
  const type = response.headers.get("content-type") ?? ""
  if (/pdf/i.test(type)) {
    await response.body?.cancel()
    throw new CliError(
      `pdf response: ${url}; save the bytes and use --raw <file.pdf> --text <extracted.txt> --extractor NAME@VERSION`,
    )
  }
  const raw = Buffer.from(await response.arrayBuffer())
  return {
    url,
    raw,
    charset: headerCharset(type),
    markup: /html|xml/i.test(type) || /^\s*</.test(raw.subarray(0, 1024).toString("latin1")),
  }
}

function runCommand(argvJson, cwd) {
  let argv
  try {
    argv = JSON.parse(argvJson)
  } catch (error) {
    throw new CliError(`--command must be a JSON array of strings: ${error.message}`)
  }
  if (!Array.isArray(argv) || argv.length === 0 || !argv.every((part) => typeof part === "string" && part.length > 0)) {
    throw new CliError("--command must be a non-empty JSON array of non-empty strings")
  }
  if (!cwd || cwd === true) throw new CliError("--command needs --cwd DIR")
  const proc = spawnSync(argv[0], argv.slice(1), { cwd: resolve(cwd), shell: false, maxBuffer: 64 * 1024 * 1024 })
  if (proc.error) throw new CliError(`--command could not start: ${proc.error.message}`)
  const receipt = {
    argv,
    cwd: resolve(cwd),
    exit_status: proc.status,
    stdout_sha256: sha256Of(proc.stdout),
    stderr_sha256: sha256Of(proc.stderr),
  }
  return { path: `command:${argv.join(" ")}`, raw: proc.stdout, kind: "command", receipt }
}

function readBytes(path) {
  try {
    return readFileSync(path)
  } catch (error) {
    throw new CliError(`cannot read ${path}: ${error.code ?? error.message}`)
  }
}

/** The snapshot input the flags describe; shared by `source snapshot` and `source refresh`. */
export async function acquire(flags) {
  const given = ["url", "html", "text", "command"].filter((name) => flags[name] !== undefined)
  if (flags.raw !== undefined && given.some((name) => name !== "text"))
    throw new CliError("--raw goes alone or with --text (--url, --html and --command already keep the raw bytes)")
  if (given.length + (flags.raw !== undefined && flags.text === undefined ? 1 : 0) !== 1)
    throw new CliError(SNAPSHOT_USAGE)
  if (flags.extractor !== undefined && flags.text === undefined) throw new CliError("--extractor goes with --text only")
  if (flags.charset !== undefined && encodingOf(flags.charset) === null)
    throw new CliError(`--charset ${flags.charset} is not a known encoding`)
  const charset = flags.charset === undefined ? {} : { charset: encodingOf(flags.charset) }
  if (flags.url !== undefined) return { ...(await fetchSource(flags.url)), ...charset, extractor: TOOL_EXTRACTOR }
  if (flags.html !== undefined)
    return { path: resolve(flags.html), raw: readBytes(flags.html), markup: true, ...charset, extractor: "model" }
  if (flags.raw !== undefined && flags.text === undefined)
    return { path: resolve(flags.raw), raw: readBytes(flags.raw), ...charset, extractor: "model" }
  if (flags.text !== undefined) {
    const extractor = flags.extractor === undefined ? "model" : `extractor:${flags.extractor}`
    if (flags.raw !== undefined)
      return { path: resolve(flags.raw), raw: readBytes(flags.raw), text: readInput(flags.text), ...charset, extractor }
    if (flags.kind !== undefined && flags.kind !== "converted-only")
      throw new CliError(
        "--text without --raw registers a converted-only source; pass --raw <original bytes> to keep a measurable snapshot",
      )
    return { path: resolve(flags.text), text: readInput(flags.text), kind: "converted-only", extractor }
  }
  return { ...runCommand(flags.command, flags.cwd), extractor: TOOL_EXTRACTOR }
}

/**
 * `--replace` with `--text` alone (the conversion_altered_number recovery) keeps the source's raw.bin and
 * declares the verified text its extraction, so value rows locate in text.txt while the original bytes stay
 * pinned; plain `--text` without `--replace`, or over an id with no raw.bin, stays converted-only.
 */
function declareOverKeptRaw(sourcesDir, id, input) {
  const dir = join(sourcesDir, String(id))
  if (input.kind !== "converted-only" || !existsSync(join(dir, "raw.bin")) || !existsSync(join(dir, "meta.json")))
    return
  const before = JSON.parse(readFileSync(join(dir, "meta.json"), "utf8"))
  const raw = readFileSync(join(dir, "raw.bin"))
  if (sha256Of(raw) !== before.sha256)
    throw new CliError(`snapshot_hash_mismatch: ${id} raw.bin no longer matches its pinned hash`)
  Object.assign(input, { url: before.url, raw, kind: before.kind, observed_at: before.observed_at, declared: true })
  delete input.path
}

export async function runSource(argv) {
  const [sub, ...rest] = argv
  if (sub === "refresh") return (await import("./source-refresh.mjs")).runRefresh(rest)
  if (sub === "probe-conversion") return runConversionProbe(rest)
  if (sub !== "snapshot") throw new CliError(SNAPSHOT_USAGE)
  const args = parseArgs(rest, { booleans: ["replace"] })
  const id = args.required("id")
  const sessionDir = sessionDirOf(args.flags)
  const sourcesDir = join(sessionDir, "sources")
  const replace = args.flags.replace === true
  const pinned = replace
    ? readLedger(sessionDir)
        .rows.filter((row) => row.source_id === id && (row.status ?? "active") === "active")
        .map((row) => row.fact_id)
    : []
  if (pinned.length > 0) {
    const message = `${id} is cited by active row(s) ${pinned.join(", ")}; retract them first, or snapshot the corrected text under a new id`
    return {
      json: {
        command: "source snapshot",
        status: "fail",
        exitCode: 1,
        error: "snapshot_pinned",
        message,
        rows: pinned,
      },
      summary: `source snapshot: ${message}`,
      exitCode: 1,
    }
  }
  const { receipt, ...input } = await acquire(args.flags)
  if (replace) declareOverKeptRaw(sourcesDir, id, input)
  if (args.flags.kind !== undefined) input.kind = args.flags.kind
  if (args.flags.provenance !== undefined) input.provenance = args.flags.provenance
  if (args.flags.revision !== undefined) input.revision = args.flags.revision
  let written
  try {
    written = writeSnapshot(sourcesDir, id, input, { replace })
  } catch (error) {
    if (String(error.message).startsWith("snapshot_exists")) {
      return {
        json: {
          command: "source snapshot",
          status: "fail",
          exitCode: 1,
          error: "snapshot_exists",
          message: error.message,
        },
        summary: `source snapshot: ${error.message}`,
        exitCode: 1,
      }
    }
    if (error instanceof TypeError) throw new CliError(error.message)
    throw error
  }
  if (receipt) writeFileSync(join(written.dir, "command.json"), `${JSON.stringify(receipt, null, 2)}\n`)
  const meta = JSON.parse(readFileSync(join(written.dir, "meta.json"), "utf8"))
  const data = {
    source_id: id,
    directory: written.dir,
    snapshot_sha256: written.sha256,
    extractor: meta.extractor,
    kind: meta.kind,
    provenance: meta.provenance,
    text_source: meta.text_source,
    ...(written.altered ? { conversion_altered_numbers: written.altered } : {}),
  }
  const probe = written.altered
    ? `; conversion ${written.altered.length} altered${written.altered.length ? ` (${written.altered.join(", ")}): fact add refuses those numbers` : ""}`
    : ""
  return {
    json: { command: "source snapshot", status: "pass", exitCode: 0, data },
    summary: `source snapshot: ${id} ${written.sha256.slice(0, 12)} (${meta.extractor}, ${meta.text_source})${probe}`,
    exitCode: 0,
  }
}

export function runClaims(argv) {
  const [sub, ...rest] = argv
  const args = parseArgs(rest)
  const [graph] = args.positionals
  if (sub !== "index" || !graph) throw new CliError("usage: claims index <claim-graph.md> --out claims.json")
  const out = args.required("out")
  const index = indexClaims(readInput(graph))
  if (index.errors.length > 0) throw new CliError(`claims index ${graph}: ${index.errors.join("; ")}`)
  writeJsonAtomic(out, {
    schemaVersion: 1,
    graph: resolve(graph),
    graph_sha256: sha256Of(readFileSync(graph)),
    ...index,
  })
  const verified = index.claims.filter((claim) => claim.in_verified).length
  return {
    json: { command: "claims index", out: resolve(out), claims: index.claims.length, verified },
    summary: `claims index: ${index.claims.length} claim(s), ${verified} verified`,
    exitCode: 0,
  }
}
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall