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/contracts.test.ts

View on GitHub
import { describe, expect, test } from "bun:test"
import {
  ANSWERED_BY,
  DEFECT_CODES,
  DELIVERABLE_FORMATS,
  DELIVERABLE_STATUSES,
  DESIGN_SPEC_SECTIONS,
  FIDELITY_CODES,
  GATE_NAMES,
  GATE_STATUSES,
  INTEGRITY_CODES,
  LANES,
  LAYOUT_CODES,
  LINEAGE_MODES,
  MANIFEST_CODES,
  REPAIR_DEFAULTS,
  SCHEMA_VERSION,
  STATES,
  STATIC_CODES,
  normalizeManifest,
  validateOutcomeManifest,
  validateRepairState,
} from "./contracts.mjs"
import {
  SEVERITIES,
  STATIC_CODES_EXPECTED,
  LAYOUT_CODES_EXPECTED,
  FIDELITY_BLOCKERS,
  FIDELITY_MAJORS,
  FIDELITY_MINORS,
  FIDELITY_CODES_EXPECTED,
  fourGateManifest,
  sampleManifest,
} from "./tests/contracts-support"

describe("DEFECT_CODES", () => {
  test("#given the code table #when every code is inspected #then it has a severity, a hint, and an integrity flag", () => {
    expect(Object.keys(DEFECT_CODES).sort()).toEqual(
      [
        ...STATIC_CODES_EXPECTED,
        "missing_promised_deliverable",
        ...LAYOUT_CODES_EXPECTED,
        ...FIDELITY_CODES_EXPECTED,
        "conversion_altered_number",
        "unit_unbound",
      ].sort(),
    )
    for (const [code, entry] of Object.entries(DEFECT_CODES)) {
      expect(SEVERITIES.has(entry.severity), `${code} severity`).toBe(true)
      expect(typeof entry.hint).toBe("string")
      expect(entry.hint.length).toBeGreaterThan(10)
      expect(typeof entry.integrity).toBe("boolean")
    }
  })

  test("#given the code table #when integrity codes are derived #then they are exactly the blocker codes", () => {
    expect([...INTEGRITY_CODES].sort()).toEqual(
      [
        "broken_asset_reference",
        "missing_citation_section",
        "missing_closing_section",
        "missing_promised_deliverable",
        "missing_required_section",
        ...FIDELITY_BLOCKERS,
        "conversion_altered_number",
      ].sort(),
    )
    for (const code of INTEGRITY_CODES) expect(DEFECT_CODES[code].severity).toBe("blocker")
    for (const [code, entry] of Object.entries(DEFECT_CODES)) {
      if (entry.severity === "blocker") expect(INTEGRITY_CODES.has(code), `${code} must be integrity`).toBe(true)
    }
  })

  test("#given the frozen table #when a severity write is attempted #then it throws and the value is unchanged", () => {
    expect(Object.isFrozen(DEFECT_CODES)).toBe(true)
    expect(Object.isFrozen(DEFECT_CODES.korean_no_keep_all)).toBe(true)
    expect(() => {
      "use strict"
      DEFECT_CODES.korean_no_keep_all.severity = "minor"
    }).toThrow()
    expect(DEFECT_CODES.korean_no_keep_all.severity).toBe("major")
  })

  test("#given the fidelity codes #when inspected #then each carries its fixed severity and integrity flag", () => {
    for (const code of FIDELITY_BLOCKERS)
      expect([code, DEFECT_CODES[code]?.severity, DEFECT_CODES[code]?.integrity]).toEqual([code, "blocker", true])
    expect([
      DEFECT_CODES.conversion_altered_number?.severity,
      DEFECT_CODES.conversion_altered_number?.integrity,
    ]).toEqual(["blocker", true])
    for (const code of FIDELITY_MAJORS)
      expect([code, DEFECT_CODES[code]?.severity, DEFECT_CODES[code]?.integrity]).toEqual([code, "major", false])
    for (const code of FIDELITY_MINORS)
      expect([code, DEFECT_CODES[code]?.severity, DEFECT_CODES[code]?.integrity]).toEqual([code, "minor", false])
    expect([DEFECT_CODES.unit_unbound?.severity, DEFECT_CODES.unit_unbound?.integrity]).toEqual(["minor", false])
    expect(DEFECT_CODES).not.toHaveProperty("incompatible_populations")
  })
})

