Preset CLI Skills

Preset Agent Skills

Agent guidance for working with Preset, Apache Superset, and Superset MCP tools. 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 name used by plugin install commands.

Claude Desktop

Claude Desktop installs these as individual Skill ZIP uploads.

1. Open Claude Desktop → Settings → Connectors, then click the Customize link.
2. In Customize, select Skills in the sidebar, click the + next to "Skills", then choose Create skill → Upload a skill.
3. Download the per-skill ZIPs from the latest GitHub Release.
4. 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.
5. Restart Claude Desktop after uploading or replacing skill ZIPs.

Claude Code (CLI)

From any Claude Code session: