<< All versions
Skill v1.0.0
currentLLM-judged scan90/100charleshoskinson/danceswithclaws/skill-creator
──Details
PublishedOctober 21, 2026 at 10:34 AM
Content Hashsha256:d15b25d332d835eb...
Git SHA8c5d1dca7822
──Files
Files (1 file, 2.7 KB)
SKILL.md2.7 KBactive
SKILL.md · 86 lines · 2.7 KB
version: "1.0.0" name: skill-creator description: "Create, edit, audit, tidy, validate, or restructure AgentSkills and SKILL.md files."
Skill Creator
Skills are compact triggerable workflows. Metadata is always visible; body loads only after trigger; references/scripts/assets load only as needed.
Hard rules
- For durable OpenClaw skill creation or updates in an agent session, use
skill_workshop to create or revise a pending proposal. Do not scaffold or apply live SKILL.md files with shell commands or helper scripts.
- Keep
SKILL.mdlean; Codex is already capable. - Put only trigger-critical facts in frontmatter
description. - Quote frontmatter
description. - Frontmatter needs
name+description; local OpenClaw skills may also usemetadata,homepage,allowed-tools,user-invocable,license. - Prefer noun-phrase descriptions; short generic trigger phrase, not full workflow.
- Move long examples/docs to
references/; scripts toscripts/; templates/media toassets/. - No extra README/changelog/setup docs inside a skill unless they are actual task references.
- Validate YAML frontmatter after edits.
Shape
text
skill-name/SKILL.mdscripts/ optional deterministic helpersreferences/ optional docs loaded only when neededassets/ optional output resources/templatesagents/ optional UI metadata
Good SKILL.md
markdown
---name: pdf-toolsdescription: "Inspect, split, merge, OCR, redact, or convert PDFs with local CLI tools."---# PDF toolsUse for PDF manipulation. Prefer deterministic scripts for page edits.## Workflow1.Inspect file/page count.2.Choose exact operation.3.Write output beside input unless user asked otherwise.4.Render/verify changed pages.
Edit workflow
- Read existing skill and nearby resource names.
- Draft the proposed
SKILL.mdcontent. - Create or revise the pending proposal through
skill_workshopwhen the
change should persist as an OpenClaw skill.
- Remove generic advice the base model already knows.
- Keep brittle command syntax, auth caveats, safety rules, and validation.
- Replace tables with bullets unless a table is clearly needed.
- Relax prose; fragments ok.
- Validate frontmatter and run any script tests touched.
Validation
bash
python skills/skill-creator/scripts/quick_validate.py skills/<name>python - <<'PY'from pathlib import Pathimport yamlfor p in Path("skills").glob("*/SKILL.md"):text=p.read_text()if not text.startswith("---\n"):raise SystemExit(f"missing frontmatter: {p}")fm=text.split("---",2)[1]yaml.safe_load(fm)print("ok")PY
quick_validate.py is conservative; repo-local frontmatter may allow keys beyond public skill bundles.