diff --git a/prpm.json b/prpm.json
index d645669c8..289c78552 100644
--- a/prpm.json
+++ b/prpm.json
@@ -46,7 +46,7 @@
     },
     {
       "name": "writing-agent-relay-workflows",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "description": "Use when building multi-agent workflows with the relay broker-sdk - covers the WorkflowBuilder API, DAG step dependencies, agent definitions, step output chaining via {{steps.X.output}}, verification gates, deterministic steps, dedicated channels, swarm patterns, error handling, event listeners, step sizing rules, and the lead+workers team pattern for complex steps",
       "format": "claude",
       "subtype": "skill",
diff --git a/skills/writing-agent-relay-workflows/SKILL.md b/skills/writing-agent-relay-workflows/SKILL.md
index dc6246024..9573eee51 100644
--- a/skills/writing-agent-relay-workflows/SKILL.md
+++ b/skills/writing-agent-relay-workflows/SKILL.md
@@ -601,6 +601,9 @@ But if the owner doesn't post either format, the runner still resolves completio
 | Using `fan-out`/`hub-spoke` for simple parallel workers     | Use `dag` — hub patterns trigger auto owner/supervisor/reviewer pipeline |
 | Workers without `preset: 'worker'` in lead+worker workflows | Add `preset: 'worker'` — it auto-sets `interactive: false` and produces clean stdout for `{{steps.X.output}}` injection |
 | Lead running concurrently with workers, monitoring channel  | Make lead `dependsOn` workers — use `{{steps.X.output}}` injection instead of real-time channel monitoring |
+| Using `_` in YAML numbers (e.g., `timeoutMs: 1_200_000`)   | YAML doesn't support `_` as a numeric separator — use `1200000`. TypeScript separators don't work in YAML |
+| Setting workflow timeout under 30 minutes for complex workflows | Claude leads reading large codebases take 5-15 min per step. Use `3600000` (1 hour) as a safe default |
+| Passing too much context in `read-context` deterministic steps | Trim to only the relevant code. Use `grep`, `sed -n`, `head` instead of full `cat`. Large context slows lead design |
 
 ## Verification Tokens with Non-Interactive Workers