skills ecosystem. It gives your agent a versioned workflow guide for operating Surnex instead of leaving it to work out how the pieces fit together each session.
Install
What the skill covers
Thesurnex skill helps your agent:
- Understand that most tools read stored data, not live results — reading rankings doesn’t check rankings, and a figure can legitimately be a day old
- Know that creating a project starts its first collection straight away and spends allowance doing it: rankings arrive within minutes, everything else as each job finishes
- Know that audits, web vitals, domain analysis, and keyword research never run on a schedule — after a project’s first run, they have to be started explicitly
- Recognise which tools spend plan allowance, and avoid the failure mode that matters — looping a billable tool over a keyword list
- Handle organization ambiguity: with several memberships the server refuses to guess rather than billing the wrong one
- Understand it acts as you, carrying your role, so a member’s connection can’t create or delete projects
- Project tools (adding keywords and prompts, AI searches) start on the project’s own market for that service when you leave location and language out; research and trends lookups for any domain default to the United States, so pass them explicitly there
Why use a skill
Without one, your agent works Surnex out from tool descriptions alone. A description says what one tool does; it can’t say what order to do things in, what a call costs, or which empty result is a finding rather than a fault. With a skill you get:- A stable reference for how the product fits together
- Use-case guidance instead of tool-by-tool guessing
- Explicit caveats — what’s asynchronous, what’s irreversible, what’s billable
- A versioned source of truth that updates as Surnex changes
Repository
The public source lives at github.com/surnex/skills.Notes
- Pair it with the MCP server — the skill explains the workflows, the connector executes them
- The skills ecosystem is supported by Claude Code and claude.ai. Through another client, the MCP server still ships the essentials in its own tool descriptions
- The skill assumes OAuth. It won’t help an agent configured with an API key, which the MCP endpoint refuses