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/md-lite.mjs

View on GitHub
// md-lite.mjs - a light Markdown block model for md/post deliverables.
//
// parseMarkdown(text) returns { blocks } in document order, each block one of heading,
// paragraph, list_item, table_row, code, blockquote, with start/end offsets into the raw text
// so text.slice(start, end) === block.text (table cells carry their own offsets). Headings carry
// level 1-6. Code blocks are fenced (``` or ~~~); an unterminated fence runs to the end of the
// text and is reported in problems as unterminated_fence, which a caller must refuse rather than
// skip. Callers skip kind 'code' when they look for numbers. sectionKindsMd(blocks) classifies
// sections with the gates-static classifier itself (sectionKind, closingTest). It never renders
// HTML. Plain Node ESM, sibling imports only.

import { closingTest, sectionKind } from "./gates-static.mjs"

export { closingTest, sectionKind }

/** A fence opener: a backtick fence's info string holds no backtick (else it is an inline span). */
const FENCE = /^ {0,3}(?:(`{3,})[^`]*|(~{3,}).*)$/
const HEADING = /^ {0,3}(#{1,6})(?=[ \t]|$)/
const BLOCKQUOTE = /^ {0,3}> ?/
/** A bullet or an ordered marker (digits, then . or ), then a space); group 1 is the number. */
const LIST_ITEM = /^[ \t]*(?:[-*+]|(\d{1,9})[.)])[ \t]+/
const TABLE_SEPARATOR = /^[ \t]*\|?[ \t]*:?-+:?[ \t]*(?:\|[ \t]*:?-+:?[ \t]*)*\|?[ \t]*$/
const CLOSING_HASHES = /[ \t]+#+[ \t]*$|^#+[ \t]*$/
const THEMATIC_BREAK = /^ {0,3}([-*_])(?:[ \t]*\1){2,}[ \t]*$/

/** The Markdown block grammar, one named pattern per syntax. */
export const MD_BLOCK_PATTERNS = Object.freeze({
  FENCE,
  HEADING,
  BLOCKQUOTE,
  LIST_ITEM,
  TABLE_SEPARATOR,
  CLOSING_HASHES,
  THEMATIC_BREAK,
})

/** Split into lines with offsets; end excludes the newline and a trailing carriage return. */
function linesOf(text) {
  const lines = []
  let start = 0
  while (start <= text.length) {
    const newline = text.indexOf("\n", start)
    const next = newline === -1 ? text.length + 1 : newline + 1
    let end = newline === -1 ? text.length : newline
    if (end > start && text[end - 1] === "\r") end--
    lines.push({ start, end, next, raw: text.slice(start, end) })
    start = next
  }
  return lines
}

/** Narrow [start, end) to its non-whitespace core. */
function trimRange(text, start, end) {
  let from = start
  let to = end
  while (from < to && /\s/.test(text[from])) from++
  while (to > from && /\s/.test(text[to - 1])) to--
  return { start: from, end: to }
}

function block(text, kind, range, extra = {}) {
  return { kind, ...extra, text: text.slice(range.start, range.end), start: range.start, end: range.end }
}

function isSeparator(line) {
  return line !== undefined && line.raw.includes("-") && TABLE_SEPARATOR.test(line.raw)
}

/** Cells split on unescaped pipes, outer pipes dropped, each cell trimmed with offsets. */
function tableCells(text, range) {
  const bounds = []
  for (let k = range.start; k < range.end; k++) {
    let slashes = 0
    while (k - slashes - 1 >= range.start && text[k - slashes - 1] === "\\") slashes++
    if (text[k] === "|" && slashes % 2 === 0) bounds.push(k)
  }
  const edges = [range.start - 1, ...bounds, range.end]
  if (bounds[0] === range.start) edges.shift()
  if (bounds.at(-1) === range.end - 1 && bounds.length > 0) edges.pop()
  const cells = []
  for (let k = 0; k + 1 < edges.length; k++) {
    const cell = trimRange(text, edges[k] + 1, edges[k + 1])
    cells.push({ text: text.slice(cell.start, cell.end), start: cell.start, end: cell.end })
  }
  return cells
}

