Skill Binder

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_680":681,"_682":683},"routes/_app.x.$handle.$name",{"_98":97,"_32":46,"_107":88,"_27":108,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_20":-5,"_119":-5,"_120":-5,"_121":25,"_122":123,"_124":60,"_125":-5,"_126":-5,"_127":128},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_44":45,"_32":46,"_39":47,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":-5,"_68":-5,"_69":-5,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":81,"_82":83,"_84":85,"_86":25},"version",50,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":38,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","data/loader.ts","latestPath","fileId","ae9857de-5927-11f1-8d94-ee650bb23af1","name","loader.ts","fileType","script","content","// Loads skills off disk by walking the `skills/` directory.\n//\n// The directory layout is the standard \"skill repo\" shape so any agent\n// could read it as-is:\n//\n// skills/\n// _index.json ← binder-only card metadata\n// /\n// SKILL.md ← YAML frontmatter + markdown body\n// memories/_.md ← per-memory files\n// templates/.md\n// scripts/.ts\n//\n// The `Skill` objects returned by `loadSkills()` are exactly what the\n// JSON API serves to the client. Markdown bodies are the *full* SKILL.md\n// (frontmatter included), so an agent gets the same bytes the file holds.\n\nimport { listFiles, readFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { parse as parseYaml } from \"https://esm.sh/yaml@2.5.0\";\n\nexport type SkillColor = \"blue\" | \"white\" | \"black\" | \"red\" | \"green\" | \"gold\";\n\nexport interface Memory {\n kind: \"feedback\" | \"project\" | \"reference\" | \"user\";\n slug: string;\n title: string;\n description?: string;\n body: string;\n}\n\nexport interface Skill {\n slug: string;\n name: string;\n description: string;\n triggers: string[];\n body: string;\n\n type: string;\n color: SkillColor;\n art: string;\n artPrompt: string;\n manaCost: number;\n level: number;\n invocations: number;\n lastUsed: string;\n flavor: string;\n\n memories: Memory[];\n templates: string[];\n scripts: string[];\n}\n\ninterface CardMeta {\n type: string;\n color: SkillColor;\n art: string;\n artPrompt: string;\n manaCost: number;\n level: number;\n invocations: number;\n lastUsed: string;\n flavor: string;\n}\n\nlet cached: Skill[] | null = null;\n\nexport async function loadSkills(): Promise {\n if (cached) return cached;\n const indexText = await readFile(\"/skills/_index.json\", import.meta.url);\n const index = JSON.parse(indexText) as Record;\n\n const order = Object.keys(index).filter((k) => !k.startsWith(\"_\"));\n const skills = await Promise.all(\n order.map((slug) => loadOne(slug, index[slug] as CardMeta)),\n );\n cached = skills;\n return skills;\n}\n\nasync function loadOne(slug: string, meta: CardMeta): Promise {\n const body = await readFile(`/skills/${slug}/SKILL.md`, import.meta.url);\n const { frontmatter } = splitFrontmatter(body);\n\n const [memories, templates, scripts] = await Promise.all([\n loadMemories(slug),\n listSubdirFiles(slug, \"templates\"),\n listSubdirFiles(slug, \"scripts\"),\n ]);\n\n return {\n slug,\n name: String(frontmatter.name ?? slug),\n description: String(frontmatter.description ?? \"\"),\n triggers: Array.isArray(frontmatter.triggers)\n ? frontmatter.triggers.map(String)\n : [],\n body,\n\n type: meta.type,\n color: meta.color,\n art: meta.art,\n artPrompt: meta.artPrompt,\n manaCost: meta.manaCost,\n level: meta.level,\n invocations: meta.invocations,\n lastUsed: meta.lastUsed,\n flavor: meta.flavor,\n\n memories,\n templates,\n scripts,\n };\n}\n\nasync function loadMemories(slug: string): Promise {\n const files = await safeListMd(`skills/${slug}/memories`);\n const loaded = await Promise.all(\n files.map(async (name) => {\n const text = await readFile(\n `/skills/${slug}/memories/${name}`,\n import.meta.url,\n );\n const { frontmatter, body } = splitFrontmatter(text);\n const kind = resolveKind(name, frontmatter);\n const memorySlug = String(frontmatter.name ?? name.replace(/\\.md$/, \"\"));\n const title = humanize(memorySlug);\n return {\n kind,\n slug: memorySlug,\n title,\n description: frontmatter.description\n ? String(frontmatter.description)\n : undefined,\n body: body.trim(),\n } as Memory;\n }),\n );\n return loaded;\n}\n\nasync function listSubdirFiles(slug: string, sub: string): Promise {\n try {\n const entries = await listFiles(`/skills/${slug}/${sub}`, import.meta.url);\n return entries\n .filter((e: any) => e?.type === \"file\" || e?.type === \"script\")\n .map((e: any) => String(e.name))\n .sort();\n } catch {\n return [];\n }\n}\n\nasync function safeListMd(path: string): Promise {\n try {\n const entries = await listFiles(`/${path}`, import.meta.url);\n return entries\n .filter((e: any) => (e?.type === \"file\" || e?.type === \"script\") && String(e.name).endsWith(\".md\"))\n .map((e: any) => String(e.name))\n .sort();\n } catch {\n return [];\n }\n}\n\nfunction splitFrontmatter(md: string): { frontmatter: Record; body: string } {\n const m = md.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)$/);\n if (!m) return { frontmatter: {}, body: md };\n try {\n const fm = parseYaml(m[1]) ?? {};\n return { frontmatter: fm, body: m[2] };\n } catch {\n return { frontmatter: {}, body: m[2] };\n }\n}\n\nfunction resolveKind(filename: string, fm: Record): Memory[\"kind\"] {\n const declared = fm?.metadata?.type ?? fm?.type;\n if (declared && [\"feedback\", \"project\", \"reference\", \"user\"].includes(declared)) {\n return declared as Memory[\"kind\"];\n }\n const base = filename.toLowerCase();\n if (base.startsWith(\"feedback\")) return \"feedback\";\n if (base.startsWith(\"project\")) return \"project\";\n if (base.startsWith(\"reference\")) return \"reference\";\n if (base.startsWith(\"user\")) return \"user\";\n return \"feedback\";\n}\n\nfunction humanize(slug: string): string {\n return slug.replace(/[-_]/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n","// Loads skills off disk by walking the `skills/` directory.\n//\n// Layout (a standard \"skill repo\" shape, agent-readable as-is):\n//\n// skills/\n// _index.json ← binder-only card metadata\n// /\n// SKILL.md ← YAML frontmatter + markdown body\n// memories/_.md ← per-memory files (frontmatter typed)\n// templates/.md\n// scripts/.ts\n\nimport { listFilesByPath, readFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { parse as parseYaml } from \"https://esm.sh/yaml@2.5.0\";\n\nexport type SkillColor = \"blue\" | \"white\" | \"black\" | \"red\" | \"green\" | \"gold\";\n\nexport interface Memory {\n kind: \"feedback\" | \"project\" | \"reference\" | \"user\";\n slug: string;\n title: string;\n description?: string;\n body: string;\n}\n\nexport interface Skill {\n slug: string;\n name: string;\n description: string;\n triggers: string[];\n body: string;\n\n type: string;\n color: SkillColor;\n art: string;\n artPrompt: string;\n manaCost: number;\n level: number;\n invocations: number;\n lastUsed: string;\n flavor: string;\n\n memories: Memory[];\n templates: string[];\n scripts: string[];\n}\n\ninterface CardMeta {\n type: string;\n color: SkillColor;\n art: string;\n artPrompt: string;\n manaCost: number;\n level: number;\n invocations: number;\n lastUsed: string;\n flavor: string;\n}\n\ninterface FileEntry {\n path: string;\n name?: string;\n type?: string;\n}\n\nlet cached: Skill[] | null = null;\n\nexport async function loadSkills(): Promise {\n if (cached) return cached;\n const indexText = await readFile(\"/skills/_index.json\", import.meta.url);\n const index = JSON.parse(indexText) as Record;\n\n // One recursive listing under skills/ — everything in one round-trip.\n const allFiles = (await listFilesByPath(\"skills\", import.meta.url)) as FileEntry[];\n\n const order = Object.keys(index).filter((k) => !k.startsWith(\"_\"));\n const skills = await Promise.all(\n order.map((slug) => loadOne(slug, index[slug] as CardMeta, allFiles)),\n );\n cached = skills;\n return skills;\n}\n\nasync function loadOne(slug: string, meta: CardMeta, allFiles: FileEntry[]): Promise {\n const prefix = `skills/${slug}/`;\n const filesForSkill = allFiles.filter((f) => f.path?.startsWith(prefix));\n\n const body = await readFile(`/skills/${slug}/SKILL.md`, import.meta.url);\n const { frontmatter } = splitFrontmatter(body);\n\n const memoryFiles = filesForSkill.filter(\n (f) => f.path.startsWith(`${prefix}memories/`) && f.path.endsWith(\".md\"),\n );\n const memories = await Promise.all(memoryFiles.map(loadMemory));\n\n const templates = filesForSkill\n .filter((f) => f.path.startsWith(`${prefix}templates/`) && f.type !== \"directory\")\n .map((f) => basename(f.path))\n .sort();\n const scripts = filesForSkill\n .filter((f) => f.path.startsWith(`${prefix}scripts/`) && f.type !== \"directory\")\n .map((f) => basename(f.path))\n .sort();\n\n return {\n slug,\n name: String(frontmatter.name ?? slug),\n description: String(frontmatter.description ?? \"\"),\n triggers: Array.isArray(frontmatter.triggers) ? frontmatter.triggers.map(String) : [],\n body,\n type: meta.type,\n color: meta.color,\n art: meta.art,\n artPrompt: meta.artPrompt,\n manaCost: meta.manaCost,\n level: meta.level,\n invocations: meta.invocations,\n lastUsed: meta.lastUsed,\n flavor: meta.flavor,\n memories,\n templates,\n scripts,\n };\n}\n\nasync function loadMemory(f: FileEntry): Promise {\n const text = await readFile(`/${f.path}`, import.meta.url);\n const { frontmatter, body } = splitFrontmatter(text);\n const name = basename(f.path);\n const kind = resolveKind(name, frontmatter);\n const memorySlug = String(frontmatter.name ?? name.replace(/\\.md$/, \"\"));\n return {\n kind,\n slug: memorySlug,\n title: humanize(memorySlug),\n description: frontmatter.description ? String(frontmatter.description) : undefined,\n body: body.trim(),\n };\n}\n\nfunction basename(path: string): string {\n return path.split(\"/\").pop() ?? path;\n}\n\nfunction splitFrontmatter(md: string): { frontmatter: Record; body: string } {\n const m = md.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)$/);\n if (!m) return { frontmatter: {}, body: md };\n try {\n const fm = parseYaml(m[1]) ?? {};\n return { frontmatter: fm, body: m[2] };\n } catch {\n return { frontmatter: {}, body: m[2] };\n }\n}\n\nfunction resolveKind(filename: string, fm: Record): Memory[\"kind\"] {\n const declared = fm?.metadata?.type ?? fm?.type;\n if (declared && [\"feedback\", \"project\", \"reference\", \"user\"].includes(declared)) {\n return declared as Memory[\"kind\"];\n }\n const base = filename.toLowerCase();\n if (base.startsWith(\"feedback\")) return \"feedback\";\n if (base.startsWith(\"project\")) return \"project\";\n if (base.startsWith(\"reference\")) return \"reference\";\n if (base.startsWith(\"user\")) return \"user\";\n return \"feedback\";\n}\n\nfunction humanize(slug: string): string {\n return slug.replace(/[-_]/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n","createdAt",["D",1779816372118],"branchVersion","branchId","a265a3e8-5924-11f1-b614-ee650bb23af1","id","a264eee4-5924-11f1-b614-ee650bb23af1","skillbook",["D",1779814930341],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Interactive trading-card view of an agent skill repo","imageUrl","9319c175-2593-4f88-ba21-04f2ef7b1c28","pinnedFileId","a2693198-5924-11f1-b614-ee650bb23af1","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",1,"orgId","d663a026-6449-42f6-9156-1d4a2d64d38c","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_98":97,"_106":102},"org",{"_98":97,"_99":100,"_101":102,"_18":56,"_103":104,"_105":25},"branch",{"_13":87,"_32":88,"_44":43,"_89":45,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":46,"_96":97},"isOwned",345,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","dcm31","handle","displayName","Charlie","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/3e904faa-3764-4629-c475-f561a49b0000/square512?exp=1789570799&sig=bfafc9de3f25d020766c1a418088d2aa7a118e3408c10bafe80b0604dafaeba0","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_44":45,"_32":46,"_39":676,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":-5,"_68":-5,"_69":-5,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":677,"_82":678,"_84":679,"_86":25},"tree",[182,184,242,245,246],"files",[182,183,184,185,186,187,188,189,190,191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246],"counts",{"_171":150,"_172":64,"_173":150,"_174":175,"_176":177},"contents",[129,130,131,132,133],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":165,"_32":166,"_30":167,"_136":-5,"_42":43,"_41":168,"_138":60,"_39":169,"_13":150,"_34":157,"_36":-5,"_24":25,"_143":-5,"_27":170},{"_44":159,"_32":160,"_30":161,"_136":-5,"_42":43,"_41":162,"_138":60,"_39":163,"_13":150,"_34":157,"_36":-5,"_24":25,"_143":-5,"_27":164},{"_44":153,"_32":154,"_30":155,"_136":-5,"_42":43,"_41":140,"_138":60,"_39":156,"_13":150,"_34":157,"_36":-5,"_24":25,"_143":-5,"_27":158},{"_44":145,"_32":146,"_30":147,"_136":-5,"_42":43,"_41":148,"_138":25,"_39":149,"_13":150,"_34":20,"_36":151,"_24":25,"_143":-5,"_27":152},{"_44":134,"_32":135,"_30":58,"_136":-5,"_42":43,"_41":137,"_138":25,"_39":139,"_13":140,"_34":141,"_36":142,"_24":25,"_143":46,"_27":144},"bb32ef40-5927-11f1-9e3f-ee650bb23af1","main.tsx","parentId",48,"latest",["D",1779816260414],4,"http","// skill-binder — interactive trading-card view of an agent skill repo.\n//\n// Tariq's frame: \"HTML is the new markdown.\" Agents are happy with terse\n// markdown. Humans want richer, more spatial, more alive formats. So the\n// data layer stays markdown (the agent reads it verbatim) and the human\n// view layers HTML on top. Same source, two faces.\n//\n// File layout mirrors a traditional skill repo — see data/loader.ts.\n\nimport { Hono } from \"npm:hono@4\";\nimport {\n parseVal,\n readFile,\n serveFile,\n} from \"https://esm.town/v/std/utils/index.ts\";\nimport { blob } from \"https://esm.town/v/std/blob\";\nimport { loadSkills } from \"./data/loader.ts\";\n\nconst SLUG_RE = /^[a-z0-9_-]+$/;\nconst FILE_RE = /^[a-z0-9_.-]+$/;\n\nconst app = new Hono();\napp.onError((err) => Promise.reject(err));\n\napp.get(\"/\", async (c) => {\n const html = await readFile(\"/static/index.html\", import.meta.url);\n return c.html(html);\n});\n\napp.get(\"/static/:file\", (c) => serveFile(`/static/${c.req.param(\"file\")}`, import.meta.url));\n\napp.get(\"/api/skills\", async (c) => c.json(await loadSkills()));\n\napp.get(\"/api/skills/:slug\", async (c) => {\n const slug = c.req.param(\"slug\");\n const skills = await loadSkills();\n const skill = skills.find((s) => s.slug === slug);\n if (!skill) return c.json({ error: \"not found\" }, 404);\n return c.json(skill);\n});\n\n// Raw-file routes — what an agent would actually read off disk. The val IS\n// a skill repo; these routes expose it as one.\napp.get(\"/raw/:slug/SKILL.md\", (c) => {\n const slug = c.req.param(\"slug\");\n if (!SLUG_RE.test(slug)) return c.text(\"bad slug\", 400);\n return serveFile(`/skills/${slug}/SKILL.md`, import.meta.url);\n});\n\napp.get(\"/raw/:slug/memories/:file\", (c) => {\n const slug = c.req.param(\"slug\");\n const file = c.req.param(\"file\");\n if (!SLUG_RE.test(slug) || !FILE_RE.test(file) || !file.endsWith(\".md\")) {\n return c.text(\"bad path\", 400);\n }\n return serveFile(`/skills/${slug}/memories/${file}`, import.meta.url);\n});\n\napp.get(\"/raw/:slug/templates/:file\", (c) => {\n const slug = c.req.param(\"slug\");\n const file = c.req.param(\"file\");\n if (!SLUG_RE.test(slug) || !FILE_RE.test(file)) {\n return c.text(\"bad path\", 400);\n }\n return serveFile(`/skills/${slug}/templates/${file}`, import.meta.url);\n});\n\napp.get(\"/raw/:slug/scripts/:file\", (c) => {\n const slug = c.req.param(\"slug\");\n const file = c.req.param(\"file\");\n if (!SLUG_RE.test(slug) || !FILE_RE.test(file)) {\n return c.text(\"bad path\", 400);\n }\n return serveFile(`/skills/${slug}/scripts/${file}`, import.meta.url);\n});\n\n// AI-generated card art via fal.ai (flux/schnell). Cached in blob storage.\n// Add FAL_KEY env var to enable; without it returns 503 and client falls\n// back to the emoji.\nconst BLOB_PREFIX = \"skill-binder/art/v1\";\n\napp.get(\"/art/:slug\", async (c) => {\n const slug = c.req.param(\"slug\");\n if (!SLUG_RE.test(slug)) return c.text(\"bad slug\", 400);\n const skills = await loadSkills();\n const skill = skills.find((s) => s.slug === slug);\n if (!skill) return c.text(\"not found\", 404);\n\n const force = c.req.query(\"force\") === \"1\";\n const blobKey = `${BLOB_PREFIX}/${slug}.jpg`;\n const headers = {\n \"content-type\": \"image/jpeg\",\n \"cache-control\": \"public, max-age=86400\",\n };\n\n if (!force) {\n try {\n const cached = await blob.get(blobKey);\n if (cached?.ok) {\n const buf = await cached.arrayBuffer();\n if (buf.byteLength > 0) return new Response(buf, { headers });\n }\n } catch {\n // not cached — fall through to generation\n }\n }\n\n const FAL_KEY = Deno.env.get(\"FAL_KEY\");\n if (!FAL_KEY) {\n return c.text(\n \"FAL_KEY not configured. Add one at /environment-variables?key=FAL_KEY\",\n 503,\n );\n }\n\n const falRes = await fetch(\"https://fal.run/fal-ai/flux/schnell\", {\n method: \"POST\",\n headers: {\n Authorization: `Key ${FAL_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n prompt: skill.artPrompt,\n image_size: \"square\",\n num_inference_steps: 4,\n num_images: 1,\n enable_safety_checker: true,\n }),\n });\n if (!falRes.ok) {\n const errBody = await falRes.text();\n console.error(\"fal error\", falRes.status, errBody);\n return c.text(`fal error: ${falRes.status}`, 502);\n }\n const data = await falRes.json();\n const url = data?.images?.[0]?.url;\n if (!url) return c.text(\"no image url in fal response\", 502);\n\n const imgRes = await fetch(url);\n if (!imgRes.ok) return c.text(`failed to fetch fal image: ${imgRes.status}`, 502);\n const buf = await imgRes.arrayBuffer();\n\n await blob.set(blobKey, new Uint8Array(buf));\n\n return new Response(buf, { headers });\n});\n\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\nexport default app.fetch;\n","label",[135],"6208b0aa-5925-11f1-9516-ee650bb23af1","README.md","6208b168-5925-11f1-9516-ee650bb23af1",6,["D",1779815251849],0,"# skill-binder\n\nA trading-card view of an agent skill repo.\n\n**Live:** [/](/) · **Raw JSON the agent reads:** [/api/skills](/api/skills) · **Raw SKILL.md for one card:** [/raw/daily-standup/SKILL.md](/raw/daily-standup/SKILL.md)\n\n## Why\n\nInspired by [Thariq's \"HTML is the new markdown\"](https://x.com/trq212/status/2052811606032269638). Agent skills today are just folders of markdown files — fine for the agent, bleak for the human looking at their own library. The data layer should stay markdown (so the agent picks up edits next session); the human view can be anything HTML lets you build. So this prototype keeps the same source and renders two faces:\n\n- **Agent face:** the raw `SKILL.md` markdown, served verbatim at `/raw//SKILL.md` and as JSON at `/api/skills`.\n- **Human face:** trading cards — flip to read, drag to reorder, search by trigger phrase. Memories sit on the back as stickers; ⚡ mana cost = setup needed; Lv 7+ cards get the gold foil treatment.\n\n## Files\n\n- `main.tsx` — Hono server. Two real routes (`/`, `/api/skills`), one raw-markdown route per skill, one static handler.\n- `data/skills.ts` — six demo skills, each with a real-feeling `SKILL.md` body, memories, trigger phrases.\n- `static/index.html` — the page shell + a `

Skill Binder

Memories (stickers)

Templates

Scripts

Diff · v50