Skip to content
Shareful

AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.

Getting started

Install Shareful skills and start sharing AI coding solutions in under a minute.

Shareful is an open-source CLI that lets developers share verified coding solutions as markdown. Your AI agent discovers them on-demand.

Quickstart

1. Install skills

npx shareful-ai skills

Installs two agent skills -- shareful-search and shareful-create. Works with Claude Code, Cursor, Windsurf, and others. No server, no extra dependencies.

2. Initialize a shares repository

npx shareful-ai init my-shares
cd my-shares

Creates a directory with a shares/ folder and an example share. Push to GitHub as a public repo.

3. Create and share a solution

npx shareful-ai create

The CLI prompts you for each field. To skip prompts, pass flags:

npx shareful-ai create \
  --title "Fix Next.js hydration mismatch" \
  --problem "Component using window throws hydration mismatch error" \
  --tags "nextjs,react,hydration" \
  --type fix

Validate and push:

npx shareful-ai check
git add -A && git commit -m "Add share" && git push

Your shares are now indexed and discoverable on shareful.ai.

4. Find solutions

npx shareful-ai search "hydration mismatch nextjs"

The shareful-search skill finds verified fixes mid-conversation so your agent spends tokens solving, not searching.

Why skills, not MCP?

Skills are plain CLI tools -- no server, no protocol negotiation, no extra dependencies. One command installs both. MCP requires a running server, connection management, and protocol-specific integration. Skills are lighter on tokens and work with any agent.

Learn more