@zenobius/opencode-skillful 1.0.0 → 1.1.0

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.
Files changed (3) hide show
  1. package/README.md +25 -8
  2. package/dist/index.js +4107 -3940
  3. package/package.json +4 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  An interpretation of the [Anthropic Agent Skills Specification](https://github.com/anthropics/skills) for OpenCode, providing lazy-loaded skill discovery and injection.
4
4
 
5
- Differenator is :
5
+ Differenator is :
6
6
 
7
7
  - Conversationally the agent uses `skill_find words, words words` to discover skills
8
8
  - The agent uses `skill_use fully_resolved_skill_name` and,
@@ -132,26 +132,43 @@ skill_resource
132
132
 
133
133
  Search for skills using natural query syntax.
134
134
 
135
+ **Parameters:**
136
+
135
137
  - `query`: Search string supporting:
136
138
  - `*` or empty: List all skills
137
- - Path prefixes: `experts`, `superpowers/writing`
138
- - Keywords: `git commit`
139
- - Negation: `-term`
140
- - Quoted phrases: `"exact match"`
139
+ - Path prefixes: `experts`, `superpowers/writing` (prefix matching)
140
+ - Keywords: `git commit` (multiple terms use AND logic)
141
+ - Negation: `-term` (exclude results)
142
+ - Quoted phrases: `"exact match"` (phrase matching)
143
+
144
+ **Returns:** Matching skills with name and fully-qualified toolName (FQDN).
141
145
 
142
146
  ### `skill_use`
143
147
 
144
148
  Load one or more skills into the chat context.
145
149
 
146
- - `skill_names`: Array of skill names to load (by toolName or short name)
150
+ **Parameters:**
151
+
152
+ - `skill_names`: Array of skill names to load (by toolName/FQDN or short name)
153
+
154
+ **Features:**
155
+
156
+ - Injects skill metadata and content with:
157
+ - Skill resources available via `skill_resource(skillname, resourcename)`
158
+ - Base directory context for relative path resolution
159
+ - Full skill content formatted as Markdown for easy reading
147
160
 
148
161
  ### `skill_resource`
149
162
 
150
- Read a resource file from a skill's directory.
163
+ Read a resource file from a skill's directory and inject silently into the chat.
164
+
165
+ **Parameters:**
151
166
 
152
- - `skill_name`: The skill containing the resource
167
+ - `skill_name`: The skill containing the resource (by toolName/FQDN or short name)
153
168
  - `relative_path`: Path to the resource relative to the skill directory
154
169
 
170
+ **Behavior:** Silently injects resource content without triggering AI response (noReply pattern)
171
+
155
172
  ## Creating Skills
156
173
 
157
174
  Skills follow the [Anthropic Agent Skills Specification](https://github.com/anthropics/skills). Each skill is a directory containing a `SKILL.md` file: