attio-mcp-usage — Claude Code skill: Attio MCP workflow patterns
A skill with workflow patterns and error-prevention rules for the Attio MCP server, so multi-step calls stop failing on syntax.
npx skills add kesslerio/attio-mcp-server --skill attio-mcp-usage -a claude-codeWhat attio-mcp-usage does
This skill covers the universal side of working with the Attio MCP server: how to lay out multi-step workflows, how to call the tools correctly, and how to build integrations on top. It ships four references — resources/workflows.md for workflow patterns, resources/golden-rules.md for the error-prevention system, resources/tool-reference.md for tool signatures, and resources/integration-patterns.md as a pattern index. A fifth file, resources/patterns/README.md, routes you to the right pattern by keyword.
The split matters. This skill answers how; attio-workspace-schema answers what — attribute slugs, select and status values, list IDs, read-only fields. Universal patterns alone will not fill in your workspace's slugs, so the two are meant to be read together.
Worth installing once the Attio MCP server is already connected and you keep hitting call errors or guessing at step order. The skill does not replace the server itself: get a working Attio MCP server first, then add these patterns.
What it helps with
- plan a multi-step Attio workflow
- debug a failing MCP tool call
- look up Attio MCP tool signatures
- build an integration on top of Attio
- connect generic patterns to your workspace fields
Example prompts for the agent
- Help me plan a multi-step flow: create a company in Attio and link a contact to it
- This Attio MCP tool call keeps erroring — find the pattern for my case
- Show me the tool signature for looking up a record in Attio
How to install attio-mcp-usage
1Skills CLI (Vercel)
npx skills add kesslerio/attio-mcp-server --skill attio-mcp-usage -a claude-code2Manually: put the files in place
~/.claude/skills/attio-mcp-usage/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/attio-mcp-usage/
1Skills CLI (Vercel)
npx skills add kesslerio/attio-mcp-server --skill attio-mcp-usage -a codex2Manually: put the files in place
.agents/skills/attio-mcp-usage/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add kesslerio/attio-mcp-server --skill attio-mcp-usage -a cursor2Manually: put the files in place
.cursor/skills/attio-mcp-usage/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install kesslerio/attio-mcp-server attio-mcp-usage2Manually: put the files in place
.github/skills/attio-mcp-usage/SKILL.md1Skills CLI (Vercel)
npx skills add kesslerio/attio-mcp-server --skill attio-mcp-usage -a gemini-cli2Platform CLI
gemini skills install https://github.com/kesslerio/attio-mcp-server --path skills/attio-mcp-usageManually: put the files in place
.devin/skills/attio-mcp-usage/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add kesslerio/attio-mcp-server --skill attio-mcp-usage -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about attio-mcp-usage
How do I install attio-mcp-usage in Claude?
Run npx skills add kesslerio/attio-mcp-server --skill attio-mcp-usage -a claude-code. The skill file lands at ~/.claude/skills/attio-mcp-usage/SKILL.md.
What does attio-mcp-usage do?
It provides universal patterns for the Attio MCP server: how to structure multi-step workflows, prevent common API errors, use MCP tools correctly, and build integrations.
How is it different from attio-workspace-schema?
This skill covers the how — generic patterns and tool calls. attio-workspace-schema covers the what — your workspace's attribute slugs, option values and list IDs. You need both for real data.
Source text
SKILL.md · Apache-2.0
--- name: attio-mcp-usage description: Provides universal workflow patterns and best practices for using the Attio MCP server. Complements the attio-workspace-schema skill with HOW-TO guidance for MCP tools and error prevention. --- # Attio MCP Usage Guide Universal workflow patterns and best practices for the Attio MCP server. ## Purpose Teaches universal patterns for: - Structuring multi-step workflows - Preventing common API errors - Using MCP tools correctly - Building integrations ## Related Skills **attio-workspace-schema** - Reference for YOUR workspace-specific: - Attribute slugs and types - Select/status option values - List IDs and names - Read-only fields > Always check the schema skill for workspace-specific data ## Quick Links - [Workflows](resources/workflows.md) - Universal workflow patterns - [Golden Rules](resources/golden-rules.md) - Error prevention system - [Tool Reference](resources/tool-reference.md) - MCP tool signatures - [Integration Patterns](resources/integration-patterns.md) - Pattern index ## Pattern Selection See [Pattern Selection Guide](resources/patterns/README.md) for keyword-based routing to the right pattern for your workflow. ## When to Use This Skill - Planning multi-step workflows - Troubleshooting API errors - Learning MCP tool syntax - Building integrations - Understanding best practices ## Key Principles 1. **Schema skill = WHAT** (your specific fields/lists) 2. **Usage skill = HOW** (universal patterns) 3. **Cross-reference** when you need workspace specifics
© kesslerio · Apache-2.0 · kesslerio/attio-mcp-server
