yusukebe/skills

This repository is a personal collection of short how-to notes that the author, Yusuke, calls skills. Each skill is a small Markdown file that answers one focused question, things like how to build a server-rendered UI with the Hono framework, how to combine Inertia.js with Hono, or how to lay out a Cloudflare Workers project that uses the D1 database. They are intentionally opinionated, written the way the author personally likes to do things, and they link out to the official documentation for anything deeper. The collection is meant to be consumed by AI coding agents like Claude Code or Cursor as well as by humans reading the web. It is deployed as a small website at skills.yusuke.run, and each skill is also reachable as plain Markdown or JSON at predictable URLs. The landing page shows a one-line prompt that you can paste into your agent at the start of a new project, which tells it to fetch a start.md file and walk through the available skills from there. For tools that already integrate with the vercel-labs skills CLI, you can install the whole catalog locally with npx skills add yusukebe/skills. After that, the agent can pick the right skill by matching on its description without making an HTTP call. The code behind the site is a small Hono app deployed on Cloudflare Workers. The skills directory holds one folder per skill, each containing a SKILL.md with YAML frontmatter. A build script scans those files and generates a registry that the worker reads at runtime. Deployment is automated through Cloudflare Workers Builds: any push to the main branch triggers a build that regenerates the registry and runs wrangler deploy.