Preset Agent Skills
Agent guidance for working with Preset, Apache Superset, Superset MCP tools, and Snowflake Cortex Agents. The skills work across Claude, OpenAI Codex, Cursor, GitHub Copilot, Snowflake Cortex Code CLI, and Gemini CLI from a single source.
What's included
The installable packages are:
preset-api-skills — focused skills for direct Preset Management API, Superset workspace API, and Snowflake Cortex API workflows.preset-mcp-skills — focused skills for Superset MCP tool workflows.preset-cli-skills — focused skills for Preset CLI (sup) shell, scripting, CI/CD, read/export, SQL, and gated mutation workflows.
API package highlights:
preset-api — authenticate with the Preset Management API (JWT exchange, base URLs, pagination, safety policy). Required by the other skills.preset-workspaces — list teams and workspaces, resolve workspace hostnames, inspect membership and status.preset-admin — manage team memberships, workspace lifecycle, invites, roles, and audit logs with confirmation-gated mutations.preset-dashboards — inspect dashboards, charts, datasets, and chart data with safety boundaries.preset-sql-execution — run or route SQL Lab execution, result retrieval, exports, and saved-query mutations with explicit approval.
See the API package README for the full catalog (17 skills covering datasets, SQL Lab, embedding, guest tokens, RLS, database connections, role/permission changes, destructive imports, and Snowflake Cortex Agents).
MCP package highlights:
preset-mcp — route MCP intent and enforce the no-direct-API boundary.preset-mcp-discovery — use MCP health, list, detail, schema, and chart-type discovery tools.preset-mcp-visualization — create Explore links, chart previews, saved charts, and chart updates through MCP.preset-mcp-sqllab — run SQL, open SQL Lab links, and save SQL queries through MCP.preset-mcp-troubleshooting — handle MCP health, validation, permission, response-size, and bug-report workflows.
See the MCP package README for the full 8-skill catalog.
CLI package highlights:
preset-cli — install and authenticate sup, select workspaces, choose output formats, run read-only asset workflows, and handle SQL/data-returning reads with safety boundaries.preset-cli-mutations — handle sup push, --force, --overwrite, user push/invite, and cross-workspace sync with mandatory preview and confirmation.
See the CLI package README for the full 2-skill catalog.
Install or load each package from its plugin directory, not from the repository root. Use preset-api-skills for direct API workflows. Use preset-mcp-skills for MCP workflows. Use preset-cli-skills for explicit sup CLI workflows. Do not use API or CLI skills as a fallback for MCP-only work, and do not use MCP or CLI skills for direct API work.
Supported clients
| Client | How skills load | Install |
|---|
| Claude Code (CLI) | Plugin marketplace | /plugin marketplace add → /plugin install |
| OpenAI Codex | Plugin marketplace | codex plugin marketplace add → codex plugin add |
| Claude Desktop | Individual Skill ZIPs | Upload in Skills settings |
| Claude.ai web | Individual Skill ZIPs | Upload in Skills settings |
| Cursor | Project rule | Remote Rule (GitHub) import |
| GitHub Copilot | Repo-local instructions | Copy copilot-instructions.md |
| Snowflake Cortex Code CLI | Custom skills | cortex skill add / /skill add |
| Gemini CLI | GEMINI.md context import | @-import package AGENTS.md files |
Installation
Find your client in the table above, then follow its section below. The GitHub repository is preset-io/agent-skills; preset-agent-skills is the marketplace/package name used by plugin install commands.
Claude Desktop
Claude Desktop installs these as individual Skill ZIP uploads.
- Open Claude Desktop → Settings → Connectors, then click the Customize link.
- In Customize, select Skills in the sidebar, click the + next to "Skills", then choose Create skill → Upload a skill.
- Download the per-skill ZIPs from the latest GitHub Release.
- Upload each skill ZIP one by one. Start with only the skills relevant to your work, such as
preset-api.zip for direct API workflows, preset-mcp.zip / preset-mcp-discovery.zip for MCP workflows, or preset-cli.zip / preset-cli-mutations.zip for sup CLI workflows.
- Restart Claude Desktop after uploading or replacing skill ZIPs.
Claude Code (CLI)
From any Claude Code session:
