Generate use-case-specific Attio workflow skills from templates. Use when creating new skills for lead qualification, deal management, customer onboarding, or custom Attio workflows.
Generate use-case-specific Attio workflow skills from templates. Use when creating new skills for lead qualification, deal management, customer onboarding, or custom Attio workflows.
license
Apache-2.0 (see LICENSE.txt for attribution)
Attio Skill Generator
A meta-skill that generates customized Attio workflow skills tailored to your workspace.
When to Use This Skill
Use this skill when you want to:
Create a lead qualification skill for your workspace
Generate a deal management workflow skill
Build a customer onboarding skill
Create custom Attio workflow skills
Available Use Cases
Use Case
Primary Object
Related Objects
Description
lead-qualification
companies
people
Qualify and score inbound leads
deal-management
deals
companies, people
Manage deals through pipeline stages
customer-onboarding
companies
people, deals
Structured onboarding workflows
Generation Process
Step 1: Gather Workspace Schema (Targeted)
You (Claude) must discover the workspace schema for the specific use-case. The Python scripts are sandboxed and cannot access APIs or MCP tools.
IMPORTANT: Gather data for the PRIMARY OBJECT only. Do not gather full schemas for all objects.
Determine what to gather based on use-case:
Use Case
Gather Attributes For
Gather Lists?
lead-qualification
companies
NO (unless requested)
deal-management
deals
NO (unless requested)
customer-onboarding
companies
NO (unless requested)
FIRST: Check for attio-workspace-schema skill
Before using MCP tools, check if the attio-workspace-schema skill is installed by looking for its resource files.
Option A: Use attio-workspace-schema skill (PREFERRED - faster, no API calls)
Extract attributes and select/status options for that object
Build JSON schema structure
Option B: Query MCP tools (FALLBACK - only if no schema skill)
If attio-workspace-schema skill is NOT available:
1. Call records_discover_attributes for the PRIMARY OBJECT ONLY
- deal-management → records_discover_attributes for "deals"
- lead-qualification → records_discover_attributes for "companies"
- customer-onboarding → records_discover_attributes for "companies"
2. For select/status fields on the primary object, call records_get_attribute_options
Do NOT call get-lists unless the user specifically asks for list-related functionality. Lists are organizational containers, not essential to core workflows like deal management or lead qualification.
Do NOT gather:
Full attribute schemas for secondary/related objects (companies, people for deal-management)
Lists (unless user explicitly requests list functionality)
Note on related objects: Deal management involves linked companies and people, but these relationships are handled through record-reference fields on the deals object. You don't need full attribute lists for related objects.
Step 2: Build Schema JSON
Structure the discovered data as JSON for the generator. This structure is CRITICAL for correct output.
⚠️ REQUIRED FIELDS for each attribute:
api_slug - The API field name (required)
type - Field type: text, status, select, number, date, etc. (required)
is_required - Boolean, true if field is required (optional, defaults to false)
is_multiselect - Boolean, true if field accepts multiple values (optional, defaults to false)
options - Array of option objects for status/select fields (REQUIRED for status/select types!)
⚠️ OPTIONS ARE CRITICAL: For status and select type fields, you MUST include the options array with the actual option titles from the workspace. Without this, the generated skill won't show pipeline stages or dropdown values!
Note: The skill includes record-reference fields (associated_company, contacts) that link to companies and people, but without documenting those objects' full schemas. Lists are not included unless explicitly requested.
Template Customization
Templates are in resources/templates/. You can customize:
SKILL.template.md - Main skill metadata and structure
workflows.template.md - Workflow step patterns
tool-reference.template.md - MCP tool reference
examples.template.md - Example interactions
Use-case configurations are in resources/use-cases/:
lead-qualification.yaml
deal-management.yaml
customer-onboarding.yaml
Dependencies
The generator requires these Python packages:
chevron - Handlebars-compatible templating
pyyaml - YAML parsing
Install if needed: pip install chevron pyyaml
Validation Checklist
Before packaging, verify the generated skill:
All object slugs exist in the user's workspace
All list IDs are valid UUIDs from the workspace
Attribute slugs match the workspace schema
Select/status options use exact titles from workspace