Skip to content

An agentic skills framework & software development methodology that works.

Clarify personal skill directories for Codex

Jesse Vincentaa8c6b4fd0b2
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
index 2c9698c4e..3365c2c50 100644
--- a/RELEASE-NOTES.md
+++ b/RELEASE-NOTES.md
@@ -1,5 +1,11 @@
# Superpowers Release Notes
+## v3.3.1 (2025-10-28)
+
+### Bug Fixes
+
+- Clarified `writing-skills` guidance so it points to the correct agent-specific personal skill directories (`~/.claude/skills` for Claude Code, `~/.codex/skills` for Codex).
+
## v3.3.0 (2025-10-28)
### New Features
diff --git a/skills/writing-skills/SKILL.md b/skills/writing-skills/SKILL.md
index bb9129c30..984ebce57 100644
--- a/skills/writing-skills/SKILL.md
+++ b/skills/writing-skills/SKILL.md
@@ -9,7 +9,7 @@ description: Use when creating new skills, editing existing skills, or verifying
**Writing skills IS Test-Driven Development applied to process documentation.**
-**Personal skills are written to `~/.claude/skills`**
+**Personal skills live in agent-specific directories (`~/.claude/skills` for Claude Code, `~/.codex/skills` for Codex)**
You write test cases (pressure scenarios with subagents), watch them fail (baseline behavior), write the skill (documentation), watch tests pass (agents comply), and refactor (close loopholes).