Skip to content

An agentic skills framework & software development methodology that works.

docs: update documentation with message insertion and project skills features

Jesse Vincentb0ba2cf15afc
diff --git a/README.md b/README.md
index 075e2afbf..d651d26c6 100644
--- a/README.md
+++ b/README.md
@@ -64,8 +64,11 @@ Superpowers works with [OpenCode.ai](https://opencode.ai) through a native JavaS
**Features:**
- Custom tools: `use_skill` and `find_skills`
-- Automatic session bootstrap
-- Personal skills with shadowing
+- Automatic context injection via chat.message hook
+- Message insertion pattern for skill persistence across compaction
+- Three-tier skill priority: project > personal > superpowers
+- Project-local skills support (`.opencode/skills/`)
+- Auto re-injection on session.compacted events
- Supporting files and scripts access
## Quick Start
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
index 589217b1e..edb085253 100644
--- a/RELEASE-NOTES.md
+++ b/RELEASE-NOTES.md
@@ -6,15 +6,20 @@
- **OpenCode Support**: Native JavaScript plugin for OpenCode.ai
- Custom tools: `use_skill` and `find_skills`
- - Automatic session bootstrap with tool mapping instructions
- - Shared core module (`lib/skills-core.js`) for code reuse
+ - Message insertion pattern for skill persistence across context compaction
+ - Automatic context injection via chat.message hook
+ - Auto re-injection on session.compacted events
+ - Three-tier skill priority: project > personal > superpowers
+ - Project-local skills support (`.opencode/skills/`)
+ - Shared core module (`lib/skills-core.js`) for code reuse with Codex
- Installation guide in `.opencode/INSTALL.md`
### Changed
-- **Refactored Codex Implementation**: Now uses shared `lib/skills-core.js` module
+- **Refactored Codex Implementation**: Now uses shared `lib/skills-core.js` ES module
- Eliminates code duplication between Codex and OpenCode
- Single source of truth for skill discovery and parsing
+ - Codex successfully loads ES modules via Node.js interop
---