@sowonai/crewx-cli 0.8.0-rc.23 → 0.8.0-rc.24
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/package.json
CHANGED
|
@@ -128,7 +128,60 @@ layouts:
|
|
|
128
128
|
You have access to the skills listed above. When you need to use a skill:
|
|
129
129
|
1. Read the skill file using the file_path
|
|
130
130
|
2. Follow the instructions in the skill document
|
|
131
|
-
3.
|
|
131
|
+
3. **Execute commands via `crewx skill x` for tracking**
|
|
132
|
+
|
|
133
|
+
<skill_execution_guide>
|
|
134
|
+
## IMPORTANT: Skill Command Execution
|
|
135
|
+
|
|
136
|
+
When SKILL.md shows a command to run, **always wrap it with `crewx skill x`**.
|
|
137
|
+
This ensures proper tracking in traces.db and provides sandboxing.
|
|
138
|
+
|
|
139
|
+
### Environment Variables
|
|
140
|
+
When you run `crewx skill x`, the following env vars are automatically set:
|
|
141
|
+
- `SKILL_DIR`: Absolute path to the skill directory
|
|
142
|
+
- `CREWX_TASK_ID`: Current task ID for tracing
|
|
143
|
+
|
|
144
|
+
### Examples
|
|
145
|
+
|
|
146
|
+
**Example 1: Node.js skill**
|
|
147
|
+
```
|
|
148
|
+
SKILL.md says:
|
|
149
|
+
node memory-v2.js index agent_id
|
|
150
|
+
|
|
151
|
+
You run:
|
|
152
|
+
crewx skill x memory-v2 'node $SKILL_DIR/memory-v2.js index agent_id'
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
**Example 2: Python skill**
|
|
156
|
+
```
|
|
157
|
+
SKILL.md says:
|
|
158
|
+
python analyze.py --input data.json
|
|
159
|
+
|
|
160
|
+
You run:
|
|
161
|
+
crewx skill x analyzer 'python $SKILL_DIR/analyze.py --input data.json'
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
**Example 3: Shell script**
|
|
165
|
+
```
|
|
166
|
+
SKILL.md says:
|
|
167
|
+
./run.sh --verbose
|
|
168
|
+
|
|
169
|
+
You run:
|
|
170
|
+
crewx skill x my-skill '$SKILL_DIR/run.sh --verbose'
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
### Format
|
|
174
|
+
```
|
|
175
|
+
crewx skill x <skill-name> '<command-using-$SKILL_DIR>'
|
|
176
|
+
# or
|
|
177
|
+
crewx skill execute <skill-name> '<command>'
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
- `<skill-name>`: The skill's name from available_skills
|
|
181
|
+
- Use `$SKILL_DIR` to reference files in the skill directory
|
|
182
|
+
|
|
183
|
+
**DO NOT** run skill commands directly without `crewx skill x`.
|
|
184
|
+
</skill_execution_guide>
|
|
132
185
|
|
|
133
186
|
**IMPORTANT**: Do NOT guess skill usage. Always read SKILL.md first before using any skill.
|
|
134
187
|
{{/if}}
|