describe("code groups", () => {
  test("#given the code groups #when unioned #then they partition the code table exactly", () => {
    expect([...STATIC_CODES].sort()).toEqual(STATIC_CODES_EXPECTED.slice().sort())
    expect([...LAYOUT_CODES].sort()).toEqual(LAYOUT_CODES_EXPECTED.slice().sort())
    expect([...MANIFEST_CODES]).toEqual(["missing_promised_deliverable"])
    expect([...FIDELITY_CODES].sort()).toEqual(
      [...FIDELITY_CODES_EXPECTED, "conversion_altered_number", "unit_unbound"].sort(),
    )
    const union = [...STATIC_CODES, ...LAYOUT_CODES, ...MANIFEST_CODES, ...FIDELITY_CODES].sort()
    expect(union).toEqual(Object.keys(DEFECT_CODES).sort())
    expect(new Set(union).size).toBe(union.length)
    expect(Object.isFrozen(STATIC_CODES)).toBe(true)
    expect(Object.isFrozen(FIDELITY_CODES)).toBe(true)
  })
})

describe("enums", () => {
  test("#given the vocabulary #when read #then lanes, states, formats, statuses, gates, lineage modes are fixed lists", () => {
    expect(LANES).toEqual(["template-strict", "template-vibe", "no-format", "edit-existing"])
    expect(STATES).toEqual(["none", "partial", "complete"])
    expect(DELIVERABLE_FORMATS).toEqual(["pdf", "docx", "html", "md", "latex", "slides", "post"])
    expect(DELIVERABLE_STATUSES).toEqual(["pending", "delivered", "blocked_capability", "skipped", "failed"])
    expect(GATE_NAMES).toEqual(["static", "fidelity", "layout", "visual", "proofread"])
    expect(ANSWERED_BY).toEqual(["user", "default", "request", "pending"])
    expect(GATE_STATUSES).toEqual(["pass", "fail", "not_run"])
    expect(LINEAGE_MODES).toEqual(["inline", "section"])
    expect(DESIGN_SPEC_SECTIONS).toEqual([
      "Extracted from",
      "Tokens",
      "Typography",
      "Layout",
      "Structure",
      "Figures",
      "Citations",
      "Open questions",
    ])
    expect(REPAIR_DEFAULTS).toEqual({ maxAttempts: 3, plateauLimit: 2, wallClockMs: 900_000 })
    expect(Object.isFrozen(LANES)).toBe(true)
    expect(Object.isFrozen(REPAIR_DEFAULTS)).toBe(true)
  })
})

describe("validateOutcomeManifest", () => {
  test("#given an empty object #when validated #then it fails naming schemaVersion", () => {
    const result = validateOutcomeManifest({})
    expect(result.ok).toBe(false)
    expect(result.errors.some((e) => e.includes("schemaVersion"))).toBe(true)
  })

  test("#given a well-formed manifest #when validated #then it passes", () => {
    expect(validateOutcomeManifest(sampleManifest())).toEqual({ ok: true, errors: [] })
  })

  test("#given a deliverable with an unknown status #when validated #then the error names the row", () => {
    const m = sampleManifest()
    m.deliverables[0].status = "done"
    const result = validateOutcomeManifest(m)
    expect(result.ok).toBe(false)
    expect(result.errors.join("\n")).toMatch(/deliverables\[0\]\.status/)
  })

  test("#given a manifest written before the fidelity gate #when validated raw and after normalizeManifest #then only the normalized copy passes, with fidelity not_run", () => {
    const old = fourGateManifest()
    expect(validateOutcomeManifest(old).ok).toBe(false)
    const normalized = normalizeManifest(old)
    expect(normalized.gates.fidelity).toBe("not_run")
    expect(normalized.gates.static).toBe("not_run")
    expect(validateOutcomeManifest(normalized)).toEqual({ ok: true, errors: [] })
    expect(old.gates).not.toHaveProperty("fidelity")
    const failed = { ...old, gates: { ...old.gates, visual: "fail" } }
    expect(normalizeManifest(failed).gates.visual).toBe("fail")
  })

  test("#given a gate with an unknown value #when validated #then it fails", () => {
    const m = sampleManifest()
    m.gates.static = "ok"
    expect(validateOutcomeManifest(m).ok).toBe(false)
  })
})

describe("validateRepairState", () => {
  test("#given a well-formed state #when validated #then it passes, and a bad measure fails", () => {
    const good = {
      schemaVersion: SCHEMA_VERSION,
      startedAt: "2026-01-01T12:00:00.000Z",
      budget: { maxAttempts: 3, plateauLimit: 2, wallClockMs: 900_000 },
      attempts: [
        { at: "2026-01-01T12:01:00.000Z", measure: [1, 2, 0], signature: "em_dash_in_prose|unsourced_number" },
      ],
      consecutiveNonProgress: 0,
      seenSignatures: ["em_dash_in_prose|unsourced_number"],
    }
    expect(validateRepairState(good)).toEqual({ ok: true, errors: [] })
    const bad = { ...good, attempts: [{ at: "x", measure: [1, 2], signature: "" }] }
    expect(validateRepairState(bad).ok).toBe(false)
  })
})
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