Migrate A Legacy Skill To Prompt Composition

1. Move reusable instruction text into prompt objects.
2. Create immutable prompt versions and publish the reviewed versions.
3. Attach the prompts to a draft skill version with replacePrompts.
4. Re-read GET /api/skills/:id and inspect promptComposition.
5. Preview with POST /api/skills/:id/preview.
6. Validate behavior with POST /api/skills/:id/run and, if needed, POST /api/skills/:id/evaluations/run.

Legacy layer-shaped specs are historical only. Current SDK and CLI workflows should use prompt composition.

See also

• Prompt And Skill Quickstart
• Prompt Composition
• Public Boundary