Skip to content

feat: adopt the Agent Plugins standard and sync skills from prisma/skills - #6

Draft
gregory-boch-prisma wants to merge 2 commits into
prisma:mainfrom
gregory-boch-prisma:greg/agent-plugins-standard-and-skill-sync
Draft

feat: adopt the Agent Plugins standard and sync skills from prisma/skills#6
gregory-boch-prisma wants to merge 2 commits into
prisma:mainfrom
gregory-boch-prisma:greg/agent-plugins-standard-and-skill-sync

Conversation

@gregory-boch-prisma

@gregory-boch-prisma gregory-boch-prisma commented Aug 20, 2026

Copy link
Copy Markdown

What

Aligns the plugin with the Agent Plugins open standard (v1.0.0, announced by OpenAI/AWS/Cursor/GitHub/VS Code/Vercel on Aug 6) and syncs skills with prisma/skills at 808913c.

Agent Plugins standard (additive migration)

  • plugin.json at the repo root — the portable manifest with the required $schema (https://agent-plugins.org/schemas/1.0.0/plugin.schema.json) and only the standard's closed field set (name, version, description, author, homepage, repository, license, keywords).
  • mcp.json at the repo root — the portable MCP declaration for the official Prisma MCP server. The standard requires an explicit transport type; the remote server is declared as streamable-http. (The old .mcp.json's note field is not valid in the standard schema, so it lives only in the legacy file.)
  • skills/ is already conformant — each skill dir has a SKILL.md whose frontmatter name matches the directory and uses only standard Agent Skills fields.
  • Client-specific directories (.claude-plugin/, .codex-plugin/, .cursor-plugin/, .plugin/) are kept unchanged in structure for Claude Code, Codex, Cursor and the npx plugins installer (which still consumes .plugin/). Per the standard's migration guide the portable root files are the source of truth and legacy manifests can be dropped once all consumers read the standard layout.

Skill sync (prisma/skills 808913c, Aug 13)

  • New skill: prisma-mongodb-upgrade (v6 is terminal for MongoDB; stay-on-v6 vs Prisma Next decision guide) with 5 reference files.
  • prisma-database-setup and prisma-upgrade-v7 gain the MongoDB routing notes pointing at the new skill.

Housekeeping

  • Version bump 0.3.0 → 0.4.0 across all manifests, mongodb keyword, README documents the standard and the new skill.

Heads-up: content staleness (follow-up, belongs in prisma/skills)

While auditing for this sync I found the compute/CLI skills are behind the current product surface — even in prisma/skills:

  • prisma-compute is written against the retired @prisma/cli app ... surface (app deploy, app promote, app logs, compute:deploy, create-prisma --deploy, --prod, --no-promote, --create-project). In the unified v8 RC CLI (prisma@next / @prisma/cli@next, 8.0.0-rc.6) the app group is removed: the surface is service / service deployment / service domain / service logs, git connect push-to-deploy, and there is no standalone deploy command. prisma.compute.ts + defineComputeConfig (from @prisma/compute-sdk/config) remain correct, but JSON config is now written with init --config-format json, not --format json.
  • No skill covers Prisma Composer (Early Access; composer deploy|destroy|dev|log in the v8 CLI, @prisma/composer 0.10.0).
  • No skill covers the v8 RC unified CLI surface (postgres, bucket, contract, migration, agent, envelope prisma.config.ts with definePrismaConfig).

Those need content authoring in prisma/skills first (which is also what prisma agent install pulls from); this PR deliberately only syncs and aligns packaging.

🤖 Generated with Claude Code

gregory-boch-prisma and others added 2 commits August 20, 2026 10:32
- Add root plugin.json and mcp.json per the Agent Plugins v1.0.0 open
  standard (agent-plugins.org): portable manifest with $schema, and the
  official Prisma MCP server declared as streamable-http. Client-specific
  directories are kept for installers that predate the standard.
- Sync skills with prisma/skills@808913c: adds the prisma-mongodb-upgrade
  skill and the MongoDB routing updates to prisma-database-setup and
  prisma-upgrade-v7.
- Bump plugin version to 0.4.0 across all manifests; document the
  standard and the new skill in the README.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…port

- Add the MIT LICENSE file every manifest and SKILL.md already declares.
- Author email was present in only two of five plugin manifests; align all.
- README: note Codex discovers the repo via .agents/plugins/marketplace.json
  and that the repo-root plugin path needs Codex >= 0.142.0 (openai/codex#17066).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@gregory-boch-prisma
gregory-boch-prisma marked this pull request as draft August 20, 2026 10:43
@gregory-boch-prisma

Copy link
Copy Markdown
Author

On hold — skill content updates are being handled separately first; this PR (packaging + standard alignment) will be rebased on top once those land.

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