writing-skills
Use when creating or updating SKILL.md documentation - Explains how and why to create a skill.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
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
nameto the directory name exactly. - Write the
descriptionas "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.
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!