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/gates-figures.mjs

View on GitHub
// gates-figures.mjs - visual gates: G2 palette, G8 chart without figure, G9 chart svg text,
// G10 Korean serif/brush fonts, G16 report without any visual, G17 image without alt text.
//
// Each gate is { codes, skip?(ctx), run(ctx) -> Defect[] } over the context built by
// gates-static.mjs. Plain Node ESM, sibling imports only.

import { fontFamilies, hexColors, normalizeHex, resolveVar } from "./css-lite.mjs"
import { decodeEntities, proseText } from "./html-lite.mjs"

const ALWAYS_ALLOWED = new Set(["#ffffff", "#000000"])
const MAX_PALETTE = 20
const SVG_PAINT =
  /(?:fill|stroke|stop-color|flood-color|lighting-color)\s*(?:=\s*["']?|:\s*)(#[0-9a-f]{3,8})(?![\w-])/gi
const SVG_FONT = /font-family\s*(?:=\s*("[^"]*"|'[^']*')|:\s*([^;"'>]+))/gi
const ICON_MAX = 32
const CHART_MIN = 200
const ICON_NAME = /icon|logo/i
const ICON_HOSTS = new Set(["a", "button", "nav", "header", "footer", "h1", "h2", "h3", "h4", "h5", "h6"])
const CAPTION_CLASS = /^(?:caption|fig-?cap(?:tion)?)$/
const DEFAULT_FONT_SIZE = 16
const MIN_TITLE_CHARS = 4
const MIN_TICKS = 3
const NUMERIC = /^[-+\u2212]?[$\u20AC\u00A3\u00A5\u20A9]?\d[\d,.:]*\s?(?:%|[a-z\uAC00-\uD7A3]{0,3})$/i
const SERIF_FAMILY =
  /nanummyeongjo|applemyungjo|gungsuh|batang|nanumbrush|nanumpen|\uAD81\uC11C|\uBC14\uD0D5|\uBA85\uC870/

function pixels(value) {
  const match = /^\s*(\d+(?:\.\d+)?)\s*(?:px)?\s*$/i.exec(value ?? "")
  return match ? Number(match[1]) : null
}

function fromStyle(node, prop) {
  return pixels(new RegExp(`(?:^|;)\\s*${prop}\\s*:\\s*([^;]+)`, "i").exec(node.attrs.style ?? "")?.[1])
}

function viewBoxSize(node) {
  const box = String(node.attrs.viewbox ?? "")
    .trim()
    .split(/[\s,]+/)
    .map(Number)
  return box.length === 4 && box.every(Number.isFinite) ? { width: box[2], height: box[3] } : null
}

/** Largest declared dimension: width/height attributes or style, else the viewBox. */
function declaredSize(node) {
  const sizes = [
    pixels(node.attrs.width),
    pixels(node.attrs.height),
    fromStyle(node, "width"),
    fromStyle(node, "height"),
  ].filter((n) => n !== null)
  if (sizes.length) return Math.max(...sizes)
  const box = viewBoxSize(node)
  return box ? Math.max(box.width, box.height) : null
}

/**
 * True when any declared dimension is zero, so the element cannot render visibly. Each axis reads its inline
 * style first, then its attribute, then the viewBox. An undeclared axis is not zero: the browser sizes it.
 */
function hasZeroDimension(node) {
  const box = viewBoxSize(node)
  return ["width", "height"].some(
    (axis) => (fromStyle(node, axis) ?? pixels(node.attrs[axis]) ?? box?.[axis] ?? null) === 0,
  )
}

function isIcon(ctx, node) {
  const size = declaredSize(node)
  if (size !== null && size <= ICON_MAX) return true
  if (ICON_NAME.test(`${node.attrs.class ?? ""} ${node.attrs.id ?? ""}`)) return true
  return Boolean(ctx.util.closest(node, (cur) => ICON_HOSTS.has(cur.tag)))
}

const isFigure = (ctx) => (cur) => cur.tag === "figure" || ctx.util.classTokens(cur).includes("fig")

function hasCaption(ctx, figure) {
  return ctx.util
    .descendants(figure)
    .some(
      (node) =>
        (node.tag === "figcaption" || ctx.util.classTokens(node).some((token) => CAPTION_CLASS.test(token))) &&
        proseText(node).length > 0,
    )
}

function visuals(ctx) {
  return ctx.elements
    .map(({ node }) => node)
    .filter((node) => (node.tag === "img" || node.tag === "svg") && !isIcon(ctx, node))
}

function label(node) {
  if (node.tag === "img") {
    const src = node.attrs.src ?? ""
    return `<img src="${src.length > 48 ? `${src.slice(0, 48)}...` : src}">`
  }
  return `<svg${node.attrs.width ? ` width="${node.attrs.width}"` : ""}${node.attrs.height ? ` height="${node.attrs.height}"` : ""}>`
}

function svgTexts(raw) {
  return [...raw.matchAll(/<text\b([^>]*)>([\s\S]*?)<\/text\s*>/gi)]
    .map((match) => ({
      size: Number(/font-size\s*(?:=\s*["']?|:\s*)(\d+(?:\.\d+)?)/i.exec(match[1])?.[1] ?? DEFAULT_FONT_SIZE),
      value: decodeEntities(match[2].replace(/<[^>]*>/g, ""))
        .replace(/\s+/g, " ")
        .trim(),
    }))
    .filter((text) => text.value)
}

function missingChartLabels(raw) {
  const texts = svgTexts(raw)
  const title = decodeEntities(/<title\b[^>]*>([\s\S]*?)<\/title\s*>/i.exec(raw)?.[1] ?? "").trim()
  if (!texts.length && !title) return null
  const maxSize = Math.max(0, ...texts.map((text) => text.size))
  const missing = []
  if (!title && !texts.some((text) => text.size === maxSize && [...text.value].length >= MIN_TITLE_CHARS))
    missing.push("title")
  const ticks = texts.filter((text) => NUMERIC.test(text.value)).length
  if (ticks < MIN_TICKS) missing.push(`numeric ticks (${ticks} < ${MIN_TICKS})`)
  if (!texts.some((text) => /\p{L}/u.test(text.value) && !NUMERIC.test(text.value))) missing.push("text label")
  return missing
}

const DECORATIVE_ROLE = /^(?:presentation|none)$/i

/** An image explicitly marked decorative: empty alt plus role=presentation|none or aria-hidden=true. */
function isDecorative(node) {
  if (node.tag !== "img" || node.attrs.alt === undefined || String(node.attrs.alt).trim()) return false
  return (
    DECORATIVE_ROLE.test(String(node.attrs.role ?? "").trim()) ||
    String(node.attrs["aria-hidden"] ?? "").trim() === "true"
  )
}

/** A rendered diagram (Mermaid marks its root with aria-roledescription) has node labels, not axes and ticks. */
function isDiagram(node) {
  return Boolean(node.attrs["aria-roledescription"])
}

function colorUses(ctx) {
  const uses = new Map()
  const add = (hex, node) => {
    const color = normalizeHex(hex)
    if (!color) return
    const entry = uses.get(color) ?? { node, count: 0 }
    entry.count++
    uses.set(color, entry)
  }
  for (const { node, css } of [...ctx.styleBlocks, ...ctx.styleAttrs]) for (const hex of hexColors(css)) add(hex, node)
  for (const node of ctx.all) {
    if (node.tag !== "svg") continue
    for (const key of ["fill", "stroke", "stop-color"]) if (node.attrs[key]) add(node.attrs[key], node)
    for (const match of (node.raw ?? "").matchAll(SVG_PAINT)) add(match[1], node)
  }
  return uses
}

function fontDeclarations(ctx) {
  const found = []
  for (const { node, css } of ctx.styleBlocks)
    for (const { families } of fontFamilies(css)) found.push({ node, families })
  for (const { node, css } of ctx.styleAttrs)
    for (const { families } of fontFamilies(`x{${resolveVar(css, ctx.tokens)}}`)) found.push({ node, families })
  for (const node of ctx.all) {
    if (node.tag !== "svg") continue
    const values = [
      node.attrs["font-family"],
      ...[...(node.raw ?? "").matchAll(SVG_FONT)].map((m) => m[1] ?? m[2]),
    ].filter(Boolean)
    for (const value of values)
      for (const { families } of fontFamilies(`x{font-family:${value}}`)) found.push({ node, families })
  }
  return found
}

export const figureGates = [
  {
    codes: ["palette_off_token"],
    skip: (ctx) => ctx.palette.size === 0,
    run(ctx) {
      const palette = new Set([...ctx.palette].map(normalizeHex))
      const defects = []
      for (const [color, { node, count }] of colorUses(ctx)) {
        if (defects.length >= MAX_PALETTE) break
        if (palette.has(color) || ALWAYS_ALLOWED.has(color)) continue
        defects.push(
          ctx.defect(
            "palette_off_token",
            node,
            `color ${color} is not in the design-spec palette (${count} use${count === 1 ? "" : "s"})`,
          ),
        )
      }
      return defects
    },
  },
  {
    codes: ["chart_without_figure"],
    run(ctx) {
      return visuals(ctx)
        .filter((node) => {
          const figure = ctx.util.closest(node, isFigure(ctx))
          return !figure || !hasCaption(ctx, figure)
        })
        .map((node) =>
          ctx.defect("chart_without_figure", node, `${label(node)} has no figure container with a non-empty caption`),
        )
    },
  },
  {
    codes: ["chart_svg_no_text", "chart_svg_missing_labels"],
    run(ctx) {
      const defects = []
      for (const node of visuals(ctx)) {
        if (node.tag !== "svg") continue
        if (!((declaredSize(node) ?? 0) >= CHART_MIN || ctx.util.closest(node, isFigure(ctx)))) continue
        if (isDiagram(node)) {
          if (!svgTexts(node.raw ?? "").length)
            defects.push(
              ctx.defect(
                "chart_svg_no_text",
                node,
                `${label(node)} diagram has no <text> labels (render Mermaid with htmlLabels off)`,
              ),
            )
          continue
        }
        const missing = missingChartLabels(node.raw ?? "")
        if (missing === null)
          defects.push(ctx.defect("chart_svg_no_text", node, `${label(node)} chart has no <text> and no <title>`))
        else if (missing.length)
          defects.push(
            ctx.defect("chart_svg_missing_labels", node, `${label(node)} chart is missing: ${missing.join(", ")}`),
          )
      }
      return defects
    },
  },
  {
    codes: ["report_without_visual"],
    run(ctx) {
      if (visuals(ctx).some((node) => !hasZeroDimension(node) && !isDecorative(node))) return []
      return [ctx.defect("report_without_visual", ctx.body, "the report has no chart, diagram, or figure image")]
    },
  },
  {
    codes: ["image_missing_alt"],
    run(ctx) {
      return visuals(ctx)
        .filter((node) => node.tag === "img" && !String(node.attrs.alt ?? "").trim() && !isDecorative(node))
        .map((node) => ctx.defect("image_missing_alt", node, `${label(node)} has no alt text`))
    },
  },
  {
    codes: ["korean_serif_font"],
    run(ctx) {
      const defects = []
      const seen = new Set()
      for (const { node, families } of fontDeclarations(ctx)) {
        for (const family of families) {
          const key = family.toLowerCase().replace(/[\s"'_-]/g, "")
          if (!SERIF_FAMILY.test(key) || seen.has(key)) continue
          seen.add(key)
          defects.push(ctx.defect("korean_serif_font", node, `serif or brush Korean font family "${family}"`))
        }
      }
      return defects
    },
  },
]
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