opencode-plugin-preload-skills 1.1.2 → 1.1.4
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 +18 -7
- package/package.json +10 -2
package/README.md
CHANGED
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/opencode-plugin-preload-skills)
|
|
6
6
|
[](https://opensource.org/licenses/MIT)
|
|
7
|
+
[](https://github.com/juhas96/opencode-plugin-preload-skills)
|
|
7
8
|
|
|
8
9
|
A plugin for [OpenCode](https://opencode.ai) that preloads specified skills into the agent's context automatically when a session starts. Skills persist across context compaction, ensuring your agent always has access to the knowledge it needs.
|
|
9
10
|
|
|
@@ -17,13 +18,7 @@ A plugin for [OpenCode](https://opencode.ai) that preloads specified skills into
|
|
|
17
18
|
- **Debug Logging** — Optional verbose logging for troubleshooting
|
|
18
19
|
- **Zero Runtime Overhead** — Skills loaded once per session
|
|
19
20
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
## Installation
|
|
23
|
-
|
|
24
|
-
```bash
|
|
25
|
-
npm install opencode-plugin-preload-skills
|
|
26
|
-
```
|
|
21
|
+
> **⚠️ 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
22
|
|
|
28
23
|
---
|
|
29
24
|
|
|
@@ -179,6 +174,15 @@ Session Start
|
|
|
179
174
|
|
|
180
175
|
---
|
|
181
176
|
|
|
177
|
+
## Best Practices
|
|
178
|
+
|
|
179
|
+
- **Keep skills concise** — Every token counts against your context window
|
|
180
|
+
- **Preload sparingly** — Only include skills needed for *every* session
|
|
181
|
+
- **Use on-demand loading** — For situational skills, use OpenCode's native `skill` tool instead
|
|
182
|
+
- **Monitor token usage** — Large skills can reduce conversation capacity by thousands of tokens
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
182
186
|
## Troubleshooting
|
|
183
187
|
|
|
184
188
|
### Skills not loading?
|
|
@@ -193,6 +197,13 @@ Session Start
|
|
|
193
197
|
|
|
194
198
|
Ensure `persistAfterCompaction` is `true` (this is the default).
|
|
195
199
|
|
|
200
|
+
### Context window running out quickly?
|
|
201
|
+
|
|
202
|
+
You may have too many or too large skills preloaded. Consider:
|
|
203
|
+
- Reducing the number of preloaded skills
|
|
204
|
+
- Trimming skill content to essentials
|
|
205
|
+
- Moving less critical skills to on-demand loading
|
|
206
|
+
|
|
196
207
|
---
|
|
197
208
|
|
|
198
209
|
## License
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "opencode-plugin-preload-skills",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.4",
|
|
4
4
|
"description": "OpenCode plugin that auto-loads specified skills into agent memory on session start",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.cjs",
|
|
@@ -34,8 +34,16 @@
|
|
|
34
34
|
"preload",
|
|
35
35
|
"agent"
|
|
36
36
|
],
|
|
37
|
-
"author": "",
|
|
37
|
+
"author": "juhas96",
|
|
38
38
|
"license": "MIT",
|
|
39
|
+
"repository": {
|
|
40
|
+
"type": "git",
|
|
41
|
+
"url": "git+https://github.com/juhas96/opencode-plugin-preload-skills.git"
|
|
42
|
+
},
|
|
43
|
+
"bugs": {
|
|
44
|
+
"url": "https://github.com/juhas96/opencode-plugin-preload-skills/issues"
|
|
45
|
+
},
|
|
46
|
+
"homepage": "https://github.com/juhas96/opencode-plugin-preload-skills#readme",
|
|
39
47
|
"peerDependencies": {
|
|
40
48
|
"@opencode-ai/plugin": ">=1.0.0"
|
|
41
49
|
},
|