diff --git a/skills/project-ops/SKILL.md b/skills/project-ops/SKILL.md
index 0efef62..ccdee63 100644
--- a/skills/project-ops/SKILL.md
+++ b/skills/project-ops/SKILL.md
@@ -67,6 +67,8 @@ curl -s -X POST "$BASE/tasks/<task_id>" -H "Authorization: Bearer $VIKUNJA_TOKEN
 Base: `https://outline.lab.audasmedia.com.au/api`
 Same bearer pattern (`Authorization: Bearer $OL_API_KEY`, `Content-Type: application/json`). Endpoints are **POST**.
 
+> ⚠️ **Known flakiness:** the public (Caddy) endpoint intermittently returns **502** on writes/reads. If you get a 502, **retry once** (often transient). For reliable create/update (e.g. `documents.create`), go **directly to the container**: `POST http://127.0.0.1:3000/api/...` from `.13` (same key).
+
 ```bash
 # collections (top-level doc groups)
 curl -s -X POST "$OL_BASE/collections.list" -H "Authorization: Bearer $OL_API_KEY" \
@@ -79,6 +81,10 @@ curl -s -X POST "$OL_BASE/documents.list" -H "Authorization: Bearer $OL_API_KEY"
 # search docs
 curl -s -X POST "$OL_BASE/documents.search" -H "Authorization: Bearer $OL_API_KEY" \
   -H "Content-Type: application/json" -d '{"query":"<search terms>","limit":10}'
+
+# reliable direct create (on .13):
+curl -s -X POST "http://127.0.0.1:3000/api/documents.create" -H "Authorization: Bearer $OL_API_KEY" \
+  -H "Content-Type: application/json" -d '{"collectionId":"<id>","title":"<T>","text":"<md>","publish":true}'
 ```
 
 ## 4. Guidance