.codex-plugin/plugin.json

{
  "name": "preset-cli-skills",
  "version": "0.5.0",
  "description": "Preset CLI skills for explicit shell, scripting, and CI/CD workflows driven by the `sup` CLI (PyPI package `superset-sup`). Use only for CLI workflows; do not use for MCP-only work or as a substitute for direct API calls when the user wants HTTP/SDK code.",
  "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",
    "sup",
    "cli",
    "shell",
    "scripting",
    "ci-cd",
    "automation"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Preset CLI Skills",
    "shortDescription": "Preset workflows via sup CLI",
    "longDescription": "Preset CLI Skills teaches coding agents a repeatable way to drive Preset and Apache Superset from the `sup` command line tool (PyPI package `superset-sup`). Use it for shell one-liners, batch asset exports, ad-hoc SQL, and CI/CD automation against a Preset workspace.\n\nThe package contains two skills. `preset-cli` covers the non-destructive foundation: installing and authenticating the CLI, selecting a workspace, choosing an output format, running read-only queries, and exporting charts, dashboards, and datasets as YAML. `preset-cli-mutations` covers state-changing work, including pushing asset YAML, destructive flags such as `--force` and `--overwrite`, and cross-workspace `sync`. It requires a dry run or preview plus an explicit confirmation before any write, and it keeps credentials out of command output.\n\nIntended for data engineers, analytics engineers, and platform teams who already manage Preset or Apache Superset assets as code.\n\nLimitations: the skills assume the `sup` CLI is installed and authenticated in the execution environment, and they act only on workspaces the signed-in user can already reach. They do not bundle credentials, and they do not create or administer Preset accounts.",
    "developerName": "Preset",
    "category": "Developer Tools",
    "capabilities": [
      "Install and authenticate the sup CLI",
      "Select and inspect Preset workspaces",
      "Export charts, dashboards, and datasets as YAML",
      "Run ad-hoc SQL against a workspace",
      "Push asset YAML to a workspace",
      "Sync assets between workspaces"
    ],
    "websiteURL": "https://preset.io/",
    "supportURL": "https://preset.io/support/",
    "privacyPolicyURL": "https://preset.io/privacy-policy/",
    "termsOfServiceURL": "https://preset.io/terms-of-service/",
    "defaultPrompt": [
      "Install and authenticate the Preset sup CLI",
      "Export my Preset dashboards and charts as YAML",
      "Run a SQL query against my Preset workspace"
    ],
    "brandColor": "#00A5B5",
    "brandColorDark": "#00A5B5",
    "logo": "./assets/icon-512x512.png",
    "composerIcon": "./assets/icon-512x512.png"
  }
}