soonjune New Skill
Create a skill following this repository's conventions. Skills here serve multiple agents (Claude Code, OpenClaw, Hermes) through the Agent Skills open standard, wired up by symlinks.
Steps
Name it. Lowercase letters, digits, hyphens; max 64 chars; no leading/trailing/consecutive hyphens. The directory name must equal the frontmatter
name.Scaffold. From the repo root:
cp -r template skills/<name>, then editskills/<name>/SKILL.md.Write the description (max 1024 chars, one line, third person): what it does AND when to trigger it, with the concrete phrases a request would contain, in every language the owner actually uses.
Write the body. Imperative instructions, under 500 lines. Long reference material goes to
references/*.mdwith explicit "load this when..." pointers; runnable helpers go toscripts/.Cross-agent rules. Shared skills stick to standard frontmatter fields (
name,description,license,compatibility,metadata). To restrict a skill to some agents, setmetadata.agents: claude openclaw hermes(space-separated subset).Validate and wire up from the repo root:
python3 scripts/validate.py && python3 scripts/catalog.py scripts/link.shCommit. Never put secrets in skill text — skill files are injected into model context; reference credential file paths or env var names instead.