opencode-plugin-preload-skills 1.1.2 → 1.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -7
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -17,13 +17,7 @@ A plugin for [OpenCode](https://opencode.ai) that preloads specified skills into
|
|
|
17
17
|
- **Debug Logging** — Optional verbose logging for troubleshooting
|
|
18
18
|
- **Zero Runtime Overhead** — Skills loaded once per session
|
|
19
19
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
## Installation
|
|
23
|
-
|
|
24
|
-
```bash
|
|
25
|
-
npm install opencode-plugin-preload-skills
|
|
26
|
-
```
|
|
20
|
+
> **⚠️ Warning:** Preloaded skills consume context window tokens on every session. Large skills or many skills can significantly reduce available context for your conversation. Keep skills concise and only preload what's truly needed for every session.
|
|
27
21
|
|
|
28
22
|
---
|
|
29
23
|
|
|
@@ -179,6 +173,15 @@ Session Start
|
|
|
179
173
|
|
|
180
174
|
---
|
|
181
175
|
|
|
176
|
+
## Best Practices
|
|
177
|
+
|
|
178
|
+
- **Keep skills concise** — Every token counts against your context window
|
|
179
|
+
- **Preload sparingly** — Only include skills needed for *every* session
|
|
180
|
+
- **Use on-demand loading** — For situational skills, use OpenCode's native `skill` tool instead
|
|
181
|
+
- **Monitor token usage** — Large skills can reduce conversation capacity by thousands of tokens
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
182
185
|
## Troubleshooting
|
|
183
186
|
|
|
184
187
|
### Skills not loading?
|
|
@@ -193,6 +196,13 @@ Session Start
|
|
|
193
196
|
|
|
194
197
|
Ensure `persistAfterCompaction` is `true` (this is the default).
|
|
195
198
|
|
|
199
|
+
### Context window running out quickly?
|
|
200
|
+
|
|
201
|
+
You may have too many or too large skills preloaded. Consider:
|
|
202
|
+
- Reducing the number of preloaded skills
|
|
203
|
+
- Trimming skill content to essentials
|
|
204
|
+
- Moving less critical skills to on-demand loading
|
|
205
|
+
|
|
196
206
|
---
|
|
197
207
|
|
|
198
208
|
## License
|
package/package.json
CHANGED