You are helping the user use skillbay (https://skillbay.sh), a curated marketplace of AI agent skills: SKILL.md packages that teach coding agents how to do a job. Every skill is reviewed by a person and shows before-and-after evidence: the same prompt answered without and with the skill.

Everything on the site is available as a JSON API. Full OpenAPI 3.1 spec: https://skillbay.sh/openapi.json (fetch it if you need exact field names). Base URL: https://skillbay.sh/api/v1. Errors come back as {"error":{"code","message"}}.

If your client supports MCP, connecting to the skillbay MCP server is simpler than raw HTTP: https://skillbay.sh/mcp, every operation as a tool, no sign-in to browse, install free skills, or submit; the server asks for sign-in only when a call needs it (buying a paid skill, selling, admin). See https://skillbay.sh/mcp for how to add it. With it connected, use the skillbay_* tools instead of the calls below.

TASK: find skills for the user.
- List categories: GET https://skillbay.sh/api/v1/categories
- Search: GET https://skillbay.sh/api/v1/skills?q=<words> (full-text, ranked; words match as prefixes; add &category=<slug> or &free=1 to filter; results include a "snippet" showing why each matched)
- Newest: GET https://skillbay.sh/api/v1/skills
- Details: GET https://skillbay.sh/api/v1/skills/<slug> returns the description, the SKILL.md text, the file list, and "examples": the before-and-after evidence. Read the examples and judge whether the change in output is worth it before recommending a skill.
- Free skills are also published for direct install: the index at https://skillbay.sh/.well-known/agent-skills/index.json, or run "npx skills add https://skillbay.sh" (add "-s <name>" for one skill). The files of any approved free skill are at https://skillbay.sh/skills/<slug>/SKILL.md and https://skillbay.sh/skills/<slug>/<path>.
Report back the top matches with title, price, seller, and a one-line take on the evidence. To buy or download a paid skill, see the skill page's prompt (https://skillbay.sh/skill/<slug>).

skillbay blog

notes on AI agent skills from the people who review them.

latest top discussionsarchive feed

3 posts matching "writing". clear

what makes a skill worth paying for: the before-and-after test

The review rules behind every skillbay listing, and how to write a SKILL.md that passes them: one prompt, answered without and with the skill, has to come out clearly better.

SEP 16 · Nick Khami 30 views

skillbay is open: a marketplace for AI agent skills, with proof

A curated marketplace of skills for coding agents, where every listing is reviewed by a person and shows the same prompt answered without and with the skill.

SEP 16 · Nick Khami 37 views

selling to AI agents over HTTP 402: x402 with Stripe holding the money

The request flow behind x402 on skillbay: a 402 with a Stripe deposit address, a signed USDC transfer, a facilitator, and a PaymentIntent. No wallets anywhere on the marketplace.

SEP 16 · Nick Khami 30 views

recommendations

other places worth reading on agents and skills.

Anthropic engineering - how Claude Code and agent skills are built, from the people building them.
Simon Willison's weblog - daily, careful notes on what LLM tooling actually does.
Latent Space - the AI engineer newsletter and podcast.
The Cloudflare blog - agent readiness, MCP, and the plumbing of the agentic web.
Stripe blog - machine payments and how agents pay for things.