BACKEND: THE SKILL FILE

One skill file for one job. This one is filled in for an example job: writing the caption for one social post.
Copy everything between COPY FROM HERE and COPY TO HERE, then change the job.


WHERE IT GOES

Claude Code: make a folder for the job inside .claude/skills/ in your project, and save the part you copied as SKILL.md in it.
For this example: .claude/skills/write-post-caption/SKILL.md
Keep the --- line as the very first line of the file. Claude Code only reads the name and description when it is.
The name is also a command: type /write-post-caption in a session to run it.

Another agent or AI tool: paste it at the start of the chat for that one job.
Or add it to the tool's standing instructions, under the rules file.


HOW TO MAKE YOUR OWN

1. One job per file. Writing a caption is one file. Writing an email is another.
2. The description says when to use it, in the words you'd actually type.
3. The steps are how the job is done here, in order.
4. The checklist at the end is what you'd check yourself before you approve the work.
5. When the agent gets something wrong twice, add a step or a tick so it can't happen a third time.


============ COPY FROM HERE ============
---
name: write-post-caption
description: Write the caption for one social post from its script or draft. Use when asked to "write the caption", "caption this post" or "turn this into a caption".
---

# Write a post caption

## When to use it

When a post is filmed or designed and needs its caption.
Not for ads, emails or long articles. Each of those gets its own skill file.

## Inputs

Ask for anything missing before you start:
- The script, or what the post shows, word for word.
- The one thing the viewer should do at the end, such as comment a word, save the post or follow.
- [The platform, such as Instagram.]
- The facts file, if the caption uses a number or a name.

## Steps

1. Read the rules file and check-lines.txt first.
2. Write the first line. It says what the post gives, in the viewer's words, in under 15 words.
3. Write the body: the post's main points, one short line each, in the order the post shows them.
4. Add the one ask, worded the way the post says it.
5. Check every number and name against the facts file. If one isn't there, cut it or write [PROOF NEEDED].
6. If the post shows made-up sample data, add a line that says so.
7. Run the checklist below, then the check in check-lines.txt.
8. Hand me the caption as text, with what the check found. Don't post it.

## Example

Input (EXAMPLE): a post showing three questions to ask a roofer before you hire one. It ends on "Save this for your next quote."

Output (EXAMPLE):

Three questions to ask a roofer before you sign anything.

1. Are you insured, and can I see the certificate?
2. Who does the work: your own team, or someone you hire in?
3. What happens if you find more damage once the roof is open?

Save this for your next quote.

## Checklist

- [ ] The first line says what the post gives, in under 15 words.
- [ ] Every point in the caption is in the post. Nothing new is added.
- [ ] One ask, worded the same as in the post.
- [ ] Every number and name has a source in the facts file, or it's gone.
- [ ] Sample data is marked EXAMPLE.
- [ ] No line from check-lines.txt.
- [ ] Every sentence is under 30 words.
- [ ] Handed over as text, not posted.
============ COPY TO HERE ============