1 files changed, 37 insertions, 0 deletions
diff --git a/modules/development/pi-coding-agent/skills/performance-analysis/SKILL.md b/modules/development/pi-coding-agent/skills/performance-analysis/SKILL.md
new file mode 100644
index 0000000..0a65471
--- /dev/null
+++ b/modules/development/pi-coding-agent/skills/performance-analysis/SKILL.md
@@ -0,0 +1,37 @@
+---
+name: performance-analysis
+description: "Measure before optimizing, identify likely bottlenecks, make a targeted change, and verify the effect."
+---
+
+# Performance Analysis Skill
+
+Measure before optimizing, identify likely bottlenecks, make a targeted change, and verify the effect.
+
+## Subagents
+When you need to delegate sub‑tasks, use the `pi-subagents` skill.
+
+**Example:** To optimize a slow endpoint, run a **scout** to profile CPU usage in the `handler` function, another **scout** to measure I/O latency in the `storage` layer, and an **implementer** to apply algorithmic improvements while a **reviewer** compares benchmarks against the baseline.
+
+*You may adapt the delegation pattern to fit the exact requirements of the codebase.*
+
+## Workflow
+
+### 1. Measure
+- Profile before changes
+- Establish baseline metrics
+- Identify hot paths
+
+### 2. Analyze
+- Find actual bottlenecks
+- Distinguish CPU vs I/O vs memory
+- Consider algorithmic complexity
+
+### 3. Target
+- One bottleneck at a time
+- Minimal, focused change
+- Prefer algorithmic improvements
+
+### 4. Verify
+- Re-measure after change
+- Compare to baseline
+- Check for regressions