lookbkdev/lookbk-skills / skills/integrations-kit
integrations-kit
VerifiedBuild the integrations section and directory of a software product from one integrations.json. Instead of a wall of app icons, choosing an integration draws its wiring like a terminal strip - your product on one side, the other app on the other, one wire per record with its direction, trigger and cadence, and records that never cross drawn as open switches with the reason - next to a setup bar drawn to its minutes, who built it, which plans include it and which side wins on conflict. Below it, a directory with search, category and status filters with counts that follow each other, and an honest not-supported list. Every number is counted from the lists; the build refuses typed numbers that disagree. On a phone the wiring stacks vertically. Self-contained page and paste-in embed, a check at four widths (text size, contrast, no colliding labels, keyboard, filters, reduced motion, no JavaScript) and a frame-by-frame recorder. Use for a software product's integrations section or directory.
| File | Kind | Size |
|---|---|---|
| NOTICE.md | markdown | 1.3 KB |
| SKILL.md | skill md | 17.9 KB |
| TESTED.json | config | 558 B |
| examples/bayline/integrations.json | config | 19.2 KB |
| examples/fennick/integrations.json | config | 25.3 KB |
| kit/integrations.css | other | 19.4 KB |
| kit/runtime.js | script | 31.9 KB |
| scripts/build.mjs | script | 144 B |
| scripts/check.mjs | script | 144 B |
| scripts/chrome.mjs | script | 3.6 KB |
| scripts/kit/build.mjs | script | 16.6 KB |
| scripts/kit/cdp.mjs | script | 4.9 KB |
| scripts/kit/check.mjs | script | 25.8 KB |
| scripts/kit/record.mjs | script | 6.2 KB |
| scripts/kit/schema.mjs | script | 15.0 KB |
| scripts/kit/serve.mjs | script | 2.5 KB |
| scripts/record.mjs | script | 146 B |
| scripts/serve.mjs | script | 144 B |
scripts/kit/record.mjs
View on GitHub// Integrations kit: records the built page frame by frame into a video and
// a poster, or takes one still.
//
// node scripts/record.mjs out/index.html [--seconds 23.5] [--size 1920x1080] [--poster 7.4]
// node scripts/record.mjs out/index.html --still 9 [--size 390x844 --scale 2] [--png file.png]
// node scripts/record.mjs out/index.html --moments [--size 390x844]
//
// The page runs with ?ik-record=1: nothing moves on its own, and for every
// frame the recorder asks the page to play its fixed script up to that time
// (wire the first three featured apps one after another, scroll to the
// directory, filter to Native, search, search for something unsupported,
// then the not-supported list) and to draw the packets at that time. Every
// frame is taken at its exact time, so the video is the same on any machine.
// --moments prints { stretches: [{ what, from, to }], end }: the settled
// stretches, where nothing is drawing or sliding. Take stills inside them.
import { spawnSync } from 'node:child_process'
import { existsSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs'
import { tmpdir } from 'node:os'
import { dirname, join, relative, resolve } from 'node:path'
import { launch } from './cdp.mjs'
import { serve } from './serve.mjs'
function args(argv) {
const out = { _: [] }
for (let i = 0; i < argv.length; i++) {
const a = argv[i]
if (!a.startsWith('--')) out._.push(a)
else {
const [k, v] = a.slice(2).split('=')
out[k] = v ?? (argv[i + 1] && !argv[i + 1].startsWith('--') ? argv[++i] : true)
}
}
return out
}
const shown = (p) => { const r = relative(process.cwd(), p); return r.startsWith('..') ? p : r }
function ffmpeg(argv) {
const bin = process.env.FFMPEG_PATH || 'ffmpeg'
const r = spawnSync(bin, ['-hide_banner', '-loglevel', 'error', '-y', ...argv], { stdio: ['ignore', 'inherit', 'pipe'] })
if (r.error) throw new Error('ffmpeg not found: install it (brew install ffmpeg, winget install ffmpeg, apt install ffmpeg) or set FFMPEG_PATH')
if (r.status !== 0) throw new Error(`ffmpeg failed: ${String(r.stderr).slice(-600)}`)
}
export async function record(input, opts = {}) {
const file = resolve(input)
if (!existsSync(file)) throw new Error(`${input} not found; build the page first`)
const out = dirname(file)
const [w, h] = String(opts.size ?? '1920x1080').split('x').map(Number)
const scale = Number(opts.scale ?? 1)
const fps = Number(opts.fps ?? 30)
const server = await serve(out)
const chrome = await launch({ width: Math.max(w, 800), height: h })
const tmp = mkdtempSync(join(tmpdir(), 'integrations-kit-'))
const errors = []
try {
const tab = await chrome.page()
chrome.on('Runtime.exceptionThrown', (p) => errors.push(p.exceptionDetails?.exception?.description ?? p.exceptionDetails?.text))
await tab.send('Page.enable')
await tab.send('Runtime.enable')
await tab.send('Emulation.setDeviceMetricsOverride', { width: w, height: h, deviceScaleFactor: scale, mobile: w < 700 })
if (opts.reduce) await tab.send('Emulation.setEmulatedMedia', { features: [{ name: 'prefers-reduced-motion', value: 'reduce' }] })
const loaded = tab.once('Page.loadEventFired', 60000)
await tab.send('Page.navigate', { url: `${server.url}${relative(out, file)}?ik-record=1` })
await loaded
const ev = async (expression) => {
const r = await tab.send('Runtime.evaluate', { expression, awaitPromise: true, returnByValue: true })
if (r.exceptionDetails) throw new Error(r.exceptionDetails.exception?.description ?? r.exceptionDetails.text)
return r.result.value
}
for (let i = 0; i < 100 && !(await ev('!!window.IntegrationsKit')); i++) await new Promise((r) => setTimeout(r, 100))
if (!(await ev('!!window.IntegrationsKit'))) throw new Error(`the page did not start: ${errors.join(' | ') || 'unknown'}`)
await ev('window.IntegrationsKit.ready')
await new Promise((r) => setTimeout(r, 300))
const length = Number(opts.seconds ?? (await ev('window.IntegrationsKit.length')))
if (opts.moments) return { moments: await ev('window.IntegrationsKit.moments()') }
const shot = async (t, path) => {
await ev(`window.IntegrationsKit.seek(${t})`)
await ev('new Promise((r) => requestAnimationFrame(() => requestAnimationFrame(r)))')
const { data } = await tab.send('Page.captureScreenshot', { format: 'png' })
writeFileSync(path, Buffer.from(data, 'base64'))
}
if (opts.still !== undefined) {
const png = resolve(opts.png ?? join(out, 'still.png'))
await shot(Math.min(Math.max(Number(opts.still) || 0, 0), length), png)
if (errors.length) throw new Error(`page errors: ${errors.join(' | ')}`)
return { png }
}
const frames = Math.round(length * fps)
for (let i = 0; i < frames; i++) await shot(i / fps, join(tmp, `${String(i + 1).padStart(5, '0')}.png`))
const mp4 = join(out, 'preview.mp4')
ffmpeg(['-framerate', String(fps), '-i', join(tmp, '%05d.png'), '-vf', `scale=${w}:${h}:flags=lanczos,format=yuv420p`, '-c:v', 'libx264', '-preset', 'slow', '-crf', String(opts.crf ?? 18), '-movflags', '+faststart', mp4])
const posterAt = Math.min(Math.max(Number(opts.poster ?? 7.4), 0), length - 1 / fps)
const poster = join(out, 'poster.png')
ffmpeg(['-ss', String(posterAt), '-i', mp4, '-frames:v', '1', '-update', '1', poster])
if (errors.length) console.warn(`page errors: ${errors.join(' | ')}`)
return { mp4, poster }
} finally {
await chrome.close()
server.close()
rmSync(tmp, { recursive: true, force: true })
}
}
export async function main(argv = process.argv.slice(2)) {
const a = args(argv)
const [input] = a._
if (!input) {
console.log('usage: node scripts/record.mjs out/index.html [--seconds 23.5] [--size 1920x1080] [--poster 7.4]\n node scripts/record.mjs out/index.html --still SECONDS [--size 390x844 --scale 2] [--png file.png] [--reduce]\n node scripts/record.mjs out/index.html --moments [--size 390x844]')
process.exit(1)
}
try {
const r = await record(input, a)
if (r.moments) console.log(JSON.stringify(r.moments))
else if (r.png) console.log(`wrote ${shown(r.png)}`)
else console.log(`wrote ${shown(r.mp4)} and ${shown(r.poster)}`)
} catch (e) {
console.error(e.message)
process.exit(1)
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |