diff --git a/assets/README.md b/assets/README.md
index 4333144..15dcefb 100644
--- a/assets/README.md
+++ b/assets/README.md
@@ -52,4 +52,36 @@ SKILLS_FILE=/tmp/ios-skills.yaml /tmp/sync-skills.sh
 
 Notes:
 - The sync script reads the list file you pass in `SKILLS_FILE`.
-- Cloning the repo is still recommended if you want updates and version history.
\ No newline at end of file
+- Cloning the repo is still recommended if you want updates and version history.
+
+## Install Agents
+Agents are prompt files that live under assets/agents.
+
+### Clone And Copy (Recommended)
+```bash
+git clone git@<host>:org/ai-assets.git
+mkdir -p ~/.agents/agents
+cp -R ai-assets/agents/* ~/.agents/agents/
+```
+
+### No-Clone (Raw Files)
+```bash
+mkdir -p ~/.agents/agents
+curl -fsSL <raw-url-to-agent-file> -o ~/.agents/agents/<agent-file>.agent.md
+```
+
+## Install Instructions
+Instructions are repo-level rule files. Copy them into your project.
+
+### Clone And Copy (Recommended)
+```bash
+git clone git@<host>:org/ai-assets.git
+mkdir -p ./instructions
+cp -R ai-assets/instructions/* ./instructions/
+```
+
+### No-Clone (Raw Files)
+```bash
+mkdir -p ./instructions
+curl -fsSL <raw-url-to-instruction-file> -o ./instructions/<name>.instructions.md
+```
\ No newline at end of file