lookbkdev/lookbk-skills / skills/story-rail-kit
story-rail-kit
VerifiedBuild a horizontal rail of rich cards for a website from one rail.json done properly instead of as a janky carousel. Native scroll-snap, Previous and Next buttons that move by exactly one card whatever its width, and a scale under the rail drawn from the cards themselves with a bracket framing what is on screen, so a visitor always knows where they are and how much is left. Five card kinds in a rhythm the build checks (wide, tall, quote, number with its source, and a view-all end card), loops that play only on screen, keyboard support, a mouse drag that never opens a card by accident, and touch that never traps vertical scroll. No auto-advance unless you turn it on. A self-contained page plus a paste-in embed, a check at four widths including keyboard, drag and vertical scrolling, and a frame-by-frame recorder. Use for a home page band of case studies, recipes, articles, collections or products that leads to a "view all" page.
| File | Kind | Size |
|---|---|---|
| NOTICE.md | markdown | 1.5 KB |
| SKILL.md | skill md | 13.7 KB |
| TESTED.json | config | 405 B |
| examples/kestle/rail.json | config | 2.7 KB |
| examples/larder/rail.json | config | 2.7 KB |
| kit/drawn.mjs | script | 22.2 KB |
| kit/fonts/dm-mono-500.woff2 | binary | 14.6 KB |
| kit/fonts/dm-mono-OFL.txt | markdown | 4.4 KB |
| kit/fonts/fraunces-OFL.txt | markdown | 4.4 KB |
| kit/fonts/fraunces-italic.woff2 | binary | 146.2 KB |
| kit/fonts/fraunces.woff2 | binary | 118.2 KB |
| kit/fonts/geist-OFL.txt | markdown | 4.4 KB |
| kit/fonts/geist.woff2 | binary | 28.7 KB |
| kit/fonts/plex-mono-500.woff2 | binary | 14.5 KB |
| kit/fonts/plex-mono-OFL.txt | markdown | 5.2 KB |
| kit/rail.css | other | 11.3 KB |
| kit/runtime.js | script | 16.8 KB |
| scripts/build.mjs | script | 138 B |
| scripts/check.mjs | script | 138 B |
| scripts/chrome.mjs | script | 3.6 KB |
| scripts/kit/build.mjs | script | 12.4 KB |
| scripts/kit/cdp.mjs | script | 4.9 KB |
| scripts/kit/check.mjs | script | 21.7 KB |
| scripts/kit/record.mjs | script | 6.9 KB |
| scripts/kit/schema.mjs | script | 12.6 KB |
| scripts/kit/serve.mjs | script | 2.5 KB |
| scripts/record.mjs | script | 140 B |
| scripts/serve.mjs | script | 138 B |
scripts/kit/cdp.mjs
View on GitHub// Work Index (from the Motion Heroes kit): a small Chrome DevTools Protocol client over
// --remote-debugging-pipe. Nothing to install: it starts the Chrome,
// Chromium or Edge already on the machine (found like chrome.mjs does, or
// CHROME_PATH) and talks to it on file descriptors 3 and 4, which works the
// same on macOS, Windows and Linux.
import { spawn } from 'node:child_process'
import { existsSync, mkdtempSync, rmSync } from 'node:fs'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { findChrome } from '../chrome.mjs'
/** chrome.mjs's list, plus per-user installs it doesn't look in. */
export function findBrowser() {
const found = findChrome()
if (found) return found
const local = process.env.LOCALAPPDATA
const more = [
local && join(local, 'Google', 'Chrome', 'Application', 'chrome.exe'),
local && join(local, 'Chromium', 'Application', 'chrome.exe'),
'C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe',
'/usr/bin/chromium-freeworld',
'/opt/google/chrome/chrome',
'/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
'/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
]
return more.filter(Boolean).find((p) => existsSync(p))
}
/**
* Starts headless Chrome with a window of `width`×`height` and returns
* { send(method, params, sessionId), on(event, fn), page(), close() }.
*/
export async function launch({ width, height, bin = findBrowser(), args: extra = [] }) {
if (!bin) throw new Error('no Chrome, Chromium or Edge found; set CHROME_PATH')
const profile = mkdtempSync(join(tmpdir(), 'motion-hero-'))
const args = [
'--headless=new',
'--remote-debugging-pipe',
`--user-data-dir=${profile}`,
'--no-first-run',
'--no-default-browser-check',
'--hide-scrollbars',
'--mute-audio',
'--force-color-profile=srgb',
'--ignore-gpu-blocklist',
// WebGL on machines without a usable GPU (CI, virtual machines)
'--enable-unsafe-swiftshader',
'--disable-background-timer-throttling',
'--disable-backgrounding-occluded-windows',
'--disable-renderer-backgrounding',
'--disable-extensions',
`--window-size=${width},${height}`,
...(process.getuid?.() === 0 ? ['--no-sandbox'] : []),
...extra,
'about:blank',
]
const proc = spawn(bin, args, { stdio: ['ignore', 'ignore', 'pipe', 'pipe', 'pipe'] })
let log = ''
proc.stderr.on('data', (d) => (log = (log + d).slice(-4000)))
const out = proc.stdio[3]
const inp = proc.stdio[4]
let id = 0
const waiting = new Map()
const listeners = new Map()
let buf = Buffer.alloc(0)
let closed = false
inp.on('data', (chunk) => {
buf = Buffer.concat([buf, chunk])
let end
while ((end = buf.indexOf(0)) !== -1) {
const msg = JSON.parse(buf.subarray(0, end).toString('utf8'))
buf = buf.subarray(end + 1)
if (msg.id && waiting.has(msg.id)) {
const { ok, no, method } = waiting.get(msg.id)
waiting.delete(msg.id)
if (msg.error) no(new Error(`${method}: ${msg.error.message}`))
else ok(msg.result)
} else if (msg.method) for (const fn of listeners.get(msg.method) ?? []) fn(msg.params, msg.sessionId)
}
})
const died = new Promise((_, no) =>
proc.on('exit', (code) => {
closed = true
const err = new Error(`Chrome exited (${code}) ${log.split('\n').slice(-3).join(' ')}`)
for (const w of waiting.values()) w.no(err)
no(err)
}),
)
died.catch(() => {})
const send = (method, params = {}, sessionId) =>
new Promise((ok, no) => {
if (closed) return no(new Error('Chrome has exited'))
const msg = { id: ++id, method, params }
if (sessionId) msg.sessionId = sessionId
waiting.set(msg.id, { ok, no, method })
out.write(JSON.stringify(msg) + '\0')
})
const on = (event, fn) => listeners.set(event, [...(listeners.get(event) ?? []), fn])
const once = (event, sessionId, ms = 30000) =>
new Promise((ok, no) => {
const t = setTimeout(() => no(new Error(`timed out waiting for ${event}`)), ms)
on(event, (p, s) => {
if (!sessionId || s === sessionId) {
clearTimeout(t)
ok(p)
}
})
})
/** A new tab, attached; returns a session-bound send. */
async function page() {
const { targetId } = await send('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await send('Target.attachToTarget', { targetId, flatten: true })
const s = (method, params) => send(method, params, sessionId)
return { sessionId, send: s, once: (event, ms) => once(event, sessionId, ms) }
}
async function close() {
if (!closed) {
await Promise.race([send('Browser.close').catch(() => {}), new Promise((r) => setTimeout(r, 3000))])
if (!closed) proc.kill()
}
await new Promise((r) => setTimeout(r, 200))
try {
rmSync(profile, { recursive: true, force: true, maxRetries: 3 })
} catch {}
}
return { send, on, page, close, bin }
}
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 |