Skip to content

Commit 34bc7ec

Browse files
committed
Update doc for skill finding command
1 parent 268b161 commit 34bc7ec

File tree

1 file changed

+61
-0
lines changed

1 file changed

+61
-0
lines changed

web/content/docs/7-skills.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -203,6 +203,67 @@ The update command pulls the latest changes from skill registries using `git pul
203203
- Non-git directories are skipped (e.g., manually created folders)
204204
- The command continues even if some registries fail to update
205205

206+
### `ai-devkit skill find`
207+
208+
Search for skills across all configured registries using keyword matching.
209+
210+
**Syntax:**
211+
212+
```bash
213+
ai-devkit skill find <keyword>
214+
```
215+
216+
**Parameters:**
217+
218+
- `<keyword>`: The search term to match against skill names and descriptions
219+
220+
**Options:**
221+
222+
| Option | Description |
223+
|--------|-------------|
224+
| `--refresh` | Force rebuild the skill index before searching |
225+
226+
**Example:**
227+
228+
```bash
229+
ai-devkit skill find frontend
230+
```
231+
232+
**Output:**
233+
234+
```
235+
Found 3 skill(s) matching "frontend":
236+
237+
Skill Name Registry Description
238+
─────────────────────────────────────────────────────────────────
239+
frontend-design anthropics/skills Modern frontend design patterns
240+
react-components vercel-labs/skills Reusable React component patterns
241+
css-utilities my-org/skills CSS utility class best practices
242+
243+
Install with: ai-devkit skill add <registry> <skill-name>
244+
```
245+
246+
**How It Works:**
247+
248+
The find command searches a pre-built skill index that aggregates skills from all known registries:
249+
250+
1. Checks for a cached skill index (updated weekly or on demand)
251+
2. Matches your keyword against skill names and descriptions
252+
3. Returns sorted results showing skill name, registry, and description
253+
4. Provides the install command for easy copy-paste
254+
255+
**When to Use `--refresh`:**
256+
257+
- After adding custom registries to your configuration
258+
- When you expect new skills to be available
259+
- If the skill index seems outdated
260+
261+
**Notes:**
262+
263+
- The skill index is automatically rebuilt weekly via GitHub Actions
264+
- First-time searches may take longer while the index builds
265+
- Search is case-insensitive and matches partial words
266+
206267
## Skill Registry
207268

208269
AI DevKit uses a centralized registry file to map registry identifiers to their GitHub repositories. The registry is hosted at:

0 commit comments

Comments
 (0)