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.mjs

View on GitHub
// html-lite.mjs - a dependency-free HTML tokenizer for report checks.
//
// Single forward scan with indexOf (no whole-document regex, no backtracking). Produces a
// LiteNode tree: { tag, attrs, children, parent, line, text, raw }. Text nodes carry
// tag "#text"; <style>/<script>/<svg> keep their inner source in `raw` and have no parsed
// children, except an <svg> node also gains its <foreignObject> subtrees as parsed children
// (see html-foreign-object.mjs; the rest of the svg stays raw). The "#document"
// root also carries `ids` (id -> occurrence count) so selectorPath can tell whether an id
// is unique. Plain Node ESM, no dependencies.

import { decodeEntities } from "./entities.mjs"
import { attachForeignObjects } from "./html-foreign-object.mjs"

export { decodeEntities }

const VOID_TAGS = new Set([
  "area",
  "base",
  "br",
  "col",
  "embed",
  "hr",
  "img",
  "input",
  "link",
  "meta",
  "param",
  "source",
  "track",
  "wbr",
])
const RAW_TAGS = new Set(["style", "script", "svg"])
const HEADINGS = ["h1", "h2", "h3", "h4", "h5", "h6"]
const P_CLOSERS = new Set([
  "address",
  "article",
  "blockquote",
  "details",
  "div",
  "dl",
  "fieldset",
  "figcaption",
  "figure",
  "footer",
  "form",
  "header",
  "hr",
  "main",
  "menu",
  "nav",
  "ol",
  "p",
  "pre",
  "section",
  "table",
  "ul",
  ...HEADINGS,
])
const P_SCOPE = new Set(["td", "th", "caption", "button", "body", "html"])
const LI_SCOPE = new Set(["ul", "ol", "menu", "body", "html"])
const PROSE_SKIP = new Set(["code", "pre", "kbd", "samp", "script", "style", "svg"])
const SAFE_ID = /^[A-Za-z_][\w-]*$/

export const PROSE_TAGS = new Set(["p", "li", ...HEADINGS, "td", "th", "figcaption", "blockquote", "dd", "dt"])
export const PROSE_BREAKS = new Set([...P_CLOSERS, ...PROSE_TAGS, "br", "tr"])

export function makeNode(tag, attrs, parent, line) {
  return { tag, attrs, children: [], parent, line, text: "", raw: null }
}

function lineStarts(source) {
  const starts = [0]
  for (let at = source.indexOf("\n"); at !== -1; at = source.indexOf("\n", at + 1)) starts.push(at + 1)
  return starts
}

function lineAt(starts, offset) {
  let lo = 0
  let hi = starts.length - 1
  while (lo < hi) {
    const mid = (lo + hi + 1) >> 1
    if (starts[mid] <= offset) lo = mid
    else hi = mid - 1
  }
  return lo + 1
}

const isSpace = (ch) => ch === " " || ch === "\n" || ch === "\t" || ch === "\r" || ch === "\f"
const isLetter = (ch) => (ch >= "a" && ch <= "z") || (ch >= "A" && ch <= "Z")

function skipSpaces(source, at) {
  while (at < source.length && isSpace(source[at])) at++
  return at
}

/** Read `<name attrs...>` starting just after `<`; the one attribute parser (any quoting). */
export function readTag(source, start) {
  const end = source.length
  let at = start
  while (at < end && !isSpace(source[at]) && source[at] !== ">" && source[at] !== "/") at++
  const name = source.slice(start, at).toLowerCase()
  const attrs = {}
  let selfClosing = false
  while (at < end) {
    const ch = source[at]
    if (isSpace(ch)) {
      at++
      continue
    }
    if (ch === ">") return { name, attrs, end: at + 1, selfClosing }
    selfClosing = ch === "/" && source[at + 1] === ">"
    if (ch === "/") {
      at++
      continue
    }
    let stop = at + 1
    while (stop < end && !isSpace(source[stop]) && source[stop] !== "/" && source[stop] !== ">" && source[stop] !== "=")
      stop++
    const key = source.slice(at, stop).toLowerCase()
    at = skipSpaces(source, stop)
    let value = ""
    if (source[at] === "=") {
      at = skipSpaces(source, at + 1)
      const quote = source[at]
      if (quote === '"' || quote === "'") {
        const close = source.indexOf(quote, at + 1)
        const valueEnd = close === -1 ? end : close
        value = source.slice(at + 1, valueEnd)
        at = valueEnd + 1
      } else {
        let valueEnd = at
        while (valueEnd < end && !isSpace(source[valueEnd]) && source[valueEnd] !== ">") valueEnd++
        value = source.slice(at, valueEnd)
        at = valueEnd
      }
    }
    if (key !== "__proto__" && !Object.hasOwn(attrs, key)) attrs[key] = decodeEntities(value)
  }
  return { name, attrs, end, selfClosing }
}

function tagNameAt(source, at, tag) {
  if (source.slice(at, at + tag.length).toLowerCase() !== tag) return false
  const next = source[at + tag.length] ?? ">"
  return isSpace(next) || next === ">" || next === "/"
}

/** Find the close of a raw element; nested <svg> is depth-counted. Returns [innerEnd, resumeAt]. */
function findRawClose(source, from, tag) {
  let depth = 0
  for (let lt = source.indexOf("<", from); lt !== -1; lt = source.indexOf("<", lt + 1)) {
    if (source[lt + 1] === "/" && tagNameAt(source, lt + 2, tag)) {
      if (depth === 0) {
        const gt = source.indexOf(">", lt)
        return [lt, gt === -1 ? source.length : gt + 1]
      }
      depth--
    } else if (tag === "svg" && tagNameAt(source, lt + 1, tag)) {
      depth++
    }
  }
  return [source.length, source.length]
}

