Writing Effective Instructions in Skill Files

The quality of a skill file is determined by how well its instructions can be followed by an AI agent. Vague, ambiguous, or poorly structured instructions lead to incorrect or incomplete results. This skill teaches how to write instructions that are precise, unambiguous, and actionable — the difference between a skill that works and one that confuses.

## Key Points

1. Install dependencies:
2. Create a `.env` file with your database URL:
3. Run the database migration:
4. Verify migration succeeded:
1. [Precondition or setup]
2. [First action — specific command or change]
3. [Verification — how to confirm step 2 worked]
4. [Next action — builds on step 2]
5. [Final verification — end-to-end check]
1. Ensure Docker is running (`docker info` should show server info)
2. Pull the PostgreSQL image:
3. Verify the image was downloaded: