Buttons

\n \n \n \n \n Link action\n

\n\n

Form

\n \n \n Public\n

\n\n

Card

Getting Started

hello-world

The simplest possible skill — a greeting and one knowledge file.

\n\n

Callout

\n Heads up — this is how a callout reads: a tinted surface with a matching hairline border. Swap blue for amber, red, or green to change the tone.\n

\n",[156,157,72,64],"pulls","branches",1,"forks","envVars",{"_171":26,"_173":26},"connections",{"_171":26,"_172":26},"count","unfilledCount","emptyCount",{"_33":386,"_13":353,"_62":347,"_43":-5,"_35":36,"_150":357,"_151":24,"_37":387,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":388,"_17":389},{"_33":378,"_13":379,"_62":380,"_43":347,"_35":36,"_150":381,"_151":24,"_37":382,"_39":26,"_65":207,"_153":383,"_66":30,"_154":-5,"_209":384,"_17":385},{"_33":370,"_13":371,"_62":372,"_43":347,"_35":36,"_150":373,"_151":24,"_37":374,"_39":26,"_65":207,"_153":375,"_66":30,"_154":-5,"_209":376,"_17":377},{"_33":362,"_13":363,"_62":364,"_43":347,"_35":36,"_150":365,"_151":24,"_37":366,"_39":26,"_65":207,"_153":367,"_66":30,"_154":-5,"_209":368,"_17":369},{"_33":354,"_13":355,"_62":356,"_43":347,"_35":36,"_150":357,"_151":24,"_37":358,"_39":26,"_65":207,"_153":359,"_66":30,"_154":-5,"_209":360,"_17":361},{"_33":344,"_13":345,"_62":346,"_43":347,"_35":36,"_150":348,"_151":24,"_37":349,"_39":26,"_65":207,"_153":350,"_66":30,"_154":-5,"_209":351,"_17":352},{"_33":340,"_13":339,"_62":333,"_43":-5,"_35":36,"_150":334,"_151":24,"_37":341,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":342,"_17":343},{"_33":330,"_13":331,"_62":332,"_43":333,"_35":36,"_150":334,"_151":24,"_37":335,"_39":26,"_65":207,"_153":336,"_66":30,"_154":-5,"_209":337,"_17":338},{"_33":326,"_13":325,"_62":319,"_43":-5,"_35":36,"_150":320,"_151":24,"_37":327,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":328,"_17":329},{"_33":316,"_13":317,"_62":318,"_43":319,"_35":36,"_150":320,"_151":24,"_37":321,"_39":26,"_65":207,"_153":322,"_66":30,"_154":-5,"_209":323,"_17":324},{"_33":312,"_13":156,"_62":242,"_43":-5,"_35":36,"_150":165,"_151":24,"_37":313,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":314,"_17":315},{"_33":308,"_13":294,"_62":288,"_43":242,"_35":36,"_150":289,"_151":24,"_37":309,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":310,"_17":311},{"_33":304,"_13":277,"_62":298,"_43":288,"_35":36,"_150":299,"_151":24,"_37":305,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":306,"_17":307},{"_33":295,"_13":296,"_62":297,"_43":298,"_35":36,"_150":299,"_151":24,"_37":300,"_39":26,"_65":21,"_153":301,"_66":30,"_154":-5,"_209":302,"_17":303},{"_33":286,"_13":228,"_62":287,"_43":288,"_35":36,"_150":289,"_151":24,"_37":290,"_39":26,"_65":21,"_153":291,"_66":30,"_154":-5,"_209":292,"_17":293},{"_33":282,"_13":254,"_62":248,"_43":242,"_35":36,"_150":165,"_151":24,"_37":283,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":284,"_17":285},{"_33":278,"_13":277,"_62":271,"_43":248,"_35":36,"_150":272,"_151":24,"_37":279,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":280,"_17":281},{"_33":268,"_13":269,"_62":270,"_43":271,"_35":36,"_150":272,"_151":24,"_37":273,"_39":26,"_65":21,"_153":274,"_66":30,"_154":-5,"_209":275,"_17":276},{"_33":264,"_13":263,"_62":258,"_43":248,"_35":36,"_150":165,"_151":24,"_37":265,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":266,"_17":267},{"_33":255,"_13":256,"_62":257,"_43":258,"_35":36,"_150":165,"_151":24,"_37":259,"_39":26,"_65":207,"_153":260,"_66":30,"_154":-5,"_209":261,"_17":262},{"_33":246,"_13":228,"_62":247,"_43":248,"_35":36,"_150":249,"_151":24,"_37":250,"_39":26,"_65":21,"_153":251,"_66":30,"_154":-5,"_209":252,"_17":253},{"_33":241,"_13":157,"_62":149,"_43":242,"_35":36,"_150":230,"_151":24,"_37":243,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":244,"_17":245},{"_33":148,"_13":72,"_62":71,"_43":149,"_35":36,"_150":40,"_151":24,"_37":238,"_39":26,"_65":73,"_153":-5,"_66":30,"_154":-5,"_209":239,"_17":240},{"_33":159,"_13":64,"_62":63,"_43":71,"_35":36,"_150":40,"_151":24,"_37":235,"_39":26,"_65":21,"_153":161,"_66":30,"_154":-5,"_209":236,"_17":237},{"_33":227,"_13":228,"_62":229,"_43":149,"_35":36,"_150":230,"_151":24,"_37":231,"_39":26,"_65":21,"_153":232,"_66":30,"_154":-5,"_209":233,"_17":234},{"_33":220,"_13":221,"_62":222,"_43":-5,"_35":36,"_150":111,"_151":24,"_37":223,"_39":165,"_65":21,"_153":224,"_66":30,"_154":-5,"_209":225,"_17":226},{"_33":212,"_13":213,"_62":86,"_43":-5,"_35":36,"_150":214,"_151":24,"_37":215,"_39":26,"_65":216,"_153":217,"_66":30,"_154":-5,"_209":218,"_17":219},{"_33":202,"_13":203,"_62":204,"_43":-5,"_35":36,"_150":205,"_151":24,"_37":206,"_39":26,"_65":207,"_153":208,"_66":30,"_154":-5,"_209":210,"_17":211},"5f17aa0f-c817-4e73-8a6d-6b8780f20301","og.ts","6bf1ce32-6454-11f1-8f6c-1607ee4eb77e",6,["D",1781044917611],"script","// Open Graph / Twitter card image (1200×630), generated with satori (JSX→SVG)\n// + resvg-wasm (SVG→PNG). Served at GET /og.png. Light/blue theme to match the\n// Skill Library UI. Modeled on stevekrouse/agentfax's og.ts.\nimport satori from \"npm:satori@0.10.13\";\nimport { initWasm, Resvg } from \"npm:@resvg/resvg-wasm@2.6.2\";\nimport { SKILLS } from \"./lib/skills.ts\";\n\n// Static-weight TTFs (variable fonts crash satori's opentype.js).\nconst SANS_BOLD_TTF =\n \"https://raw.githubusercontent.com/google/fonts/main/ofl/ptsans/PT_Sans-Web-Bold.ttf\";\nconst SANS_REGULAR_TTF =\n \"https://raw.githubusercontent.com/google/fonts/main/ofl/ptsans/PT_Sans-Web-Regular.ttf\";\nconst RESVG_WASM_URL = \"https://unpkg.com/@resvg/resvg-wasm@2.6.2/index_bg.wasm\";\n\nlet fontsPromise: Promise<{ bold: ArrayBuffer; regular: ArrayBuffer }> | null = null;\nfunction loadFonts() {\n if (!fontsPromise) {\n const get = (url: string, label: string) =>\n fetch(url).then((r) => {\n if (!r.ok) throw new Error(`${label} font fetch failed: ${r.status}`);\n return r.arrayBuffer();\n });\n fontsPromise = Promise.all([\n get(SANS_BOLD_TTF, \"Bold\"),\n get(SANS_REGULAR_TTF, \"Regular\"),\n ]).then(([bold, regular]) => ({ bold, regular }));\n }\n return fontsPromise;\n}\n\nlet wasmPromise: Promise | null = null;\nfunction ensureResvg(): Promise {\n if (!wasmPromise) {\n wasmPromise = fetch(RESVG_WASM_URL)\n .then((r) => {\n if (!r.ok) throw new Error(`resvg wasm fetch failed: ${r.status}`);\n return r.arrayBuffer();\n })\n .then((bytes) => initWasm(bytes));\n }\n return wasmPromise;\n}\n\nfunction pill(text: string) {\n return {\n type: \"div\",\n props: {\n style: {\n display: \"flex\",\n fontSize: 26,\n color: \"#404040\",\n background: \"#f5f5f5\",\n border: \"1px solid #e5e5e5\",\n borderRadius: \"999px\",\n padding: \"12px 28px\",\n },\n children: text,\n },\n };\n}\n\n// A stacked-cards \"library\" glyph as a satori SVG node (0–32 grid), scaled to `size`.\nfunction stackIcon(size: number) {\n return {\n type: \"svg\",\n props: {\n width: size,\n height: size,\n viewBox: \"0 0 32 32\",\n children: [\n { type: \"rect\", props: { x: 9, y: 3, width: 18, height: 22, rx: 3, fill: \"#bfdbfe\" } },\n { type: \"rect\", props: { x: 6, y: 6, width: 18, height: 22, rx: 3, fill: \"#60a5fa\" } },\n { type: \"rect\", props: { x: 3, y: 9, width: 18, height: 22, rx: 3, fill: \"#2563eb\" } },\n { type: \"rect\", props: { x: 6, y: 14, width: 12, height: 1.6, rx: 0.8, fill: \"#ffffff\" } },\n { type: \"rect\", props: { x: 6, y: 18, width: 9, height: 1.6, rx: 0.8, fill: \"#ffffff\" } },\n { type: \"rect\", props: { x: 6, y: 22, width: 11, height: 1.6, rx: 0.8, fill: \"#dbeafe\" } },\n ],\n },\n };\n}\n\nasync function renderSvg(): Promise {\n const { bold, regular } = await loadFonts();\n const count = SKILLS.length;\n const tree = {\n type: \"div\",\n props: {\n style: {\n width: \"1200px\",\n height: \"630px\",\n display: \"flex\",\n background: \"#fafafa\",\n padding: \"56px\",\n fontFamily: \"Sans\",\n },\n children: [\n {\n type: \"div\",\n props: {\n style: {\n flex: 1,\n display: \"flex\",\n flexDirection: \"row\",\n alignItems: \"center\",\n justifyContent: \"space-between\",\n padding: \"0 72px\",\n border: \"1px solid #e5e5e5\",\n borderRadius: \"28px\",\n background: \"#ffffff\",\n },\n children: [\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", flexDirection: \"column\", maxWidth: \"640px\" },\n children: [\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 28, fontWeight: 700, color: \"#2563eb\", letterSpacing: \"6px\" },\n children: \"SKILL LIBRARY\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 104, fontWeight: 700, color: \"#171717\", letterSpacing: \"-3px\", marginTop: \"18px\" },\n children: \"Skill Library\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 36, color: \"#525252\", lineHeight: 1.35, marginTop: \"20px\" },\n children: \"A shared library of reusable agent skills. Fork it and drop in your own.\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", flexDirection: \"row\", gap: \"14px\", marginTop: \"34px\" },\n children: [pill(`${count} skill${count === 1 ? \"\" : \"s\"}`), pill(\"Built on Val Town\")],\n },\n },\n ],\n },\n },\n stackIcon(300),\n ],\n },\n },\n ],\n },\n };\n return await satori(tree as any, {\n width: 1200,\n height: 630,\n fonts: [\n { name: \"Sans\", data: bold, weight: 700, style: \"normal\" },\n { name: \"Sans\", data: regular, weight: 400, style: \"normal\" },\n ],\n });\n}\n\nexport async function renderOg(): Promise {\n try {\n const svg = await renderSvg();\n await ensureResvg();\n const png = new Resvg(svg).render().asPng();\n return new Response(png, {\n headers: { \"content-type\": \"image/png\", \"cache-control\": \"public, max-age=3600\" },\n });\n } catch (err) {\n const msg = err instanceof Error ? err.stack || err.message : String(err);\n return new Response(`OG render failed:\\n${msg}`, {\n status: 500,\n headers: { \"content-type\": \"text/plain\" },\n });\n }\n}\n","children",[],[203],"fc00783c-59fb-4da4-8802-0e58fafad58e","http.tsx",4,["D",1781044883172],"http","/** @jsxImportSource npm:hono@4/jsx */\n// Skill Library — thin HTTP orchestrator (generic, public template).\n// Routes only; markup lives in components/, data + helpers in lib/skills.ts,\n// client JS in frontend/client.js. Fork this val to build your own library.\n// See README.md.\n\nimport { Hono } from \"npm:hono@4\";\nimport { marked } from \"npm:marked@15\";\nimport { readFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\nimport { parseVal } from \"https://esm.town/v/std/utils/index.ts\";\n\nimport {\n buildCopyPayload,\n esc,\n exampleAsset,\n findSkill,\n parseFrontmatter,\n readSkillFile,\n} from \"./lib/skills.ts\";\nimport { renderOg } from \"./og.ts\";\nimport { Layout } from \"./components/Layout.tsx\";\nimport { Home } from \"./components/Home.tsx\";\nimport { SkillDetail } from \"./components/SkillDetail.tsx\";\nimport { FileView } from \"./components/FileView.tsx\";\n\nconst app = new Hono();\napp.onError((err) => Promise.reject(err)); // full stack traces in logs\n\nconst origin = (c: { req: { url: string } }) => new URL(c.req.url).origin;\n\n// ── Public assets ────────────────────────────────────────────────────────────\n\napp.get(\"/client.js\", async () => {\n const js = await readFile(\"/frontend/client.js\", import.meta.url);\n return new Response(js, {\n headers: { \"content-type\": \"text/javascript; charset=utf-8\" },\n });\n});\n\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// Social card image (Open Graph / Twitter)\napp.get(\"/og.png\", () => renderOg());\n\n// ── Pages ────────────────────────────────────────────────────────────────────\n\napp.get(\"/\", (c) =>\n c.html(\n \n \n ,\n ));\n\napp.get(\"/skills/:slug\", async (c) => {\n const skill = findSkill(c.req.param(\"slug\"));\n if (!skill) return c.notFound();\n const rawMd = await readSkillFile(skill.slug, \"SKILL.md\");\n if (!rawMd) return c.notFound();\n const { body } = parseFrontmatter(rawMd);\n const html = await marked.parse(body);\n const payload = buildCopyPayload(skill, rawMd); // payload keeps frontmatter — that IS the skill format\n // Live preview = the skill's first assets/*.html (see lib/skills.ts).\n const examplePath = exampleAsset(skill);\n const exampleHtml = examplePath\n ? (await readSkillFile(skill.slug, examplePath)) ?? undefined\n : undefined;\n return c.html(\n \n \n ,\n );\n});\n\n// Standalone, embeddable render of a skill's live example asset. Same design\n// system, no surrounding app chrome.\napp.get(\"/skills/:slug/example\", async (c) => {\n const skill = findSkill(c.req.param(\"slug\"));\n const examplePath = skill && exampleAsset(skill);\n if (!skill || !examplePath) return c.notFound();\n const html = await readSkillFile(skill.slug, examplePath);\n if (html == null) return c.notFound();\n return c.html(\n \n \n ← {skill.name}\n \n

\n {skill.name} — examples\n

\n ,\n );\n});\n\napp.get(\"/skills/:slug/files/*\", async (c) => {\n const skill = findSkill(c.req.param(\"slug\"));\n if (!skill) return c.notFound();\n const path = c.req.path.replace(`/skills/${skill.slug}/files/`, \"\");\n if (!skill.files.includes(path)) return c.notFound();\n const content = await readSkillFile(skill.slug, path);\n if (content === null) return c.notFound();\n const isMarkdown = path.endsWith(\".md\");\n const rendered = isMarkdown\n ? await marked.parse(parseFrontmatter(content).body)\n : `

${esc(content)}

`;\n return c.html(\n \n \n ,\n );\n});\n\nexport default app.fetch;\n",[],[213],"aec15f98-c150-4ee9-bee2-4412a486a67e","README.md","bf2513ca-6454-11f1-9006-1607ee4eb77e",["D",1781045797493],"# Skill Library (template)\n\nA forkable directory of reusable **agent skills**. Each skill is a folder of\nMarkdown and code; the app renders every skill's `SKILL.md` and gives you a\none-click **Copy skill** button that puts a ready-to-run payload on your\nclipboard.\n\n🔗 **Live:** https://templates--576a3bb6645411f181421607ee4eb77e.web.val.run\n\n## Getting started\n\nThe intended way to manage this library is with an agent — let it add, edit, and\ndeploy skills for you. You don't need to touch the file tree by hand.\n\n1. **Remix this val** to get your own copy.\n2. **Connect your coding agent** with the Val Town plugin, which bundles the\n Val Town MCP server and platform skills. It works with Claude Code, Codex,\n and Cursor:\n\n ```sh\n npx plugins add val-town/plugins\n ```\n\n See the [plugin guide](https://docs.val.town/guides/prompting/plugin/) for\n per-agent install commands.\n3. **Ask it to add a skill.** For example:\n\n > Add a skill called `pr-summarizer` to my skills val that reads a GitHub PR\n > diff and writes a release note. Put the prompt in `SKILL.md` and a fetch\n > script in `scripts/`.\n\n The agent reads the existing skills for the pattern, creates\n `skills//` with the right files, registers it in the `SKILLS` manifest,\n and deploys — all in place.\n\nPrefer not to set up a local agent? Open this val on val.town and talk to\n**Townie** in the sidebar instead. Same workflow, in the browser.\n\nYou can also just edit a skill by hand — every file opens in the Val Town editor,\ne.g. [`skills/hello-world/SKILL.md`](https://www.val.town/x/dcm31/skills/code/skills/hello-world/SKILL.md).\nA skill's body is plain Markdown, so tweaking wording or fixing a typo is a\ntwo-second edit that deploys on save.\n\n## How a skill is structured\n\nA skill is a folder under `skills//` following the standard Agent-Skills\nlayout, so it stays valid and discoverable by agents reading it outside this app:\n\n```\nskills//\n SKILL.md # entry point — what the skill does and the flow to follow\n scripts/ # runnable code the agent writes locally\n knowledge/ # reference docs the agent reads for context\n assets/ # optional HTML fragment, shown as a live example\n```\n\nOnly `SKILL.md` is required. Each skill is also listed in the `SKILLS` array in\n`lib/skills.ts` (`slug`, `name`, `description`, `category`, and its `files`),\nwhich drives the home grid, the sidebar file tree, and the copy payload — your\nagent keeps this in sync for you.\n\n## Live examples\n\nA skill can ship a live preview — a working UI rendered right on its page, so you\ncan see what the skill produces instead of just reading about it.\n\nTo add one, drop an HTML fragment in the skill's `assets/` folder (e.g.\n`assets/showcase.html`) and list it in the manifest's `files`. That's it — the\napp renders the first `assets/*.html` it finds as an **Examples** panel on the\nskill page, and also serves it standalone (and embeddable in an iframe) at\n`/skills//example`.\n\nThe fragment is just HTML; it can pull in CSS or a `\n \n

History · assets