Write your first SKILL.md

Write down the task in one sentence and collect two real examples of it. If you cannot describe it in one sentence, it is probably two skills.

Create a folder with a lowercase, hyphenated name and add a file called SKILL.md inside it.

commit-message-writer/
  SKILL.md

The header sits between two lines of three dashes. It needs a name (the same as the folder) and a description.

---
name: commit-message-writer
description: "Writes a clear commit message from staged changes. Use when asked to commit or to write a commit message."
---

Put the description in quotes if it contains a colon.

Under the header, write what the AI should do, in plain language: the steps, the rules, and the exact shape of the answer.

# Commit message writer

## How to work
1. Look at the staged diff and recent commit messages.
2. Write a subject line of 50-72 characters, imperative mood.
3. Add a body only when the reason is not obvious.

## Rules
- One logical change per commit.
- No filler such as "various fixes".

## Output
The message in a code block.

Put the folder in your skills folder (see How to install a skill), restart your tool, and ask: "Write a commit message for what I have staged." Watch whether the skill loads and whether the result follows your rules.

When the result is wrong, change the instructions, not the request. Add the rule that was missing, or an example of what you wanted. Share it on Promptsio when you are happy with it.