/** Parse an HTML string into a LiteNode tree rooted at "#document"; never throws on malformed input. */
export function parseHtml(source) {
  const src = String(source)
  const starts = lineStarts(src)
  const root = makeNode("#document", {}, null, 1)
  root.ids = new Map()
  const stack = [root]
  let sawBody = false
  let textStart = 0
  let at = 0
  const top = () => stack[stack.length - 1]
  const flushText = (to) => {
    if (to > textStart) {
      const node = makeNode("#text", {}, top(), lineAt(starts, textStart))
      node.source_start = textStart
      node.source_end = to
      node.text = decodeEntities(src.slice(textStart, to))
      top().children.push(node)
    }
  }
  const closeWithin = (tag, scope) => {
    for (let k = stack.length - 1; k > 0; k--) {
      if (stack[k].tag === tag) {
        stack.length = k
        return
      }
      if (scope.has(stack[k].tag)) return
    }
  }
  while (at < src.length) {
    const lt = src.indexOf("<", at)
    if (lt === -1) break
    const next = src[lt + 1] ?? ""
    if (src.startsWith("<!--", lt)) {
      flushText(lt)
      const close = src.indexOf("-->", lt + 4)
      at = textStart = close === -1 ? src.length : close + 3
    } else if (next === "!" || next === "?") {
      flushText(lt)
      const close = src.indexOf(">", lt)
      at = textStart = close === -1 ? src.length : close + 1
    } else if (next === "/" && isLetter(src[lt + 2] ?? "")) {
      flushText(lt)
      const tag = readTag(src, lt + 2)
      if (tag.name !== "body" && tag.name !== "html") {
        for (let k = stack.length - 1; k > 0; k--) {
          if (stack[k].tag === tag.name) {
            stack[k].source_end = lt
            stack.length = k
            break
          }
        }
      }
      at = textStart = tag.end
    } else if (isLetter(next)) {
      flushText(lt)
      const tag = readTag(src, lt + 1)
      at = textStart = tag.end
      if ((tag.name === "html" || tag.name === "body" || tag.name === "head") && stack.some((n) => n.tag === tag.name))
        continue
      if (P_CLOSERS.has(tag.name)) closeWithin("p", P_SCOPE)
      if (tag.name === "li") closeWithin("li", LI_SCOPE)
      const node = makeNode(tag.name, tag.attrs, top(), lineAt(starts, lt))
      node.source_start = tag.end
      node.source_end = src.length
      top().children.push(node)
      if (tag.name === "body") sawBody = true
      if (tag.attrs.id) root.ids.set(tag.attrs.id, (root.ids.get(tag.attrs.id) ?? 0) + 1)
      if (RAW_TAGS.has(tag.name)) {
        node.raw = ""
        if (!tag.selfClosing) {
          const [innerEnd, resume] = findRawClose(src, tag.end, tag.name)
          node.raw = src.slice(tag.end, innerEnd)
          if (tag.name === "svg") attachForeignObjects(node, lineAt(starts, tag.end), parseHtml)
          at = textStart = resume
        }
      } else if (!VOID_TAGS.has(tag.name)) {
        stack.push(node)
      }
    } else {
      at = lt + 1
    }
  }
  flushText(src.length)
  if (!sawBody) wrapInBody(root)
  return root
}

/** Fragments without <body>: move everything except <head> under a synthesized body. */
function wrapInBody(root) {
  const host = root.children.find((child) => child.tag === "html") ?? root
  const kept = host.children.filter((child) => child.tag === "head")
  const moved = host.children.filter((child) => child.tag !== "head")
  const body = makeNode("body", {}, host, moved[0]?.line ?? 1)
  for (const child of moved) child.parent = body
  body.children = moved
  host.children = [...kept, body]
}

function segment(node) {
  const same = node.parent.children.filter((child) => child.tag === node.tag)
  return same.length > 1 ? `${node.tag}:nth-of-type(${same.indexOf(node) + 1})` : node.tag
}

/** CSS selector for a node: nearest unique-id anchor, else `body > tag:nth-of-type(k) > ...`. */
export function selectorPath(node) {
  let root = node
  while (root.parent) root = root.parent
  const ids = root.ids ?? new Map()
  const segments = []
  for (let cur = node.tag === "#text" ? node.parent : node; cur?.parent; cur = cur.parent) {
    const id = cur.attrs.id
    if (id && SAFE_ID.test(id) && ids.get(id) === 1) return [`#${id}`, ...segments].join(" > ")
    if (cur.tag === "body") return ["body", ...segments].join(" > ")
    if (cur.tag === "html") break
    segments.unshift(segment(cur))
  }
  return segments.join(" > ")
}

/** Descendant text minus code/pre/kbd/samp/script/style/svg, whitespace collapsed. */
export function proseText(node) {
  const parts = []
  const walk = (cur) => {
    if (cur.tag === "#text") {
      parts.push(cur.text)
      return
    }
    if (PROSE_SKIP.has(cur.tag)) return
    const breaks = PROSE_BREAKS.has(cur.tag)
    if (breaks) parts.push(" ")
    for (const child of cur.children) walk(child)
    if (breaks) parts.push(" ")
  }
  for (const child of node.children) walk(child)
  return parts.join("").replace(/\s+/g, " ").trim()
}
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