Skip to content

Remove Agent Skills from backend: API, SDKs, CLI, drop tables (skills purge, stage 3)#126

Open
mgoldsborough wants to merge 1 commit into
mainfrom
chore/purge-skills-backend
Open

Remove Agent Skills from backend: API, SDKs, CLI, drop tables (skills purge, stage 3)#126
mgoldsborough wants to merge 1 commit into
mainfrom
chore/purge-skills-backend

Conversation

@mgoldsborough

Copy link
Copy Markdown
Contributor

Stage 3 of 4: bundle-only backend

The largest stage of the mpak refocus. Removes Agent Skills from the registry API, both SDKs, the CLI, and the database. mpak's backend now does one thing: serve security-scanned MCPB bundles.

Builds on #124 (positioning) and #125 (web + docs).

⚠️ BREAKING CHANGE. Per the "hard removal" decision: the /v1/skills API, mpak skill commands, skill SDK methods, and the skills/skill_versions tables are deleted. Published skills, skill installs, and skill badge embeds are no longer served. Skill packaging/distribution moves to the skills.sh / npx skills ecosystem.

Registry (apps/registry)

  • Delete routes/v1/skills.ts, SkillRepository, utils/skill-content.ts; unregister /v1/skills, drop the skills swagger tag and the Discord skill branch
  • Remove skills from the Prisma repositories decoration
  • Prisma: drop Skill/SkillVersion models + a migration that DROPs the tables (canonical Prisma-generated SQL)
  • Rewrite seed.ts to seed example bundles (Package → Version → Artifact → completed SecurityScan with trust levels), replacing the old skill seed
  • Delete skill tests; prune skill mocks from shared test helpers

Packages

  • schemas: delete the skill schema + skill validators
  • sdk-typescript: remove searchSkills/getSkill/getSkillDownload/getSkillVersionDownload/downloadSkillBundle + skill types
  • sdk-python: remove generated skill types (it's OpenAPI-generated — the long-term fix is regenerating from the updated registry spec; clean hand-removal for now)
  • cli: delete src/commands/skills/, the mpak skill namespace, and skill completions; unified mpak search is now bundle-only (kept bundle search --type, which is the unrelated server-type filter)

Verification (all green)

Migration + seed validated against a throwaway Postgres:

  • prisma migrate deploy applies the drop cleanly · migrate status reports no drift · skill tables confirmed gone
  • seed runs and is idempotent (identical counts on re-run; trust levels render)

Static suite:

  • pnpm typecheck 7/7 · pnpm build 6/6 · pnpm test (registry 125 + all packages) · biome ci (209 files) · ruff (python SDK) ✓

Net

+479 / −6,285 across 60 files.

Merge ordering

Independent of #125 at the code level (the web app has its own HTTP client, not the SDK), but for the cleanest deploy, land #125 (web/docs) before or with this PR so the UI isn't briefly calling removed /v1/skills endpoints. CHANGELOG history is preserved; the breaking change is recorded under [Unreleased].

…ll tables

Stage 3 of the skills purge. mpak's backend is now bundle-only.

BREAKING CHANGE: the /v1/skills API, mpak skill CLI commands, skill SDK
methods, and the skills/skill_versions tables are removed. Published
skills, skill installs, and skill badge embeds are no longer served.
Skill packaging/distribution moves to the skills.sh / npx skills ecosystem.

Registry:
- delete routes/v1/skills.ts, SkillRepository, utils/skill-content.ts
- unregister /v1/skills, drop skills swagger tag and Discord skill branch
- remove skills from the Prisma repositories decoration
- Prisma: drop Skill/SkillVersion models + migration to DROP the tables
- rewrite seed.ts to seed example bundles (Package/Version/Artifact/Scan)
- delete skill tests, prune skill mocks from shared test helpers

Packages:
- schemas: delete skill schema + skill validators
- sdk-typescript: remove skill methods/types
- sdk-python: remove generated skill types (regenerate from spec long-term)
- cli: delete src/commands/skills, mpak skill namespace, completions;
  unified mpak search is bundle-only

Verified against a throwaway Postgres: migration applies cleanly, skill
tables dropped, no drift, seed idempotent. Full suite green: typecheck
(7/7), build (6/6), tests (registry 125 + all packages), biome CI (209
files), ruff (python SDK).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant