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/polish-apply.mjs

View on GitHub
// polish-apply.mjs - checked, per-edit application of a proofread lane's polish edits.
//
// An edit whose before or after holds <, > or & is polish_edit_rejected (POLISH_MARKUP_REASON)
// before anything else, so no edit can create, alter, close or escape a tag, comment,
// bogus comment, CDATA section, entity or script, whatever the tokenizer models; a located region
// that overlaps a character reference or opens one (it starts inside `&name`) is rejected with
// POLISH_REFERENCE_REASON, so an edit can neither change nor complete an existing reference.
// Those two guards are the early, actionable refusals; the guarantee itself is the whole-document
// skeleton comparison (html-markup.skeletonChange) that polish-rules runs in both gates: every
// markup token and every character reference stays byte-identical, and an accepted edit's span
// holds no skeleton token, so any difference refuses the edit and reports polish_diff_fail.
// applyEdits(html, edits, ledger) applies each {before, after, reason} edit in edits-file order,
// against the output of the edits accepted before it. `before` must occur exactly once (runs of
// whitespace match any whitespace run) and must not cut through a fact span; otherwise the edit is
// polish_edit_unlocated. A located edit is applied whole or not at all: it is polish_edit_rejected
// when polish-rules.polishDefects(..., {ordered: true}) finds any defect between the current
// document and the document with the edit (per edit), or between the ORIGINAL input and the
// document with the edit (whole document: the baseline polish-diff uses). Ordered is stricter than
// polish-diff's multiset comparison and the last accepted candidate is the output, so a clean run
// is always polish-diff clean: no cross-edit case is left to the backstop. The rules see the
// text-node projection and freeze every markup byte, including script/style/template content.
// validatePolishEdits and POLISH_EDIT_FIELDS are the edit
// contract every caller (the CLI included) uses. No IO, no model. Plain Node ESM.

import { CHARACTER_REFERENCE } from "./html-markup.mjs"
import { factSpans } from "./polish-project.mjs"
import { polishDefects } from "./polish-rules.mjs"

export { numeralKeys, project, SLOT, termCounts, textOf } from "./polish-project.mjs"

/** The fields of one polish edit: before and after are required strings, reason an optional string. */
export const POLISH_EDIT_FIELDS = Object.freeze({ before: "required", after: "required", reason: "optional" })

/** Throws a TypeError naming the first edit that breaks POLISH_EDIT_FIELDS; returns the edits. */
export function validatePolishEdits(edits) {
  if (!Array.isArray(edits)) throw new TypeError("edits must be an array")
  edits.forEach((edit, index) => {
    if (edit === null || typeof edit !== "object" || Array.isArray(edit))
      throw new TypeError(`edit ${index} must be an object`)
    for (const [field, need] of Object.entries(POLISH_EDIT_FIELDS)) {
      if (need === "optional" && edit[field] === undefined) continue
      if (typeof edit[field] !== "string")
        throw new TypeError(`edit ${index} needs ${need === "optional" ? "a string" : "string"} ${field}`)
    }
  })
  return edits
}

/** Characters an edit's before and after may never contain. */
export const POLISH_MARKUP_CHARACTERS = /[<>&]/
/** The actionable rejection reason for an edit holding a markup character. */
export const POLISH_MARKUP_REASON =
  "edit contains markup characters (<, >, &): route this section through the full fidelity gates"
/** The actionable rejection reason for a located region touching a character reference. */
export const POLISH_REFERENCE_REASON =
  "edit touches a character reference: route this section through the full fidelity gates"

/** True when [start, end) overlaps a character reference of html or starts inside one. */
export function touchesReference(html, start, end) {
  for (const match of String(html).matchAll(CHARACTER_REFERENCE)) {
    const stop = match.index + match[0].length
    if (match.index < end && (stop > start || (stop === start && !match[0].endsWith(";")))) return true
  }
  return false
}

const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")

/** The single whitespace-normalized match of `before` in html as {start, end}, or {count} otherwise. */
function locate(html, before) {
  if (before.trim() === "") return { count: 0 }
  const pattern = new RegExp(before.split(/\s+/).map(escape).join("\\s+"), "g")
  const hits = [...html.matchAll(pattern)]
  return hits.length === 1
    ? { count: 1, start: hits[0].index, end: hits[0].index + hits[0][0].length }
    : { count: hits.length }
}

/** The id of a fact span the region [start, end) cuts through (overlaps without containing), or null. */
export function cutSpan(html, start, end) {
  return (
    factSpans(html).find((span) => span.start < end && span.end > start && !(start <= span.start && span.end <= end))
      ?.id ?? null
  )
}

/**
 * @param {string} html the filled report
 * @param {{ before: string, after: string, reason?: string }[]} edits in edits-file order
 * @param {{ rows: object[] }} ledger
 * @returns {{ out: string, applied: number[], rejected: { index: number, code: string, reason: string }[],
 *   unlocated: { index: number, code: string, reason: string }[] }}
 */
export function applyEdits(html, edits, ledger) {
  validatePolishEdits(edits)
  const original = String(html)
  const result = { out: original, applied: [], rejected: [], unlocated: [] }
  const defects = (candidate) => {
    const messages = [result.out, original].flatMap((base) =>
      polishDefects(base, candidate, ledger, { ordered: true }).map((d) => d.message),
    )
    return [...new Set(messages)]
  }
  edits.forEach((edit, index) => {
    const touches = POLISH_MARKUP_CHARACTERS.test(edit.before) || POLISH_MARKUP_CHARACTERS.test(edit.after)
    const where = locate(result.out, edit.before)
    if (where.count !== 1 && !touches) {
      result.unlocated.push({
        index,
        code: "polish_edit_unlocated",
        reason: `before matches ${where.count} times; it must match exactly once`,
      })
      return
    }
    const reasons = touches ? [POLISH_MARKUP_REASON] : []
    const candidate =
      where.count === 1 ? result.out.slice(0, where.start) + edit.after + result.out.slice(where.end) : result.out
    if (where.count === 1) {
      const cut = cutSpan(result.out, where.start, where.end)
      if (touchesReference(result.out, where.start, where.end)) reasons.push(POLISH_REFERENCE_REASON)
      reasons.push(...defects(candidate))
      if (cut !== null) reasons.push(`the edit cuts through fact span ${cut}`)
    }
    if (reasons.length > 0) {
      result.rejected.push({ index, code: "polish_edit_rejected", reason: reasons.join("; ") })
      return
    }
    result.out = candidate
    result.applied.push(index)
  })
  return result
}
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