Skill Creator

Workflow

1. Establish the contract.

   • Read the existing skill and its resources, or collect concrete requests for a new skill.
   • Separate actual workflow branches from synonyms for the same branch.
   • Done when: every branch has a concrete trigger, expected outcome, and persistence target.

2. Choose invocation.

   • Model-discoverable: write a model-facing description; omit disable-model-invocation.
   • Manual-only: set disable-model-invocation: true; write a human-facing summary.
   • Direct tool command: add command-dispatch: tool, command-tool, and command-arg-mode only when the command bypasses the model.
   • Done when: frontmatter matches how the skill will actually be reached.

3. Structure the skill.

   • Map shared ordered procedure to SKILL.md; end every step with a checkable completion criterion and finish with verification.
   • Keep routing conditions in description; start the body with execution.
   • Map branch-only detail to references/, repeatable helpers to scripts/, output resources to assets/, and optional UI metadata to agents/.
   • Done when: every planned resource has one purpose and a direct pointer from SKILL.md.

4. Draft and persist.

   • Live workspace skill: use skill_workshop to create or revise a pending proposal; keep live files unchanged until apply.
   • Repository-owned skill source: use the repository's normal edit and review workflow.
   • Done when: the proposal or source diff implements every branch from step 1 and contains every resource from step 3.

5. Validate.

   • Run python {baseDir}/scripts/quick_validate.py <skill-directory> and execute every touched helper's focused test.
   • Done when: frontmatter passes, resource pointers resolve, and every touched helper passes its focused test.

Frontmatter

Required: name, description.

OpenClaw also supports metadata, homepage, license, allowed-tools, user-invocable, disable-model-invocation, command-dispatch, command-tool, and command-arg-mode. Add optional fields only when they change runtime behavior or discovery.