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

View on GitHub
import { describe, expect, test } from "bun:test"

import { decodeEntities, parseHtml, proseText, PROSE_TAGS, selectorPath } from "./html-lite.mjs"

type LiteNode = {
  tag: string
  attrs: Record<string, string>
  children: LiteNode[]
  parent: LiteNode | null
  line: number
  text: string
  raw: string | null
}

function elements(root: LiteNode): LiteNode[] {
  const out: LiteNode[] = []
  const stack = [...root.children].reverse()
  while (stack.length > 0) {
    const node = stack.pop() as LiteNode
    if (node.tag === "#text") continue
    out.push(node)
    for (let i = node.children.length - 1; i >= 0; i--) stack.push(node.children[i] as LiteNode)
  }
  return out
}

function byTag(root: LiteNode, tag: string): LiteNode[] {
  return elements(root).filter((node) => node.tag === tag)
}

function childTags(node: LiteNode): string[] {
  return node.children.filter((child) => child.tag !== "#text").map((child) => child.tag)
}

describe("selectorPath", () => {
  test("#given the 3rd p in the 2nd section under main #when a path is built #then it uses nth-of-type segments under body", () => {
    // given
    const doc = parseHtml(
      "<html><body><main><section><p>x</p></section><section><p>1</p><p>2</p><p>3</p></section></main></body></html>",
    )
    const third = byTag(doc, "p")[3] as LiteNode
    // when
    const path = selectorPath(third)
    // then
    expect(path).toBe("body > main > section:nth-of-type(2) > p:nth-of-type(3)")
  })

  test("#given an ancestor with a unique id #when a path is built #then it anchors at that id", () => {
    // given
    const doc = parseHtml('<body><main><section id="results"><p>1</p><p>2</p><p>3</p></section></main></body>')
    const third = byTag(doc, "p")[2] as LiteNode
    // when
    const path = selectorPath(third)
    // then
    expect(path).toBe("#results > p:nth-of-type(3)")
  })

  test("#given a duplicated id #when a path is built #then the id is not used as an anchor", () => {
    // given
    const doc = parseHtml('<body><div id="dup"><p>a</p></div><div id="dup"><p>b</p></div></body>')
    const second = byTag(doc, "p")[1] as LiteNode
    // when
    const path = selectorPath(second)
    // then
    expect(path).toBe("body > div:nth-of-type(2) > p")
  })
})

