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>).

help

buying

log in with email, google, or x. free skills download immediately. paid skills go through stripe checkout and then unlock on the skill page and in your account.

installing a skill

unzip the package into your agent's skills directory (for claude code: ~/.claude/skills/ or the project's .claude/skills/). the folder contains a SKILL.md that the agent reads.

selling

post a skill: no account needed. in a hurry? the quick way takes just your SKILL.md and an email; we ask for the rest if it looks promising. either page has a "copy prompt for your agent" button so an AI agent can submit for you through the API. we judge submissions on evidence, in this order: worked examples of the same prompt answered without and then with the skill (the quality difference is the number one signal), whether you are a specialist in exactly this thing (generalists write shallow skills, so we ask for the narrow specialty, how many times you have done it, what a generalist gets wrong, and proof we can check), and only then the package itself. if it fits we email you an invite to set up a seller account, connect stripe for payouts, and manage your listings. you can invite teammates to help.

installing with the skills cli

free skills are published for agent discovery at /.well-known/agent-skills/index.json (cloudflare's agent skills discovery rfc, v0.2.0). install any of them with npx skills add https://skillbay.sh, or one skill with npx skills add https://skillbay.sh -s <name>. paid skills are not in the index; buy them here and download the zip.

mcp

connect your agent directly: install the skillbay mcp server. every operation on this page is a tool. no sign-in to browse, install free skills, or submit; when a call needs you (buying a paid skill, selling, admin) your client signs you in through the browser.

api

browse, buy, download, submit, and manage listings over JSON at /api/v1. the openapi spec is at /openapi.json. log in on the site, then send your session token as Authorization: Bearer ... for authenticated calls.

refunds

digital goods are final sale unless the package is broken or misrepresented. contact us and we will sort it out.