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

View on GitHub
// placeholder.mjs - the fact pointer grammar of the fill step and its render helpers.
// Value pointers: {{F12:label}}, {{F12:label:value}}, {{F12:label:unit}}, {{F12:label:q}}.
// Claim prefixes from CLAIM_KINDS (V, D, A) precede any one pointer: {{D:F12:label:value}}, {{V:Q7:label:lead=18}}.
// Quote pointers: {{Q7:label}}, {{Q7:label:lead=18}}, {{Q7:label:from="x":to="y"}} (anchors are
// JSON strings, so they may hold a colon or an escaped quote). Labels are compared exactly by the
// caller; this module never guesses an id. Pure functions; node: builtins only.

import { parseNumeral } from "./numerals.mjs"
import { CLAIM_KINDS } from "./claim-kinds.mjs"

export const ELLIPSIS = "\u2026"

const ID = /^([FQ])[1-9]\d*$/
const LABEL = /^[^\s:{}"]+$/
const VALUE_MODES = new Set(["value", "unit", "q"])
const LEAD = /^lead=([1-9]\d*)$/
const LINEAGE = Object.freeze({ measured: "MEASURED", assumed: "ASSUMED", derived: "DERIVED", converted: "DERIVED" })

/** End index (exclusive) of a JSON string starting at `at`, or -1 when it is not closed on its line. */
function jsonStringEnd(text, at) {
  let i = at + 1
  while (i < text.length && text[i] !== '"' && text[i] !== "\n") i += text[i] === "\\" ? 2 : 1
  return text[i] === '"' ? i + 1 : -1
}

function readJsonString(text, at) {
  if (text[at] !== '"') return null
  const end = jsonStringEnd(text, at)
  if (end === -1) return null
  try {
    return { value: JSON.parse(text.slice(at, end)), end }
  } catch {
    return null
  }
}

function parseAnchors(tail) {
  if (!tail.startsWith("from=")) return null
  const from = readJsonString(tail, 5)
  if (from === null || !tail.startsWith(":to=", from.end)) return null
  const to = readJsonString(tail, from.end + 4)
  if (to === null || to.end !== tail.length || from.value === "" || to.value === "") return null
  return { from: from.value, to: to.value }
}

/** @returns the parsed pointer, or { error } for a malformed one. */
export function parsePlaceholder(token) {
  if (!token.startsWith("{{") || !token.endsWith("}}")) return { error: "a placeholder is {{ID:label...}}" }
  const body = token.slice(2, -2)
  const marked = Object.entries(CLAIM_KINDS).find(([, entry]) => entry.prefix && body.startsWith(`${entry.prefix}:`))
  if (marked) {
    const [claimKind, entry] = marked
    const parsed = parsePlaceholder(`{{${body.slice(entry.prefix.length + 1)}}}`)
    return parsed.error || parsed.claimKind
      ? { error: "a claim prefix must precede one fact or quote pointer" }
      : { ...parsed, claimKind }
  }
  const colon = body.indexOf(":")
  const id = colon === -1 ? body : body.slice(0, colon)
  const idMatch = ID.exec(id)
  if (idMatch === null) return { error: `"${id}" is not an F<n> or Q<n> id` }
  if (colon === -1) return { error: `${id} has no label; write {{${id}:label}}` }
  const rest = body.slice(colon + 1)
  const second = rest.indexOf(":")
  const label = second === -1 ? rest : rest.slice(0, second)
  if (!LABEL.test(label)) return { error: `"${label}" is not a label` }
  const tail = second === -1 ? null : rest.slice(second + 1)
  const base = { id, kind: idMatch[1], label }
  if (idMatch[1] === "F") {
    if (tail === null) return { ...base, mode: "full" }
    return VALUE_MODES.has(tail) ? { ...base, mode: tail } : { error: `"${tail}" is not a value mode (value, unit, q)` }
  }
  if (tail === null) return { ...base, mode: "full", selector: "full" }
  const lead = LEAD.exec(tail)
  if (lead !== null) return { ...base, mode: "lead", lead: Number(lead[1]), selector: `lead=${lead[1]}` }
  const anchors = parseAnchors(tail)
  if (anchors === null) return { error: `"${tail}" is not a quote selector (lead=N or from="..":to="..")` }
  return { ...base, mode: "span", ...anchors, selector: `from=${anchors.from};to=${anchors.to}` }
}

/** End index (exclusive) of the pointer opened at `at`, or -1 when it is not closed on its line. */
function placeholderEnd(text, at) {
  let i = at + 2
  while (i < text.length && text[i] !== "\n") {
    if (text[i] === '"') {
      const end = jsonStringEnd(text, i)
      if (end === -1) return -1
      i = end
    } else if (text.startsWith("}}", i)) return i + 2
    else i++
  }
  return -1
}

/** Every `{{...}}` pointer in source order: [{ token, start, end, parsed }]. */
export function findPlaceholders(text) {
  const found = []
  let at = text.indexOf("{{")
  while (at !== -1) {
    const end = placeholderEnd(text, at)
    if (end === -1) {
      found.push({
        token: text.slice(at, text.indexOf("\n", at) === -1 ? text.length : text.indexOf("\n", at)),
        start: at,
        end: at + 2,
        parsed: { error: "the placeholder is not closed on its line" },
      })
      at = text.indexOf("{{", at + 2)
      continue
    }
    const token = text.slice(at, end)
    found.push({ token, start: at, end, parsed: parsePlaceholder(token) })
    at = text.indexOf("{{", end)
  }
  return found
}

function occurrences(text, needle) {
  let count = 0
  for (let at = text.indexOf(needle); at !== -1; at = text.indexOf(needle, at + 1)) count++
  return count
}

function cut(quote, start, end) {
  return {
    text: `${start > 0 ? ELLIPSIS : ""}${quote.slice(start, end)}${end < quote.length ? ELLIPSIS : ""}`,
    start,
    end,
  }
}

/** The contiguous span from `from` through `to`; each anchor must occur exactly once, in order. */
export function subSpan(quote, from, to) {
  if (occurrences(quote, from) !== 1 || occurrences(quote, to) !== 1) return null
  const start = quote.indexOf(from)
  const toAt = quote.indexOf(to)
  if (toAt < start || toAt + to.length < start + from.length) return null
  return cut(quote, start, toAt + to.length)
}

/** The first `n` whitespace-delimited words, with an ellipsis when words were cut. */
export function lead(quote, n) {
  const words = [...quote.matchAll(/\S+/g)]
  if (words.length <= n) return { text: quote, start: 0, end: quote.length }
  const last = words[n - 1]
  return cut(quote, 0, last.index + last[0].length)
}

/** The value and unit parts of a row's raw text ("4.2 eok won" -> value "4.2 eok", unit "won"). */
export function valueParts(row) {
  const unitText = parseNumeral(row.raw)?.unitRaw ?? row.unit
  const valueText = unitText && row.raw.endsWith(unitText) ? row.raw.slice(0, -unitText.length).trimEnd() : row.raw
  return { valueText, unitText: unitText ?? "" }
}

/** The quote interval holding the row's qualifier and its raw quantity, or null if absent. */
export function qualifiedText(row) {
  if (row.qualifier === null) return row.raw
  for (let numeral = parseNumeral(row.quote); numeral !== null; numeral = parseNumeral(row.quote, numeral.span[1])) {
    if (numeral.raw !== row.raw || numeral.qualifierRaw === null) continue
    const [start, end] = numeral.span
    const before = row.quote.lastIndexOf(numeral.qualifierRaw, start)
    const between =
      before === -1
        ? []
        : row.quote
            .slice(before + numeral.qualifierRaw.length, start)
            .split(/\s+/u)
            .filter(Boolean)
    if (before !== -1 && between.length <= 1) return row.quote.slice(before, end)
    const after = row.quote.indexOf(numeral.qualifierRaw, end)
    if (after !== -1) return row.quote.slice(start, after + numeral.qualifierRaw.length)
  }
  return null
}

export function escapeHtml(text) {
  return String(text).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;")
}

/** The elements the renderers below emit as fact spans; recognizers build their patterns from this. */
export const FACT_ELEMENT_TAGS = Object.freeze(["data", "q", "blockquote"])

/** `mode` "value" marks a bare value whose unit verify checks beside it; `claimKind` is the claim mark. */
export function renderValueHtml(row, text, { mode = "full", claimKind = null } = {}) {
  const unit = row.unit === null ? "" : ` data-unit="${escapeHtml(row.unit)}"`
  const marker = mode === "value" ? ' data-fact-mode="value"' : ""
  const mark = claimKind === null ? "" : ` data-claim-kind="${escapeHtml(claimKind)}"`
  return `<data class="fact" value="${escapeHtml(row.value)}" data-fact="${row.fact_id}"${unit}${marker}${mark} data-lineage="${LINEAGE[row.kind]}">${escapeHtml(text)}</data>`
}

export function renderQuote(row, selector, text, format, claimKind = null) {
  const marker = `[${row.source_id}]`
  if (format === "md") return `"${text}" ${marker}`
  const mark = claimKind === null ? "" : ` data-claim-kind="${escapeHtml(claimKind)}"`
  return `<q data-fact="${row.fact_id}"${mark} data-quote-sel="${escapeHtml(selector)}">${escapeHtml(text)}</q> ${marker}`
}

const RENDERED_MD_QUOTE = /^"([\s\S]*)" (\[S\d+\])$/u

/** The quote text and source marker of bytes renderQuote wrote for md, or null for any other layout. */
export function parseRenderedQuote(body) {
  const match = RENDERED_MD_QUOTE.exec(body)
  return match ? { text: match[1], marker: match[2] } : null
}

/** The attributed block that replaces a twice-failed sentence; entity and valid_at stay outside the quote. */
export function renderBlockquote(row, key, format) {
  const attribution =
    row.entity === null ? "" : `, on ${row.entity}${row.valid_at === null ? "" : ` (${row.valid_at})`}`
  const footer = `[${row.source_id}]${attribution}`
  if (format === "md") return `> "${row.quote}"\n> ${footer}`
  return `<blockquote data-fact="${row.fact_id}" data-replaced="${escapeHtml(key)}">"${escapeHtml(row.quote)}" <footer>${escapeHtml(footer)}</footer></blockquote>`
}
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