Generate skill files so your AI coding assistant can use your connected integrations.

Generate Skills for Your IDE

In this page, you'll generate skill files that teach your AI coding assistant (Claude Code, Cursor, Codex, etc.) how to use your connected integrations.

What are skill files?

Skill files are markdown documents that describe what tools are available and how to call them. AI coding assistants read these files automatically and use them when you ask for help with things like "check my email" or "send a Slack message."

Each skill file contains:

A description of what the integration does
A list of available tools with their parameters
Example commands showing how to call each tool

Generate the files

Navigate to your project directory and run:

cd your-project
supyagent skills generate

If the CLI detects multiple AI tool folders, you'll see a prompt:

Detected AI tool folders:

  1. Claude Code  (.claude/skills/)
  2. Cursor       (.cursor/skills/)

Select folders (comma-separated numbers, or 'a' for all): a

Pick the ones you use, or type a to write to all of them.

After generation, you'll see:

✓ Generated 4 skills (17 tools) in 2 location(s)
  .claude/skills/
    supy-cloud-gmail/SKILL.md
    supy-cloud-calendar/SKILL.md
    supy-cloud-drive/SKILL.md
    supy-cloud-slack/SKILL.md
  .cursor/skills/
    supy-cloud-gmail/SKILL.md
    supy-cloud-calendar/SKILL.md
    supy-cloud-drive/SKILL.md
    supy-cloud-slack/SKILL.md

Your AI coding assistant will automatically use these skills when you ask about connected services.

What a skill file looks like

Here's a simplified example of a generated supy-cloud-gmail/SKILL.md:

supy-cloud-gmail/SKILL.md

---
name: supy-gmail
description: >-
  Use supyagent to interact with Gmail. Available actions: list messages,
  get a message, send a message. Use when the user asks to interact with Gmail.
---

# Gmail

Execute tools: `supyagent service run <tool_name> '<json>'`

Output: `{"ok": true, "data": ...}` on success, `{"ok": false, "error": "..."}` on failure.

### gmail_list_messages

List messages from Gmail inbox.

| Parameter     | Type   | Required | Description          |
|---------------|--------|----------|----------------------|
| `max_results` | number | no       | Max messages to return |

```bash
supyagent service run gmail_list_messages '{"max_results": 5}'
```

### gmail_send_message

Send an email via Gmail.

| Parameter | Type   | Required | Description       |
|-----------|--------|----------|-------------------|
| `to`      | string | yes      | Recipient email   |
| `subject` | string | yes      | Message subject   |
| `body`    | string | yes      | Message body      |

```bash
supyagent service run gmail_send_message '{"to": "user@example.com", "subject": "Hi", "body": "Hello!"}'
```

Where the files go

AI Tool	Folder
Claude Code	`.claude/skills/`
Cursor	`.cursor/skills/`
Codex	`.agents/skills/`
Copilot	`.copilot/skills/`
Windsurf	`.windsurf/skills/`

Shortcut flags

# Write to all detected folders without prompting
supyagent skills generate --all

# Write to a specific folder
supyagent skills generate --output .claude/skills

# Preview without writing files
supyagent skills generate --stdout

Regenerating skills

Run supyagent skills generate again whenever you:

Connect a new integration on your dashboard
Disconnect an integration
Want to update to the latest tool definitions

The command overwrites existing skill files, so it's always safe to re-run.

Next step

Pick a quickstart guide for your IDE:

Or build your own agent app:

Node SDK Quickstart — Scaffold a full AI chatbot with npx create-supyagent-app

Generate Skills for Your IDE

On this page