CLI Agent Skill
Add the Surfable CLI to your AI coding assistant in one step. Works with Claude, Cursor, GitHub Copilot, Windsurf, and any agent that accepts context files.
Add to your AI coding assistant
Drop this SKILL.md into Claude, Cursor, Copilot, or any AI agent and it will know how to manage your Surfable account from the terminal — ingesting sites, running searches, rotating API keys, and more.
https://surfable.ai/surfable-cli-skill.mdRawTip: In Cursor, create .cursor/rules/surfable-cli.mdc and paste the file. In Claude Projects, add the raw URL as a knowledge source. For Copilot, add to .github/copilot-instructions.md.
What is a SKILL.md?
A SKILL.md is a structured prompt file you drop into your AI coding assistant's context.
It tells your agent exactly what tools are available, how to use them, and what patterns to follow —
so instead of guessing commands, it knows your CLI inside out.
This skill teaches your agent to:
- Ingest and manage website sources in your Surfable knowledge base
- Run semantic search queries to test your indexed content
- Manage API keys, crawl schedules, content, and routing rules
- Check quota and analytics without touching the dashboard
- Work non-interactively in CI/CD pipelines using
SURFABLE_API_KEY
How to Add It
Different tools have different conventions:
| Tool | Where to put it |
|---|---|
| Cursor | .cursor/rules/surfable-cli.mdc |
| GitHub Copilot | .github/copilot-instructions.md |
| Claude Projects | Add raw URL as a knowledge source |
| Claude (one-off) | Paste file contents at the start of a conversation |
| Windsurf | .windsurfrules |
| Gemini CLI | GEMINI.md or .agents/skills/ |
| Any agent | Add URL to system context or paste inline |
The Skill File
Use the panel below to copy the file or open it directly in your preferred tool.
Get the skill
Add to your AI coding assistant
Drop this SKILL.md into Claude, Cursor, Copilot, or any AI agent and it will know how to manage your Surfable account from the terminal — ingesting sites, running searches, rotating API keys, and more.
https://surfable.ai/surfable-cli-skill.mdRawTip: In Cursor, create .cursor/rules/surfable-cli.mdc and paste the file. In Claude Projects, add the raw URL as a knowledge source. For Copilot, add to .github/copilot-instructions.md.