feat(marketing): source agent skills from superset-sh/skills, drop monorepo copy
Merged
SA
4mo ago+73+73+01234567890123456789-34-34-01234567890123456789
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 privatesuperset-sh/skills(sales-outreach commands) was renamed tosuperset-sh/sales-skills; GitHub redirects both old names. - The repo contains two skills — the existing
supersetCLI skill (moved verbatim) and a newsuperset-mcpskill (MCP setup one-liners, auth flow, tool catalog) — and is registered on skills.sh (npx skills add superset-sh/skillsverified: both skills install). - This PR removes the monorepo copy at
skills/superset/and repoints consumers:/.well-known/agent-skills/index.json+/{skill}/SKILL.mdnow 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 --allinstalls both skills into.agents/skills/(universal + Claude Code symlinks) -
/.well-known/agent-skills/index.jsonlists both skills with descriptions + sha256 digests, sourced live from GitHub -
/{skill}/SKILL.mdserves text/markdown for both; unknown skill name → 404 -
bun run lintexits 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.mddynamically fetches fromsuperset-sh/skillswith 1h ISR; supportssupersetandsuperset-mcp(unknown → 404, source outage → 503)./.well-known/agent-skills/index.jsonbuilds from live content with sha256 digests and includesrepository: 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.
- Removed
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
supersetCLI workflow documentation, including commands, environment variables, sessions, and troubleshooting.