.codex-plugin/plugin.json

{
  "name": "preset-api-skills",
  "version": "0.5.0",
  "description": "Preset API skills for explicit direct Preset Management API and Superset workspace API workflows only. Do not use for MCP-only work; MCP-only work must stay on available MCP tooling unless the user explicitly approves switching to direct API calls.",
  "author": {
    "name": "Preset",
    "url": "https://preset.io/"
  },
  "homepage": "https://github.com/preset-io/agent-skills",
  "repository": "https://github.com/preset-io/agent-skills",
  "license": "Apache-2.0",
  "keywords": [
    "preset",
    "superset",
    "api",
    "admin",
    "dashboards",
    "datasets",
    "sqllab",
    "import-export",
    "embedding",
    "guest-tokens",
    "rls",
    "security"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Preset API Skills",
    "shortDescription": "Preset workflows via REST API",
    "longDescription": "Preset API Skills teaches coding agents to work with Preset and Apache Superset through their public REST APIs: the Preset Management API for teams, workspaces, memberships, invites, roles, and audit logs, and each workspace's Superset API for dashboards, charts, datasets, database connections, SQL Lab, import/export, and embedded analytics.\n\nThe package contains 15 focused skills. `preset-api` covers authentication (exchanging an API token for a short-lived JWT), base URLs, pagination, Rison query parameters, and the shared safety policy; the other skills build on it for workspace discovery, administration, version-aware Superset API use, metadata and data-returning reads, SQL execution, import/export, embedded dashboards, guest tokens, row-level security, and role or permission changes.\n\nReads run directly with row limits and summarized output. Mutations, imports, exports, credential-bearing reads, guest-token creation, and SQL that is not a confidently classified single-statement SELECT require an explicit confirmation that names the exact target, payload, and expected effect, and credentials and tokens are never printed.\n\nIntended for developers, data engineers, and platform teams who automate Preset or Apache Superset with HTTP requests, curl, or Python.\n\nLimitations: the skills assume a Preset API token is available in the execution environment, and they act only on teams and workspaces that token can already reach. They do not bundle credentials, and they do not create Preset accounts or handle billing.",
    "developerName": "Preset",
    "category": "Developer Tools",
    "capabilities": [
      "Authenticate with the Preset Management API",
      "Discover Preset teams and workspaces",
      "Administer team members, invites, and roles",
      "Inspect dashboards, charts, and datasets",
      "Run guarded SQL Lab queries",
      "Configure embedded dashboards and guest tokens"
    ],
    "websiteURL": "https://preset.io/",
    "supportURL": "https://preset.io/support/",
    "privacyPolicyURL": "https://preset.io/privacy-policy/",
    "termsOfServiceURL": "https://preset.io/terms-of-service/",
    "defaultPrompt": [
      "Authenticate with the Preset API",
      "List the workspaces in my Preset team",
      "List dashboards in a Preset workspace"
    ],
    "brandColor": "#00A5B5",
    "brandColorDark": "#00A5B5",
    "logo": "./assets/icon-512x512.png",
    "composerIcon": "./assets/icon-512x512.png"
  }
}