feat(marketing): source agent skills from superset-sh/skills, drop monorepo copy

Merged
SA
4mo ago
+73-34

Summary

  • The official agent skills now live in the public superset-sh/skills repo (the convention official vendors use on skills.sh: anthropics/skills, cloudflare/skills, openai/skills). The previous private superset-sh/skills (sales-outreach commands) was renamed to superset-sh/sales-skills; GitHub redirects both old names.
  • The repo contains two skills — the existing superset CLI skill (moved verbatim) and a new superset-mcp skill (MCP setup one-liners, auth flow, tool catalog) — and is registered on skills.sh (npx skills add superset-sh/skills verified: both skills install).
  • This PR removes the monorepo copy at skills/superset/ and repoints consumers:
    • /.well-known/agent-skills/index.json + /{skill}/SKILL.md now fetch from the skills repo with 1h ISR (single dynamic route replaces the hardcoded one; serves both skills; unknown names 404; source outage → 503 with ISR serving stale-good in practice).
    • The Claude Code plugin (plugins/superset) symlinked the deleted path — it now vendors a real copy, since plugin distribution needs the file on disk.
    • llms.txt lists the skills repo + install command.

Why / Context

skills.sh only counts self-published official skills (published from the vendor's own org). Ours lived inside the monorepo, so scans saw only "1 community skill with potential relation." Follow-up to the agent-readiness series (#5910/#5912/#5917).

Manual QA Checklist

  • npx skills add superset-sh/skills --all installs both skills into .agents/skills/ (universal + Claude Code symlinks)
  • /.well-known/agent-skills/index.json lists both skills with descriptions + sha256 digests, sourced live from GitHub
  • /{skill}/SKILL.md serves text/markdown for both; unknown skill name → 404
  • bun run lint exits 0 (caught and fixed the plugin's broken symlink)

Known Limitations

  • Two copies of the CLI skill now exist (skills repo = canonical, plugin vendors one). If the skill changes, update the skills repo first and re-copy into plugins/superset/skills/superset/.
  • The skills repo carries ELv2 (copied from the monorepo). Most vendors ship skills under MIT since the content is meant to be copied into user projects — flip it if you prefer.

Summary by cubic

Move official agent skills to the public superset-sh/skills repo and drop the monorepo copy. Marketing now fetches skills from GitHub and serves both superset and superset-mcp; docs now point agents to the repo and install command.

  • New Features

    • /.well-known/agent-skills/{skill}/SKILL.md dynamically fetches from superset-sh/skills with 1h ISR; supports superset and superset-mcp (unknown → 404, source outage → 503).
    • /.well-known/agent-skills/index.json builds from live content with sha256 digests and includes repository: https://github.com/superset-sh/skills.
  • Migration

    • Removed skills/superset/ from the monorepo; the Claude Code plugin now vendors the CLI skill file on disk.
    • Updated developer resources and the agent integration docs to link the repo and install command: npx skills add superset-sh/skills.

Summary by CodeRabbit

  • New Features
    • Added discoverable agent skill listings plus Markdown skill endpoints for supported skills.
    • Updated the skill index to aggregate available skills dynamically and return clear availability vs. missing-skill responses.
    • Included enhanced discovery metadata and caching for improved performance.
  • Documentation
    • Added an “Agent Skills” section with setup guidance and the install command for the Superset CLI and MCP server skills.
    • Published detailed end-to-end superset CLI workflow documentation, including commands, environment variables, sessions, and troubleshooting.