Documentation

Everything you need to use SkillSlap

Quick Start

Add the MCP server to your agent

One command for Claude Code. For Cursor/Cline, see the config below.

claude mcp add skillslap -- npx skillslap-mcp

Authenticate

Run skillslap login — opens a browser tab, click Authorize, and your token is saved automatically. Or create one manually in Settings → API Tokens.

npx skillslap login

Saves a sk_live_... token to ~/.config/skillslap/credentials. The MCP server picks it up automatically — no env var needed.

Search and install skills

Ask your agent, or use the CLI directly.

npx skillslap search "code review"
npx skillslap install <skill-id>

Authentication

All authenticated API calls use a personal API token (sk_live_...). These live forever until revoked.

CLI login
Easiest

npx skillslap login

Opens browser, click Authorize. Token saved to ~/.config/skillslap/credentials.

Dashboard token

Settings → API Tokens → New token → copy sk_live_....

Set as SKILLSLAP_TOKEN env var in your MCP config.

API usage

Authorization: Bearer sk_live_...

Pass as a header on any API call. Works everywhere cookies don't.

MCP Setup

After running skillslap login, no extra config is needed. To pass a token explicitly, set SKILLSLAP_TOKEN.

▲ Claude Code

# No token needed after skillslap login
claude mcp add skillslap -- npx skillslap-mcp

# Or with explicit token
claude mcp add skillslap -e SKILLSLAP_TOKEN=sk_live_... -- npx skillslap-mcp

Cursor / Cline / Windsurf

Add to your MCP config (.cursor/mcp.json, Cline settings, etc.):

{
  "mcpServers": {
    "skillslap": {
      "command": "npx",
      "args": ["skillslap-mcp"],
      "env": {
        "SKILLSLAP_TOKEN": "sk_live_..."
      }
    }
  }
}

Omit the env block if you've run skillslap login.

CLI Reference

Command	Description
npx skillslap login	Authenticate via browser — saves token automatically
npx skillslap search <query>	Search the Slap Stack
npx skillslap install <id>	Install a skill into the current project
npx skillslap list	Show installed skills in this project
npx skillslap publish <file>	Publish a skill from a local markdown file

Key Concepts

Skills

Markdown files with structured instructions for AI agents — prompts, workflows, decision trees. Installed directly into your project via the CLI or MCP.

Slaps

Bookmark a skill with a slap. Your slapped skills are accessible via list_my_slaps in the MCP server.

Focus Pool

Total tips a skill has received. Higher focus = more community interest. Tips go directly to creators and contributors.

Focus Tiers

Dormant — <$20/mo

Low Focus — $20–50/mo

High Focus — $50–100/mo

Trending — >$100/mo

Forking

Fork any skill to customize it. Attribution to the original is preserved, and tips can flow across the fork chain.

Verification

Three tiers: system (AI-powered), creator, and community. Run verification locally with your own API key.

Publishing a Skill

Write a markdown file with a # H1 title and publish it:

npx skillslap publish ./MY_SKILL.md --tags="python,testing" --status=active

Or publish directly from the browser at /skill/new.

Ready to dive in?

Browse the Slap Stack or publish your first skill.

Browse Skills Publish a Skill