Write effective Reia skill instructions

How to write skill instructions that help Reia follow a repeatable workflow.

Written By Reia

Last updated About 1 hour ago

Skill instructions work best when they read like a compact operating standard. Tell Reia when to use the skill, what sources matter, what steps to follow, what output shape you want, and when to ask for clarification before proceeding.

Every skill starts with a small setup section:

---name: investment-memodescription: Use this when drafting or revising an investment memo.---

Use a lowercase hyphenated name, such as rent-roll-review or investment-memo. The description should be a real trigger, not a generic label. Write the instructions below the closing ---.

Prefer direct instructions over broad preferences. For example, say "Compare rent roll totals to the T-12 before recommending assumption changes" instead of "Be thorough." Name the source material, review checks, and final output. Include any team standard that should stay stable across deals.

Keep the skill focused enough that Reia can decide when it applies. If one document mixes rent-roll review, IC memo style, debt sizing, and closing logistics, split it into smaller skills.