writing-skills

---

name: writing-skills description: "Use when creating or updating SKILL.md documentation - Explains how and why to create a skill."

Skills are used to for context that may be useful to a coding agent, without bloating LLM context at times theyre not useful.

Skills are only worthwhile if the coding agent fails a task without the skill.

Skills live in ~/.jorin/skills/, with each skill having its own directory.

SKILL.md

Front matter

• Match the name to the directory name exactly.
• Write the description as "Use when - " in under 30 words and third person.
• Quote the description if it includes punctuation that could break YAML.

Markdown body

• Write concise instructions for the skill topic.
• Keep headings and bullet lists structured so readers can scan quickly.

Aditional files

Other files, like scripts or data, may live in the directory and be referenced by the skill.