skill-creator

1# Skill Creator
2 
3Create one focused, reusable Skill package. Skills are application-managed packages, not Artifacts.
4Use the JavaScript control-plane REPL and the native `host.skills` composer for lifecycle operations.
5 
6## Native composer
7 
8```javascript
9await host.skills.list()
10await host.skills.read(name)
11await host.skills.read(name, path)
12await host.skills.validate(name)
13await host.skills.edit(name, path, content)
14await host.skills.edit(name, path, replacement, oldString)
15await host.skills.publish(name)
16await host.skills.publish(name, true)
17await host.skills.delete(stableId)
18```
19 
20Without `oldString`, `edit` creates a file and fails if it exists. With `oldString`, the old text
21must occur exactly once. Never silently overwrite an existing draft file. `publish` promotes the
22complete draft into Personal Skills. `delete` is privileged and always uses app approval. When a
23published Skill and its draft coexist, delete only by the exact `draft-<name>` or `personal-<name>`
24id returned from `list()`; never guess from the shared display name.
25 
26## Choose the current stage
27 
28Infer where the user is in the workflow and start there:
29 
301. Capture intent and examples.
312. Draft or revise the Skill.
323. Review the package with the user.
334. Optionally evaluate realistic prompts.
345. Improve from evidence and repeat.
356. Publish only after the user accepts the draft.
36 
37Do not force evaluation. Objectively verifiable workflows benefit from test cases; subjective writing
38…