Skip to content

docs(api): add Skills & Prompts (AI Registry) reference + guides#535

Open
andreaonofrei01 wants to merge 1 commit into
mainfrom
docs/add-skills-and-prompts-api
Open

docs(api): add Skills & Prompts (AI Registry) reference + guides#535
andreaonofrei01 wants to merge 1 commit into
mainfrom
docs/add-skills-and-prompts-api

Conversation

@andreaonofrei01

@andreaonofrei01 andreaonofrei01 commented Jul 1, 2026

Copy link
Copy Markdown

What

Exposes the AI Registry Skills and Prompts endpoints (/v2/skills*, /v2/prompts*) in the public docs: API reference + conceptual guides + SDK code samples.

Changes

  • API reference : it;s spliced the 8 skills/prompts paths, their 2 tags (beta.skills, beta.prompts) and 23 schemas into openapi-public-doc.yaml (additive only), and regenerated endpoint/beta/skills/ + endpoint/beta/prompts/ via pnpm api:build.
  • Guides : new studio-api/skills and studio-api/prompts pages (concept + create/list/version/share/delete how-to).
  • Examples : added realistic request-body examples for the four create operations (they generated as empty {}).
  • SDK samples : bumped the reference SDKs to client-ts 2.4.0 and client-python 2.5.1 (first releases that ship skills/prompts), so every endpoint now renders current curl + Python + TypeScript samples. Superseded tarballs removed.
  • Cleanup : dropped 7 orphaned fine-tuning example patches (schemas removed upstream); agents and fine-tuning reference pages are removed because those tags no longer carry operations (moved to beta.agents / models).

Testing

  • pnpm type-check passes.
  • pnpm api:build completes with 0 orphan patches.
  • Skills/prompts pages verified to render curl + Python + TypeScript samples.

Notes / follow-ups

  • French docs not included — EN only; the FR tree (api:build:fr) is a follow-up (it was already behind on main).
  • The skills/prompts additions to openapi-public-doc.yaml are a targeted hand-splice; a full pnpm api:fetch will re-sync the snapshot to the complete dashboard spec.

Expose the AI Registry Skills and Prompts endpoints in the public docs.

- Add /v2/skills and /v2/prompts (CRUD + versions) to the API reference
  by splicing them into openapi-public-doc.yaml (additive only)
- Add Skills and Prompts guides under studio-api
- Add request-body examples for the skills/prompts create operations
- Refresh SDK code samples to client-ts 2.4.0 / client-python 2.5.1
  (first releases that include skills/prompts); remove superseded tarballs
- Drop orphaned fine-tuning example patches whose schemas were removed
  upstream; agents/fine-tuning reference pages are removed as those tags
  no longer carry operations
@vercel

vercel Bot commented Jul 1, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
platform-docs-public Ready Ready Preview, Comment Jul 1, 2026 7:38pm

Request Review

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying platform-docs-public with  Cloudflare Pages  Cloudflare Pages

Latest commit: ea90731
Status:🚫  Build failed.

View logs

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