From ff50d45c0478079bf73df177aced71ae30a6aa3f Mon Sep 17 00:00:00 2001
From: Mario Zechner <badlogicgames@gmail.com>
Date: Sun, 25 Jan 2026 20:52:42 +0100
Subject: [PATCH] docs(coding-agent): add instructions for using skills from
 other harnesses

---
 packages/coding-agent/docs/skills.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/packages/coding-agent/docs/skills.md b/packages/coding-agent/docs/skills.md
index a147e92f..99e26216 100644
--- a/packages/coding-agent/docs/skills.md
+++ b/packages/coding-agent/docs/skills.md
@@ -33,6 +33,27 @@ Discovery rules:
 
 Disable discovery with `--no-skills` (explicit `--skill` paths still load).
 
+### Using Skills from Other Harnesses
+
+To use skills from Claude Code or OpenAI Codex, add their directories to settings:
+
+```json
+{
+  "skills": [
+    "~/.claude/skills",
+    "~/.codex/skills"
+  ]
+}
+```
+
+For project-level Claude Code skills, add to `.pi/settings.json`:
+
+```json
+{
+  "skills": [".claude/skills"]
+}
+```
+
 ## How Skills Work
 
 1. At startup, pi scans skill locations and extracts names and descriptions