Using Copilot, Cursor, Windsurf, or another AI-powered editor? Add the Surfable customer skill to give your agent full context on the API, widget embed, authentication, error handling, and quota management — without copy-pasting docs manually.

Skill publishing in progress. The customer-facing SKILL.md is being authored (DX.1). Once published, the raw URL below will be live.

GitHub Copilot (VS Code)

Add to your .github/copilot-instructions.md or reference directly in a chat:

# In .github/copilot-instructions.md
@file https://raw.githubusercontent.com/surfableai/surfable/main/.agents/skills/surfable-customer/SKILL.md

Cursor

Add to your .cursorrules or use @docs to point at the skill URL:

# .cursorrules
For any Surfable API integration, refer to:
https://raw.githubusercontent.com/surfableai/surfable/main/.agents/skills/surfable-customer/SKILL.md

Windsurf / Other Editors

Most editors that support custom instructions or rule files accept a raw URL reference. Point them at the same skill URL above.

What the skill covers

Once published, the skill contains:

Quick Start steps with working code examples
All API endpoints with request/response shapes
Widget embed (HTML, React, and direct API patterns)
Authentication — JWT and API key flows
Quota and billing — credit costs per operation, how to check balance
Common error codes and how to handle them

Next Steps

Integrations — embed options without an AI assistant
API Reference — full endpoint listing