Files
gnome-jarvis/vendor/agent-harness/agent-workspace/skills/skill-creator/SKILL.md
T
2026-09-11 13:41:22 -04:00

1.7 KiB

name, description
name description
skill-creator Author or repair workspace skills as name/SKILL.md with YAML frontmatter. Use when adding, fixing, or reviewing Pip skills.

Skill creator

Write skills into /root/.agent/workspace/skills/<name>/SKILL.md with write_file. Do not invent OpenClaw skill_workshop. There is no ClawHub publish step here.

Contract

  1. One folder per skill. Directory name equals frontmatter name.
  2. Required frontmatter: name (lowercase letters, digits, hyphens) and description (one line, under 160 characters, what + when).
  3. Body is a playbook for Pip tools that exist in this session. Never tell Pip to call exec, skill_workshop, or a third-party coding agent.
  4. Optional extras one level down: references/, scripts/, assets/. Link them from SKILL.md. Use {baseDir} only if a helper ships beside the skill.
  5. Omit disable-model-invocation unless the skill should stay out of the catalog.

Workflow

  1. Read any existing SKILL.md and supporting files, or collect the branches the user wants.
  2. For each branch: trigger, outcome, which Pip tool to call.
  3. Write or patch skills/<name>/SKILL.md. Keep the body under 500 lines.
  4. Verify: frontmatter parses, folder name matches name, every {baseDir} or relative link exists, tool names match AGENTS.md / this session.
  5. Tell the user the skill path. It is picked up next session (catalog is built at session start).

Description line

Third person. Include trigger terms:

Publish a container listen port as an HTTPS hostname. Use when the user wants a domain, vhost, or public URL.

Do not

  • Copy OpenClaw bundled skills that need Apple, Spotify, ClawHub, or coding-agent.
  • Put secrets in SKILL.md.
  • Dump the full skills catalog in chat.