function headingBlock(text, line, marker) {
  const after = line.start + line.raw.indexOf(marker) + marker.length
  const range = trimRange(text, after, line.end)
  const closing = text.slice(range.start, range.end).match(CLOSING_HASHES)
  if (closing) range.end = trimRange(text, range.start, range.start + (closing.index ?? 0)).end
  return block(text, "heading", range, { level: marker.length })
}

/**
 * Parse Markdown into a flat block list.
 * @param {string} text
 * @returns {{ blocks: { kind: string, level?: number, text: string, start: number, end: number,
 *   cells?: { text: string, start: number, end: number }[] }[],
 *   problems: { code: "unterminated_fence", line: number, start: number }[] }}
 */
export function parseMarkdown(text) {
  const source = String(text ?? "")
  const lines = linesOf(source)
  const blocks = []
  const problems = []
  let paragraph = null
  let inTable = false
  const flush = () => {
    if (paragraph) blocks.push(block(source, "paragraph", paragraph))
    paragraph = null
  }
  for (let i = 0; i < lines.length; i++) {
    const line = lines[i]
    const fence = line.raw.match(FENCE)
    if (fence) {
      flush()
      inTable = false
      const open = fence[1] ?? fence[2]
      const codeStart = Math.min(line.next, source.length)
      let close = lines.length
      for (let k = i + 1; k < lines.length; k++) {
        const candidate = lines[k].raw.replace(/^ {0,3}/, "").trimEnd()
        if (candidate.startsWith(open[0].repeat(open.length)) && /^(`+|~+)$/.test(candidate)) {
          close = k
          break
        }
      }
      let codeEnd = source.length
      if (close === lines.length) problems.push({ code: "unterminated_fence", line: i + 1, start: line.start })
      else {
        codeEnd = Math.max(codeStart, lines[close].start - 1)
        if (codeEnd > codeStart && source[codeEnd - 1] === "\r") codeEnd--
      }
      blocks.push(block(source, "code", { start: codeStart, end: codeEnd }))
      i = close
      continue
    }
    if (line.raw.trim() === "") {
      flush()
      inTable = false
      continue
    }
    const range = trimRange(source, line.start, line.end)
    if (!inTable && line.raw.includes("|") && isSeparator(lines[i + 1])) inTable = true
    if (inTable && line.raw.includes("|")) {
      flush()
      if (!isSeparator(line)) blocks.push(block(source, "table_row", range, { cells: tableCells(source, range) }))
      continue
    }
    inTable = false
    const heading = line.raw.match(HEADING)
    if (heading) {
      flush()
      blocks.push(headingBlock(source, line, heading[1]))
      continue
    }
    if (THEMATIC_BREAK.test(line.raw)) {
      flush()
      continue
    }
    const marker = line.raw.match(BLOCKQUOTE) ?? line.raw.match(LIST_ITEM)
    // Only an ordered marker numbered 1 may interrupt a paragraph (CommonMark); else it is text.
    const continues = paragraph !== null && marker?.[1] !== undefined && Number(marker[1]) !== 1
    if (marker && !continues) {
      flush()
      const kind = BLOCKQUOTE.test(line.raw) ? "blockquote" : "list_item"
      const content = trimRange(source, line.start + marker[0].length, line.end)
      if (content.end > content.start) blocks.push(block(source, kind, content))
      continue
    }
    if (paragraph) paragraph.end = range.end
    else paragraph = { start: range.start, end: range.end }
  }
  flush()
  return { blocks, problems }
}

/**
 * Section kind of every block, parallel to blocks: an h2 opens a section whose kind comes from
 * its heading text (sources, closing, toc, appendix, glossary, or null for findings); an h3 that
 * reads as a closing heading marks its blocks closing until the next h2 or h3, as in gates-static.
 * @param {{ kind: string, level?: number, text: string }[]} blocks
 * @param {{ closingPattern?: RegExp|string }} [options] extra closing heading pattern (the spec's)
 * @returns {(string|null)[]}
 */
export function sectionKindsMd(blocks, options = {}) {
  const isClosing = closingTest(options.closingPattern)
  let section = null
  let closingH3 = false
  return blocks.map((entry) => {
    if (entry.kind === "heading" && entry.level === 2) {
      section = sectionKind(entry.text, isClosing)
      closingH3 = false
    } else if (entry.kind === "heading" && entry.level === 3) {
      closingH3 = isClosing(entry.text)
    }
    return closingH3 ? "closing" : section
  })
}
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