Skill
preset-admin
Manage Preset teams, workspaces, memberships, invites, role identifiers, seat checks, and audit logs through direct Management API calls. Use only for direct…
@preset-ioView SkillDevelopment
Skill
/preset-mcp-troubleshooting
Troubleshoot Superset MCP health, validation, permission, response-size, and bug-report workflows. Use only for MCP tool workflows; do not use for direct API work.
Install
$ npx -y skills add preset-io/agent-skills --skill preset-mcp-troubleshooting --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/preset-mcp-troubleshooting
Context preview
The summary Claude sees to decide when to auto-load this skill.
Troubleshoot Superset MCP health, validation, permission, response-size, and bug-report workflows. Use only for MCP tool workflows; do not use for direct API work.
SKILL.md
preset-mcp-troubleshooting.SKILL.mdname: preset-mcp-troubleshooting
description: Troubleshoot Superset MCP health, validation, permission, response-size, and bug-report workflows. Use only for MCP tool workflows; do not use for direct API work.
preset-mcp-troubleshooting
Use when Superset MCP tools fail, return validation errors, return permission errors, or produce oversized responses.
Always
- Stay on MCP troubleshooting; do not switch to direct APIs.
- Use `health_check` first for service availability.
- Use `generate_bug_report` when the user says MCP is broken or asks how to report an issue.
- Treat permission denied as authoritative.
- No permission workaround: do not search alternate tools, REST APIs, or direct APIs to expose restricted data.
- Use live tool schemas to fix validation errors.
Decision Rules
- Connection or availability issue: `health_check`.
- Tool parameter/schema issue: inspect the live tool schema and retry only with corrected MCP arguments.
- Permission issue: explain the denied operation and stop; do not search for alternate tools to expose restricted data.
- Response too large: rerun with narrower filters, identifiers, page sizes, or row limits.
- Repro/report request: `generate_bug_report`.
Workflow Order
1. Classify the failure: availability, validation, permission, unsupported capability, oversized response, or unknown error. 2. Use the smallest diagnostic MCP tool. 3. Explain the failure in user terms. 4. For permission denied, stop or generate bug report when requested. 5. Stop before direct API or REST API calls. 6. Retry only when the correction is clear and remains on MCP.
Retrieve
- Troubleshooting guide: [references/troubleshooting.md](references/troubleshooting.md)
Read more
name: preset-mcp-troubleshooting description: Troubleshoot Superset MCP health, validation, permission, response-size, and bug-report workflows. Use only for MCP tool workflows; do not use for direct API work.
preset-mcp-troubleshooting
Use when Superset MCP tools fail, return validation errors, return permission errors, or produce oversized responses.
Always
- Stay on MCP troubleshooting; do not switch to direct APIs.
- Use `health_check` first for service availability.
- Use `generate_bug_report` when the user says MCP is broken or asks how to report an issue.
- Treat permission denied as authoritative.
- No permission workaround: do not search alternate tools, REST APIs, or direct APIs to expose restricted data.
- Use live tool schemas to fix validation errors.
Decision Rules
- Connection or availability issue: `health_check`.
- Tool parameter/schema issue: inspect the live tool schema and retry only with corrected MCP arguments.
- Permission issue: explain the denied operation and stop; do not search for alternate tools to expose restricted data.
- Response too large: rerun with narrower filters, identifiers, page sizes, or row limits.
- Repro/report request: `generate_bug_report`.
Workflow Order
1. Classify the failure: availability, validation, permission, unsupported capability, oversized response, or unknown error. 2. Use the smallest diagnostic MCP tool. 3. Explain the failure in user terms. 4. For permission denied, stop or generate bug report when requested. 5. Stop before direct API or REST API calls. 6. Retry only when the correction is clear and remains on MCP.
Retrieve
- Troubleshooting guide: [references/troubleshooting.md](references/troubleshooting.md)
Ships withpreset-io-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.
Get the whole plugin
Other skills on preset-io-agent-skills.
@preset-ioView SkillSkill
preset-api
Prepare direct Preset API access: auth, JWT exchange, base URLs, pagination, Rison parameters, response handling, and shared API setup. Use only for direct API…
@preset-ioView SkillSkill
preset-cortex-agents
Use Snowflake Cortex Agent REST and SQL APIs for listing, describing, creating, updating, deleting, running agents, streaming responses, and SQL wrappers. Use…
@preset-ioView SkillSkill
preset-dashboards
Inspect Preset workspace dashboards, charts, dashboard composition, screenshots, thumbnails, chart data, and chart/dashboard operation routing through direct…
@preset-ioView SkillSkill
preset-database-connec…
Inspect or route Preset database connection configuration, validation, OAuth, upload, create, update, and delete workflows through direct Superset API calls.…
@preset-ioView SkillSkill
preset-datasets
Inspect Preset workspace datasets, database metadata, schemas, tables, columns, metrics, and dataset/database workflow routing through direct Superset API…
@preset-ioView Skill