Skills Generate
Generate skill files that give AI coding assistants access to your cloud integrations.
Skills Generate
The skills generate command creates SKILL.md files that AI coding assistants (Claude Code, Cursor, Codex, Copilot, Windsurf) use to discover and call your Supyagent Cloud tools.
supyagent skills generate
supyagent skills generateOptions
| Flag | Type | Default | Description |
|---|---|---|---|
--output, -o | string | auto-detect | Output directory for skill files |
--stdout | flag | — | Print skill content to stdout instead of writing files |
--all | flag | — | Write to all detected AI tool folders without prompting |
AI Tool Folder Detection
The command scans your project root for known AI tool directories:
| AI Tool | Detection Folder | Skills Output |
|---|---|---|
| Claude Code | .claude/ | .claude/skills/ |
| Cursor | .cursor/ | .cursor/skills/ |
| Codex | .agents/ | .agents/skills/ |
| Copilot | .copilot/ | .copilot/skills/ |
| Windsurf | .windsurf/ | .windsurf/skills/ |
If multiple AI tool folders are detected, the CLI prompts you to choose which ones to populate. Use --all to write to all of them without prompting.
If no AI tool folders are detected, the CLI prompts you for a custom output path (or defaults to .claude/skills/ in non-interactive mode).
Generated File Format
Each connected integration gets its own skill directory with a SKILL.md file:
.claude/skills/
├── supy-cloud-gmail/
│ └── SKILL.md
├── supy-cloud-calendar/
│ └── SKILL.md
├── supy-cloud-slack/
│ └── SKILL.md
└── supy-cloud-github/
└── SKILL.mdEach SKILL.md contains YAML frontmatter and tool documentation:
---
name: Gmail
description: Use supyagent to interact with Gmail. Available actions: list emails, get a specific email, send an email.
---
# Gmail
Run tools with `supyagent service run <tool_name> '<json_args>'`.
Output format: JSON with `ok`, `data`, and `error` fields.
## gmail_list_messages
List emails from Gmail inbox.
| Name | Type | Required | Description |
|------|------|----------|-------------|
| maxResults | integer | no | Maximum number of messages |
| query | string | no | Gmail search query |
**Example:**
\`\`\`bash
supyagent service run gmail_list_messages '{"maxResults": 10}'
\`\`\`Provider Grouping
Tools are grouped by integration. Providers with multiple services (Google, Microsoft) are split by service:
| Provider | Skill Files |
|---|---|
supy-cloud-gmail, supy-cloud-calendar, supy-cloud-drive, supy-cloud-docs, supy-cloud-sheets, supy-cloud-slides | |
| Microsoft | supy-cloud-outlook, supy-cloud-microsoft-calendar, supy-cloud-onedrive |
| Slack | supy-cloud-slack |
| GitHub | supy-cloud-github |
| Platform | supy-cloud-platform-search, supy-cloud-platform-compute, supy-cloud-platform-web, supy-cloud-platform-multimodal |
Cleanup
When you run skills generate again, it automatically removes stale supy-cloud-* skill directories before writing new ones. This keeps your skill files in sync with your currently connected integrations.
Examples
# Interactive — detect AI tools, prompt for selection
supyagent skills generate
# Write to all detected AI tool folders
supyagent skills generate --all
# Write to a specific directory
supyagent skills generate --output .claude/skills
# Print to stdout (for piping or inspection)
supyagent skills generate --stdout