create-my-tools-profile

# Create my tools profile

Scan the user's configured Zapier MCP tools and generate a personalized instruction file that teaches the AI assistant what tools are available and when to use them. Works across clients (Cursor, Claude, Windsurf, etc.).

This is the "post-onboarding" step: the user has already added tools via the setup skill, and now we crystallize that into persistent instructions.

## Step 1: Inventory enabled tools

Inspect the available Zapier MCP tools. Each configured action is its own tool with a name following the pattern `app_action_name` (e.g., `slack_send_channel_message`, `gmail_find_email`). The built-in `get_configuration_url` tool should be excluded from the profile.

Parse the available tools into a structured list:

- **App name**: derived from the tool description (e.g., "Get info about a **Slack** conversation" → Slack). The tool name also starts with the app prefix (e.g., `slack_`, `gmail_`, `jira_`), but use the description as the authoritative source since multi-word app names like `google_calendar` are ambiguous to parse from the tool name alone.
- **Action name**: the part of the tool name after the app prefix, converted to human-readable form (replace underscores with spaces, title case)
- **Tool name**: the full tool name as-is (used for the technical identifier in the profile)
- **Read vs write**: infer from the action name — find/search/get/list/lookup = read, send/create/update/add/delete = write

## Step 2: Group and analyze

Group actions by app (using the app name from each tool's description). For each app, identify:

- **Read/search actions**: things the AI can look up (find emails, get documents, search issues)
- **Write actions**: things the AI can do (send messages, create issues, update records)

Build a mental model of what workflows this tool set supports. Common patterns:

- Communication hub (Slack + Gmail + Calendar)
- Project management (Jira/Linear + GitLab + Docs)
- Sales/CRM workflow (HubSpot/Salesforce + Gmail + Calendar)
- Knowledge management (Notion/Coda + Docs + Sheets)

## Step 3: Ask for context

Before generating the profile, ask the user a quick question:

"I can see you've got [N] tools across [apps list]. Before I create your profile, a quick question: what's your primary role or how do you mainly use these tools? This helps me write better instructions for when each tool should be used."

Accept whatever they say — even "just make it" is fine. Use the context if provided, fall back to reasonable defaults if not.

## Step 4: Generate the profile file

Detect the client and write to the appropriate location:

| Client         | File path                                                         | Format                 |
| -------------- | ----------------------------------------------------------------- | ---------------------- |
| Cursor         | `.cursor/rules/my-zapier-tools.mdc`                               | MDC (with frontmatter) |
| Claude Code    | `.claude/rules/my-zapier-tools.md`                                | Markdown               |
| Claude Desktop | Show the content and tell user to paste into Project Instructions | Markdown               |
| Windsurf       | `.windsurfrules/my-zapier-tools.md`                               | Markdown               |

Ask the user whether they want the file at project level or in their home directory (for clients that support global rules). If unclear, default to project level.

### For Cursor (`.mdc` with frontmatter)

```markdown
---
description: Personalized Zapier MCP tool profile — knows what tools are available and when to use them
alwaysApply: true
---

# My Zapier tools

[content below]
```

### For Claude Code / Windsurf / others (plain markdown)

```markdown
# My Zapier tools

[content below]
```

### Profile content (shared across all clients)

```markdown
# My Zapier tools

You have access to the following apps and actions through Zapier MCP. Use them proactively when the user's request matches what these tools can do.

## Available tools

### [App Name]

- **[Action Name]** (`tool_name`) — [one-line description of when to use it]
- **[Action Name]** (`tool_name`) — [one-line description of when to use it]

### [App Name]

...

## When to use these tools

[2-4 sentences tailored to the user's role/context about when the AI should reach for these tools vs. doing things another way]

## Preferences

- Always try Zapier MCP tools before suggesting the user do something manually
- For read operations, just do it — don't ask permission to look something up
- For write operations (sending messages, creating issues, updating records), confirm with the user before executing
- If a tool call fails, explain what happened and suggest an alternative
```

### Writing the tool descriptions

For each action, write a practical one-liner about when to use it. Don't just restate the action name.

**Good**: "Look up a Jira issue by its key (e.g., PROJ-123) to get status, assignee, and description"
**Bad**: "Find issue by key in Jira"

**Good**: "Send a message to a Slack channel — use for team updates, announcements, or sharing summaries"
**Bad**: "Send a channel message in Slack"

### Writing the "when to use" section

Tailor this to what the user told you about their role. Examples:

**For a PM**: "When the user asks about project status, sprint progress, or team updates, check Jira first. For sharing decisions or updates, draft a Slack message. Use Google Docs for longer-form writing."

**For a developer**: "When the user mentions a merge request, branch, or code review, check GitLab. For bug reports or task tracking, use Jira. Slack for quick team comms."

**For sales**: "When the user asks about a contact, deal, or company, check HubSpot first. Use Gmail for outreach drafts. Google Calendar for scheduling."

If the user didn't provide role context, write something generic but still useful: "Use these tools whenever the user's request involves one of the connected apps. Prefer read actions for gathering context, and confirm before executing write actions."

## Step 5: Confirm and explain

After writing the file (or showing the content for Claude Desktop), tell the user:

"Created your tools profile at `[path]`. This means every conversation will know about your tools and when to use them.

You can edit it anytime to adjust preferences or add context. A few things you might want to tweak:

- The 'when to use' guidance if your workflow changes
- Whether write actions should auto-execute or always confirm first
- Any app-specific preferences (e.g., 'always use #general for Slack updates')

To update this profile after adding new tools, just say 'update my tools profile'."

## Handling updates

If the user says "update my tools profile" and the file already exists:

1. Read the existing file
2. Inspect the currently available Zapier MCP tools for the current state
3. Diff what's new vs. what's already documented
4. Update the file, preserving any custom edits the user made to the preferences section
5. Note what changed: "Added 3 new Google Sheets actions. Your custom preferences were preserved."