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

View on GitHub
// gates-layout.mjs - L1-L5 geometric gates over the layout probe output (boxes.json).
//
// Pure functions over the object layout-probe.mjs returns: no browser, no DOM, and selectors are
// taken verbatim from the probe (the probe already built them with the html-lite rule). Severities
// and hints are read from contracts.DEFECT_CODES, never set here. Measured pixel amounts are
// rounded to 0.1px (the probe's own precision) before a threshold compare, so float noise such as
// 2.000000000000001 never crosses a 2px limit.

import { DEFECT_CODES } from "./contracts.mjs"
import { PROBE_VERSION, ProbeError } from "./layout-probe.mjs"

/** Thresholds (draft D10): rounding tolerances, not taste. */
export const OVERFLOW_PX = 2
export const SCROLL_SLACK_PX = 2
export const ASPECT_DRIFT = 0.03
export const OVERLAP_PX = 12

const OUT_OF_FLOW = new Set(["absolute", "fixed"])
const IN_FLOW = new Set(["static", "relative"])
const CLIPPING = new Set(["hidden", "clip"])
const SCROLLING = new Set(["auto", "scroll"])
const ASPECT_SAFE_FITS = new Set(["cover", "contain", "scale-down"])

const r1 = (n) => Math.round(n * 10) / 10

/**
 * @typedef {{ code: string, severity: string, selector: string, line: null, message: string, hint: string }} Defect
 */
function defect(code, selector, message) {
  const { severity, hint } = DEFECT_CODES[code]
  return { code, severity, selector, line: null, message, hint }
}

// L1: the largest spill of the child rect past any side of its parent rect. A parent that scrolls
// on the spill axis makes it intentional scrolling (the advisory scroll container); a parent that
// clips on that axis hides the spilled content (text clipped).
function checkOverflow(box) {
  if (!box.parentRect || OUT_OF_FLOW.has(box.position)) return null
  const c = box.rect
  const p = box.parentRect
  const sides = [
    ["left", p.x - c.x],
    ["top", p.y - c.y],
    ["right", c.x + c.w - (p.x + p.w)],
    ["bottom", c.y + c.h - (p.y + p.h)],
  ].map(([side, px]) => [side, r1(px)])
  const [side, px] = sides.reduce((worst, entry) => (entry[1] > worst[1] ? entry : worst))
  if (px <= OVERFLOW_PX) return null
  const parentMode = box.parentOverflow?.[side === "left" || side === "right" ? "x" : "y"]
  if (SCROLLING.has(parentMode)) {
    return defect(
      "layout_scroll_container",
      box.selector,
      `${box.tag} is ${px}px wider than ${box.parentSelector}, which scrolls (overflow: ${parentMode})`,
    )
  }
  if (CLIPPING.has(parentMode)) {
    return defect(
      "layout_text_clipped",
      box.selector,
      `${box.tag} spills ${px}px past the ${side} edge of ${box.parentSelector}, which clips it (overflow: ${parentMode})`,
    )
  }
  return defect(
    "layout_overflow",
    box.selector,
    `${box.tag} spills ${px}px past the ${side} edge of ${box.parentSelector}`,
  )
}

// L2/L3: content larger than the box on an axis whose computed overflow clips or scrolls.
function checkScroll(box) {
  const { sw, cw, sh, ch } = box.scroll
  const axes = [
    ["x", sw - cw, box.overflow.x],
    ["y", sh - ch, box.overflow.y],
  ].filter(([, excess]) => r1(excess) > SCROLL_SLACK_PX)
  const clipped = axes.find(([, , mode]) => CLIPPING.has(mode))
  if (clipped) {
    const [axis, excess, mode] = clipped
    return defect(
      "layout_text_clipped",
      box.selector,
      `${box.tag} content exceeds its box by ${r1(excess)}px on ${axis} under overflow: ${mode}`,
    )
  }
  const scrolled = axes.find(([, , mode]) => SCROLLING.has(mode))
  if (scrolled) {
    const [axis, excess, mode] = scrolled
    return defect(
      "layout_scroll_container",
      box.selector,
      `${box.tag} scrolls ${r1(excess)}px on ${axis} under overflow: ${mode}`,
    )
  }
  return null
}

// L4: rendered aspect ratio drifting from the natural one without an aspect-preserving fit.
function checkAspect(box) {
  if (box.tag !== "img" || !box.natural) return null
  const { w, h } = box.rect
  const { w: nw, h: nh } = box.natural
  if (!(w > 0 && h > 0 && nw > 0 && nh > 0)) return null
  const fit = box.objectFit ?? "fill"
  if (ASPECT_SAFE_FITS.has(fit)) return null
  const drift = Math.abs(w / h / (nw / nh) - 1)
  if (drift <= ASPECT_DRIFT) return null
  const percent = (drift * 100).toFixed(1)
  return defect(
    "layout_image_distorted",
    box.selector,
    `img rendered ${w}x${h} from natural ${nw}x${nh} distorts the aspect ratio by ${percent}% (object-fit: ${fit})`,
  )
}

function intersection(a, b) {
  const ix = Math.min(a.x + a.w, b.x + b.w) - Math.max(a.x, b.x)
  const iy = Math.min(a.y + a.h, b.y + b.h) - Math.max(a.y, b.y)
  return { ix: r1(ix), iy: r1(iy) }
}

// L5: in-flow siblings (same parentSelector) whose rects intersect by more than 12px on both axes.
function checkSiblings(boxes) {
  const groups = new Map()
  for (const box of boxes) {
    if (box.parentSelector === null || box.parentSelector === undefined || !IN_FLOW.has(box.position)) continue
    const group = groups.get(box.parentSelector) ?? []
    group.push(box)
    groups.set(box.parentSelector, group)
  }
  const defects = []
  for (const group of groups.values()) {
    for (let i = 0; i < group.length; i += 1) {
      for (let j = i + 1; j < group.length; j += 1) {
        const { ix, iy } = intersection(group[i].rect, group[j].rect)
        if (Math.min(ix, iy) <= OVERLAP_PX) continue
        defects.push(
          defect(
            "layout_sibling_overlap",
            group[i].selector,
            `${group[i].selector} and ${group[j].selector} overlap by ${ix}x${iy}px`,
          ),
        )
      }
    }
  }
  return defects
}

function validateProbe(probe) {
  if (probe === null || typeof probe !== "object")
    throw new ProbeError("invalid_probe", "layout probe must be an object")
  if (probe.probe_version !== PROBE_VERSION) {
    throw new ProbeError(
      "unsupported_probe_version",
      `layout probe_version must be ${PROBE_VERSION}, got ${probe.probe_version}`,
    )
  }
  if (!Array.isArray(probe.boxes)) throw new ProbeError("invalid_probe", "layout probe boxes must be an array")
}

/**
 * @param {{ probe_version: number, count?: number, truncated?: boolean, boxes: object[] }} probe
 * @returns {{ defects: Defect[], summary: string }}
 */
export function checkLayout(probe) {
  validateProbe(probe)
  const defects = []
  for (const box of probe.boxes) {
    for (const rule of [checkOverflow, checkScroll, checkAspect]) {
      const found = rule(box)
      if (found) defects.push(found)
    }
  }
  defects.push(...checkSiblings(probe.boxes))
  let summary = `layout: ${probe.boxes.length} boxes checked, ${defects.length} defects`
  if (probe.truncated) summary += `; layout sample truncated`
  return { defects, summary }
}
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