{
  "markdown": "# skills.yusuke.run\n\nA personal, curated collection of **skills** — small, focused Markdown documents that describe how to do specific things with specific tools. Designed to be consumed by coding agents (Claude Code, Cursor, etc.) and by humans.\n\nDeployed at <https://skills.yusuke.run>.\n\n## What is a \"skill\"?\n\nA skill is a `SKILL.md` Markdown document that answers a focused question like:\n\n- \"How do I build a server-rendered UI with Hono?\"\n- \"How do I combine Inertia.js with Hono?\"\n- \"How do I structure a Cloudflare Workers project with D1?\"\n\nEach skill is small, opinionated (it reflects how _I_ like to do it), and includes links to the canonical human-facing documentation so an agent can drill deeper when needed. The on-disk layout (`skills/<name>/SKILL.md`) matches the `vercel-labs/skills` CLI, so the catalog is also installable into Claude Code, Cursor, and other agents via `npx skills add`.\n\n## How agents should use this\n\nThere are two ways to consume the catalog. Pick whichever the agent / tool supports.\n\n**Fetch on demand (no installation).** Drop this into your agent at the start of a new project:\n\n> `fetch https://skills.yusuke.run/start.md to start a new project`\n\nThe landing page (`/`) shows this same line, ready to copy. From `/start.md` the agent discovers every available skill and drills down into the ones it needs.\n\n**Install as local skills.** For tools that integrate with the `skills` CLI (Claude Code, Cursor, OpenCode, Codex, ...):\n\n```sh\nnpx skills add yusukebe/skills\n```\n\nThis installs the catalog into the agent's local skills directory so the agent can match on `description` without an HTTP fetch.\n\n## URL shape\n\n- `GET /` — human-facing landing with the copy-pasteable agent prompt.\n- `GET /start.md` — agent entry point. Markdown: usage instructions + skill index.\n- `GET /skills/:name` — a single skill (Markdown).\n- `GET /skills/:name.json` — the same skill as JSON (frontmatter + body).\n- `GET /skills.json` — machine-readable full index.\n\nAll Markdown content is served as `text/markdown; charset=utf-8`.\n\n## Repository layout\n\n```text\n.\n├── AGENTS.md                # Instructions for AI agents working in this repo\n├── README.md                # This file\n├── skills/                  # One directory per skill, each containing SKILL.md\n│   └── <name>/SKILL.md\n├── scripts/\n│   └── build-registry.ts    # Scans skills/*/SKILL.md, writes src/registry.generated.ts\n├── src/\n│   ├── index.ts             # Hono routes\n│   ├── landing.ts           # Renders the / and /start.md responses\n│   ├── landing.template.md  # Template for /\n│   ├── start.template.md    # Template for /start.md (with {{skills}} placeholder)\n│   ├── frontmatter.ts       # Minimal YAML frontmatter parser\n│   ├── registry.generated.ts # Build output — frontmatter for every skill (gitignored)\n│   └── skills.ts            # Reads the generated registry, fetches bodies via env.ASSETS\n└── wrangler.jsonc\n```\n\n## Adding a new skill\n\nSee [AGENTS.md](./AGENTS.md) for the full contribution procedure. The short version:\n\n1. Create `skills/<name>/SKILL.md` with the frontmatter shown in AGENTS.md.\n2. `bun run dev` to preview (the registry is regenerated automatically from `skills/*/SKILL.md`).\n3. Push to `main` — Cloudflare Workers Builds handles the deploy.\n\nFrom another working project, an agent can also open a PR for you — see the [`contribute`](https://skills.yusuke.run/skills/contribute) skill.\n\n## Develop\n\n```sh\nbun install\nbun run dev      # local preview at http://localhost:8787\n```\n\n## Deploy\n\nDeployment is automated via **Cloudflare Workers Builds**. Any push to `main` builds and deploys the Worker.\n\nInitial setup (one-time, in the Cloudflare dashboard):\n\n1. **Workers & Pages** → the `skills` Worker → **Settings** → **Builds**.\n2. **Connect** the GitHub repository `yusukebe/skills`.\n3. **Branch:** `main`.\n4. **Build command:** leave empty (or `bun install`).\n5. **Deploy command:** `bun run deploy`.\n\n`bun run deploy` regenerates `src/registry.generated.ts` from the current `skills/*/SKILL.md` and then runs `wrangler deploy`. The build step is bundled into the `deploy` script so a manual local deploy can't forget it either.\n",
  "bytes": 4176,
  "sha": "2bbe4ecb3ff92e9192849cf4d2dcda3d9e685015332e89afcbb4c2c253c74bca",
  "repo_slug": "yusukebe/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_yusukebe_skills_hono_inertia_809c647a/readme"
}