Skip to content

lookbkdev/lookbk-skills / skills/spec-sheet-kit

spec-sheet-kit

Verified

Build the technical specifications section of a hardware product page from one spec.json, set as an engineering drawing and its schedule. The product is drawn in true orthographic views (plan, elevations, a 2:1 detail, a hatched section) with balloons, dimension lines and a title block; every balloon number is its line in the table, and pointing at a line lights its part on the drawing, and the reverse. Units switch between mm and inches and kg and pounds, with stated rounding rules. A compare mode sets 2 or 3 models side by side, writing shared values once and giving differences a delta. The build checks that every drawn dimension measures what the table says, that each part is the same size in every view, and that battery figures add up. Prints as one landscape A4 or Letter sheet. Builds a self-contained page and a paste-in embed, with checks at four widths and a frame-by-frame recorder. Use for the tech specs or model comparison of a hardware product.

FileKindSize
NOTICE.mdmarkdown1.3 KB
SKILL.mdskill md19.3 KB
TESTED.jsonconfig613 B
examples/ampwright/spec.jsonconfig26.4 KB
examples/fennick/spec.jsonconfig23.8 KB
kit/core.jsscript27.6 KB
kit/runtime.jsscript18.6 KB
kit/spec.cssother18.1 KB
scripts/build.mjsscript142 B
scripts/check.mjsscript142 B
scripts/chrome.mjsscript3.6 KB
scripts/kit/build.mjsscript8.8 KB
scripts/kit/cdp.mjsscript4.9 KB
scripts/kit/check.mjsscript18.4 KB
scripts/kit/record.mjsscript9.0 KB
scripts/kit/schema.mjsscript20.9 KB
scripts/kit/serve.mjsscript2.5 KB
scripts/record.mjsscript144 B
scripts/serve.mjsscript142 B

scripts/chrome.mjs

View on GitHub
// Headless Chrome helpers for check.mjs and screenshot.mjs. Nothing to
// install: it drives the Chrome, Chromium or Edge already on the machine.
import { execFileSync } from 'node:child_process'
import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
import { homedir } from 'node:os'
import { dirname, join } from 'node:path'
import { pathToFileURL } from 'node:url'

export function findChrome() {
  return [
    process.env.CHROME_PATH,
    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
    '/Applications/Chromium.app/Contents/MacOS/Chromium',
    '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
    `${homedir()}/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`,
    '/usr/bin/google-chrome',
    '/usr/bin/google-chrome-stable',
    '/usr/bin/chromium',
    '/usr/bin/chromium-browser',
    '/usr/bin/microsoft-edge',
    '/snap/bin/chromium',
    'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
    'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
    'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
  ]
    .filter(Boolean)
    .find((p) => existsSync(p))
}

/** Runs headless Chrome on a URL and returns what it printed. */
export function chrome(bin, url, args) {
  return execFileSync(
    bin,
    [
      '--headless=new',
      '--disable-gpu',
      ...(process.getuid?.() === 0 ? ['--no-sandbox'] : []),
      '--hide-scrollbars',
      '--virtual-time-budget=8000',
      ...args,
      url,
    ],
    { stdio: ['ignore', 'pipe', 'ignore'], maxBuffer: 64 * 1024 * 1024 },
  ).toString()
}

/**
 * Loads the page in a frame exactly `width` px wide, once per width, and
 * runs `fn` in it after its fonts have loaded. Returns fn's result for each
 * width (anything JSON can hold), or null where the page didn't finish.
 *
 * The frame is there because Chrome's window can't be narrower than 500px,
 * so a 390px phone can't be measured in the window itself.
 */
export function inFrame(bin, page, widths, fn) {
  const dir = dirname(page)
  const probe = join(dir, '.lookbook-probe.html')
  const frame = join(dir, '.lookbook-frame.html')
  const html = readFileSync(page, 'utf8')
  const script = `<script>addEventListener('load', () => (document.fonts ? document.fonts.ready : Promise.resolve()).then(() => new Promise((r) => setTimeout(r, 100))).then(() => parent.postMessage({ lookbook: JSON.stringify((${fn.toString()})()) }, '*')))</script>`
  writeFileSync(
    probe,
    html.includes('</body>')
      ? html.replace('</body>', `${script}</body>`)
      : html + script,
  )
  writeFileSync(
    frame,
    `<!doctype html><meta charset="utf-8"><body style="margin:0"><script>
addEventListener('message', (e) => {
  if (!e.data || typeof e.data.lookbook !== 'string') return
  const out = document.createElement('script')
  out.type = 'application/json'
  out.id = 'lookbook-result'
  out.textContent = e.data.lookbook.replace(/</g, '\\\\u003c')
  document.body.appendChild(out)
})
const f = document.createElement('iframe')
f.src = '.lookbook-probe.html'
f.style.cssText = 'border:0;display:block;width:' + location.hash.slice(1) + 'px;height:900px'
document.body.appendChild(f)
</script>`,
  )
  try {
    return widths.map((w) => {
      const dom = chrome(bin, `${pathToFileURL(frame).href}#${w}`, [
        `--window-size=${Math.max(w, 500)},900`,
        '--dump-dom',
      ])
      const found =
        /<script type="application\/json" id="lookbook-result">([\s\S]*?)<\/script>/.exec(
          dom,
        )
      return found ? JSON.parse(found[1]) : null
    })
  } finally {
    rmSync(probe, { force: true })
    rmSync(frame, { force: true })
  }
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall