diff --git a/README.md b/README.md
index a893f00..38c10cb 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,26 @@
-# yeri-ai-yeri-ai-cheat-sheet-images-edits-and-cli
+# Yeri AI cheat sheet: images, edits and clips
 
-Make AI art, short videos and clean edits fast
\ No newline at end of file
+This repository keeps my notes on [Yeri AI](https://yeri.ai), an online tool that turns prompts and photos into images and short clips. A plain Markdown file is the easiest way I have found to keep prompt variants, model choices and settings together.
+
+
+## Video
+
+Text-to-video clips are short, so plan one idea per clip and cut several together afterwards. I generate a clean still first, then animate it. That gives much more control than describing everything in one video prompt.
+
+## Editing tools
+
+The image expander (outpainting) is handy for turning a square photo into a 16:9 banner without cropping the subject. Upscaling and enhancement fix soft or low-resolution sources before you animate them, which noticeably improves video results.
+
+## Image prompts
+
+When matching a brand look, upload one or two reference images and describe only what should change; the model keeps the rest. Start with the subject, then the setting, then light and lens. For example: 'ceramic mug on a linen table, soft window light from the left, 50mm, shallow depth of field'.
+
+## Models
+
+I usually draft on a lighter model, keep the seed and prompt, then re-render the best two or three on a higher-quality model. Model choice matters more than prompt length. Fast models are fine for exploring ideas; switch to a pro model only for the final render to save credits.
+
+## Links
+
+Website: https://yeri.ai
+
+These notes are personal and may lag behind new features.
\ No newline at end of file