describe("parseHtml", () => {
  test("#given a p followed by an h2 #when parsed #then the p auto-closes and h2 is its sibling", () => {
    // given
    const source = "<body><p>a<h2>b</h2></body>"
    // when
    const doc = parseHtml(source)
    // then
    const body = byTag(doc, "body")[0] as LiteNode
    expect(childTags(body)).toEqual(["p", "h2"])
    expect((byTag(doc, "h2")[0] as LiteNode).parent).toBe(body)
  })

  test("#given consecutive li without close tags #when parsed #then each li is a sibling", () => {
    // given
    const source = "<body><ul><li>one<li>two<li>three</ul></body>"
    // when
    const doc = parseHtml(source)
    // then
    const list = byTag(doc, "ul")[0] as LiteNode
    expect(childTags(list)).toEqual(["li", "li", "li"])
  })

  test("#given an element on source line 7 #when parsed #then its line is 7", () => {
    // given
    const source = [
      "<html>",
      "<body>",
      "<main>",
      "<section>",
      "<p>one</p>",
      "<p>two</p>",
      '<p id="seven">x</p>',
      "</section>",
    ].join("\n")
    // when
    const doc = parseHtml(source)
    // then
    const seven = byTag(doc, "p").find((node) => node.attrs.id === "seven") as LiteNode
    expect(seven.line).toBe(7)
  })

  test("#given comments, void tags and an unmatched close tag #when parsed #then comments vanish, voids stay leaves, the stray close is ignored", () => {
    // given
    const source = "<body><!-- <p>hidden</p> --><div>a<br>b<img src=x.png></span> c</div></body>"
    // when
    const doc = parseHtml(source)
    // then
    expect(byTag(doc, "p")).toHaveLength(0)
    const div = byTag(doc, "div")[0] as LiteNode
    expect(childTags(div)).toEqual(["br", "img"])
    expect((byTag(doc, "br")[0] as LiteNode).children).toHaveLength(0)
    expect((byTag(doc, "img")[0] as LiteNode).attrs.src).toBe("x.png")
    expect(proseText(div)).toBe("a b c")
  })

  test("#given style, script and svg elements #when parsed #then their inner source is captured raw", () => {
    // given
    const source =
      '<head><style>p > a { color: red }</style></head><body><script>if (a < b) {}</script><svg viewBox="0 0 1 1"><svg><text>t</text></svg></svg><p>after</p></body>'
    // when
    const doc = parseHtml(source)
    // then
    expect((byTag(doc, "style")[0] as LiteNode).raw).toBe("p > a { color: red }")
    expect((byTag(doc, "script")[0] as LiteNode).raw).toBe("if (a < b) {}")
    const svg = byTag(doc, "svg")[0] as LiteNode
    expect(svg.raw).toBe("<svg><text>t</text></svg>")
    expect(svg.attrs.viewbox).toBe("0 0 1 1")
    expect(childTags(svg.parent as LiteNode)).toEqual(["script", "svg", "p"])
  })

  test("#given an svg with drawing markup and a foreignObject #when parsed #then raw is kept and only the foreignObject subtree is parsed", () => {
    // given
    const source =
      '<body><svg viewBox="0 0 200 100"><path d="M0 0"/><text>12%</text><foreignObject>\n<div>chart 110.6 mm</div>\n</foreignObject></svg></body>'
    // when
    const doc = parseHtml(source)
    // then
    const svg = byTag(doc, "svg")[0] as LiteNode
    expect(svg.raw).toBe('<path d="M0 0"/><text>12%</text><foreignObject>\n<div>chart 110.6 mm</div>\n</foreignObject>')
    expect(childTags(svg)).toEqual(["foreignobject"])
    const fo = byTag(doc, "foreignobject")[0] as LiteNode
    expect(fo.line).toBe(1)
    const div = byTag(doc, "div")[0] as LiteNode
    expect(div.line).toBe(2)
    expect(proseText(div)).toBe("chart 110.6 mm")
    expect(byTag(doc, "text")).toHaveLength(0)
    expect(byTag(doc, "path")).toHaveLength(0)
  })

  test("#given an unclosed fragment without body #when parsed #then the tree still has body > div > p", () => {
    // given
    const source = "<div><p>unclosed"
    // when
    const doc = parseHtml(source)
    // then
    const p = byTag(doc, "p")[0] as LiteNode
    expect(p.parent?.tag).toBe("div")
    expect(p.parent?.parent?.tag).toBe("body")
    expect(selectorPath(p)).toBe("body > div > p")
    expect(proseText(p)).toBe("unclosed")
  })

  test("#given attributes in every quoting style #when parsed #then values are decoded", () => {
    // given
    const source = `<body><a href="#s1" data-x='y &amp; z' hidden title=bare>k</a></body>`
    // when
    const doc = parseHtml(source)
    // then
    const anchor = byTag(doc, "a")[0] as LiteNode
    expect(anchor.attrs).toEqual({ href: "#s1", "data-x": "y & z", hidden: "", title: "bare" })
  })
})

describe("decodeEntities", () => {
  test("#given &mdash; #when decoded #then it is U+2014", () => {
    expect(decodeEntities("a&mdash;b")).toBe("a\u2014b")
  })

  test("#given named, decimal and hex entities #when decoded #then each maps to its code point", () => {
    // given
    const source = "&amp;&lt;&gt;&quot;&apos;&nbsp;&ndash;&hellip;&copy;&reg;&times;&middot;&#44;&#x1F600;"
    // when
    const decoded = decodeEntities(source)
    // then
    expect(decoded).toBe("&<>\"'\u00a0\u2013\u2026\u00a9\u00ae\u00d7\u00b7,\u{1F600}")
  })

  test("#given unknown or malformed entities #when decoded #then they are left verbatim", () => {
    expect(decodeEntities("&bogus; & &#xZZ; AT&T")).toBe("&bogus; & &#xZZ; AT&T")
  })
})

describe("proseText", () => {
  test("#given a paragraph with inline code #when prose is extracted #then code is skipped and whitespace collapsed", () => {
    // given
    const doc = parseHtml("<body><p>Run   <code>npm i</code>\n then <kbd>Enter</kbd> now</p></body>")
    const p = byTag(doc, "p")[0] as LiteNode
    // when
    const prose = proseText(p)
    // then
    expect(prose).toBe("Run then now")
  })

  test("#given PROSE_TAGS #when read #then it holds the prose-bearing tags", () => {
    expect([...PROSE_TAGS].sort()).toEqual(
      ["blockquote", "dd", "dt", "figcaption", "h1", "h2", "h3", "h4", "h5", "h6", "li", "p", "td", "th"].sort(),
    )
  })
})
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