/browse - ONE_SHOT Skill Discovery
Find the right skill, fast. Fuzzy search through 43 skills by name, category, or trigger phrase.
When To Use
User says:
/browse [keyword] - Fuzzy search skills
/browse --category - List by category
/browse --stats - Show skill categories
- "what skills do I have"
- "find skill for [task]"
- "skill for [keyword]"
How It Works
Parse the command:
/browse testing → Search for "testing" in skill names, descriptions, triggers
/browse --category → Show all skills grouped by category
/browse --stats → Show skill counts by category
/browse --list → Compact list of all skills
Search in:
- Skill name
- Description text
- Trigger phrases
- Category classification
Skill Categories
Core (5 skills) - Use 90% of the time
| Skill |
Triggers |
Purpose |
| front-door |
"build me", "new project" |
Interview → spec → plan |
| create-plan |
"plan", "design" |
Structured planning |
| implement-plan |
"implement", "build it" |
Execute with beads tracking |
| debugger |
"bug", "broken", "fix" |
Systematic debugging |
| code-reviewer |
"review", "is this safe" |
Quality + security review |
Research (4 skills) - Token-free discovery
| Skill |
Tokens |
Purpose |
| freesearch |
FREE |
Research via Exa API, 0 Claude tokens |
| dispatch |
FREE |
Route to local CLIs (codex/gemini/qwen) |
| deep-research |
Uses tokens |
Background research via Gemini CLI |
| search-fallback |
Uses tokens |
Fallback when WebSearch fails |
Context Management (5 skills) - Always available
| Skill |
Purpose |
| beads |
Persistent task tracking (git-backed) |
| create-handoff |
Save context before /clear |
| resume-handoff |
Restore from handoff |
| failure-recovery |
Recovery from stuck states |
| thinking-modes |
Extended analysis (5 levels) |
Autonomous (3 skills) - Headless execution
| Skill |
Purpose |
| autonomous-builder |
Idea → artifact (survives disconnect) |
| resilient-executor |
Disconnect-proof via tmux |
| delegate-to-agent |
Spawn isolated sub-agents |
Development (7 skills)
| Skill |
Triggers |
Purpose |
| refactorer |
"refactor", "clean up" |
Systematic refactoring |
| test-runner |
"run tests", "coverage" |
Test execution + analysis |
| performance-optimizer |
"slow", "optimize" |
Evidence-based optimization |
| parallel-validator |
"validate", "check everything" |
Run tests/lint/security in parallel |
| batch-processor |
"rename across", "update all" |
Apply changes to many files |
| auto-updater |
(auto on session start) |
Auto-update from GitHub |
| hooks-manager |
"hooks", "lifecycle" |
Git hooks automation |
Operations (6 skills)
| Skill |
Triggers |
Purpose |
| git-workflow |
"commit", "PR", "push" |
Conventional commits, PRs |
| docker-composer |
"docker", "containerize" |
Docker/Compose setup |
| ci-cd-setup |
"CI", "CD", "pipeline" |
GitHub Actions, pipelines |
| push-to-cloud |
"deploy", "host this" |
Deploy to OCI-Dev |
| remote-exec |
"run on homelab", "ssh" |
Execute on remote machines |
| observability-setup |
"monitoring", "metrics" |
Logging, metrics, alerts |
Data & APIs (4 skills)
| Skill |
Triggers |
Purpose |
| database-migrator |
"migration", "schema" |
Safe schema changes |
| api-designer |
"design API", "REST" |
API specifications |
| oci-resources |
"oci database", "storage" |
OCI free-tier resources |
| convex-resources |
"convex", "reactive" |
Convex backend for web apps |
Documentation (1 skill)
| Skill |
Triggers |
Purpose |
| documentation-generator |
"update docs", "README" |
Generate docs, ADRs |
Secrets (2 skills)
| Skill |
Triggers |
Purpose |
| secrets-vault-manager |
"secrets", "env", "API keys" |
SOPS/Age encryption |
| secrets-sync |
"sync secrets", "pull secrets" |
Two-way vault sync |
Interview Control (3 skills)
| Skill |
Purpose |
| full-interview |
All 13+ questions (greenfield) |
| quick-interview |
Q1,Q2,Q6,Q12 (experienced users) |
| smart-interview |
Auto-detect depth (default) |
Specialized (3 skills)
| Skill |
Triggers |
Purpose |
| the-audit |
"audit this", "make strategic" |
Strategic communication filter |
| visual-iteration |
"polish UI", "10/10" |
Self-scoring design loop |
| skillsmp-browser |
"browse skillsmp", "find skills" |
External skill marketplace |
Fuzzy Search Examples
/browse test # → test-runner, parallel-validator
/browse deploy # → push-to-cloud, ci-cd-setup
/browse secret # → secrets-vault-manager, secrets-sync
/browse docker # → docker-composer
/browse research # → freesearch, deep-research, dispatch
/browse memory # → beads, create-handoff, resume-handoff
/browse parallel # → parallel-validator, batch-processor
/browse optimize # → performance-optimizer, refactorer
/browse remote # → remote-exec, push-to-cloud
/browse docs # → documentation-generator
Output Format
Search Results
🔍 Found 3 skills matching "test":
1. test-runner
Triggers: "run tests", "coverage", "pytest"
Purpose: Run tests, analyze results, improve coverage
Category: Development
2. parallel-validator
Triggers: "validate", "check everything"
Purpose: Run tests/lint/security in parallel
Category: Development
3. debugger
Triggers: "bug", "broken", "fix"
Purpose: Systematic debugging
Category: Core
Category View
📁 ONE_SHOT Skills by Category (43 total)
Core (5): front-door, create-plan, implement-plan, debugger, code-reviewer
Research (4): freesearch, dispatch, deep-research, search-fallback
Context (5): beads, create-handoff, resume-handoff, failure-recovery, thinking-modes
...
Stats View
📊 Skill Statistics
Total Skills: 43
Core: 5 (most used)
Development: 7
Operations: 6
Research: 4 (token-free available)
Data & APIs: 4
Context: 5
Autonomous: 3
Implementation Notes
Skill data source: Read from ~/.claude/skills/*/SKILL.md or use INDEX.md
Fuzzy matching: Use simple substring matching (case-insensitive)
Categories: Parse from SKILL.md frontmatter metadata or infer from INDEX.md
Usage stats: (Future) Track skill invocations via beads or log files
Quick Wins from Research
Based on competitor analysis (Cline, SkillsMP, Cursor):
- Visual skill discovery is the #1 requested feature
- 43 skills is overwhelming without search
- Cline has
/browse → ONE_SHOT needs it too
Keywords
browse, skills, find skill, skill search, list skills, skill discovery, fuzzy search
1---2name: skills-browser3description: Visual skill discovery with fuzzy search, categorization, and usage stats for 43+ ONE_SHOT skills.4---5
6# /browse - ONE_SHOT Skill Discovery
7
8**Find the right skill, fast.** Fuzzy search through 43 skills by name, category, or trigger phrase.
9
10---
11
12## When To Use
13
14User says:
15- `/browse [keyword]` - Fuzzy search skills
16- `/browse --category` - List by category
17- `/browse --stats` - Show skill categories
18- "what skills do I have"
19- "find skill for [task]"
20- "skill for [keyword]"
21
22---
23
24## How It Works
25
26**Parse the command:**
27- `/browse testing` → Search for "testing" in skill names, descriptions, triggers
28- `/browse --category` → Show all skills grouped by category
29- `/browse --stats` → Show skill counts by category
30- `/browse --list` → Compact list of all skills
31
32**Search in:**
33- Skill name
34- Description text
35- Trigger phrases
36- Category classification
37
38---
39
40## Skill Categories
41
42### Core (5 skills) - Use 90% of the time
43| Skill | Triggers | Purpose |
44|-------|----------|---------|
45| front-door | "build me", "new project" | Interview → spec → plan |
46| create-plan | "plan", "design" | Structured planning |
47| implement-plan | "implement", "build it" | Execute with beads tracking |
48| debugger | "bug", "broken", "fix" | Systematic debugging |
49| code-reviewer | "review", "is this safe" | Quality + security review |
50
51### Research (4 skills) - Token-free discovery
52| Skill | Tokens | Purpose |
53|-------|--------|---------|
54| freesearch | FREE | Research via Exa API, 0 Claude tokens |
55| dispatch | FREE | Route to local CLIs (codex/gemini/qwen) |
56| deep-research | Uses tokens | Background research via Gemini CLI |
57| search-fallback | Uses tokens | Fallback when WebSearch fails |
58
59### Context Management (5 skills) - Always available
60| Skill | Purpose |
61|-------|---------|
62| beads | Persistent task tracking (git-backed) |
63| create-handoff | Save context before /clear |
64| resume-handoff | Restore from handoff |
65| failure-recovery | Recovery from stuck states |
66| thinking-modes | Extended analysis (5 levels) |
67
68### Autonomous (3 skills) - Headless execution
69| Skill | Purpose |
70|-------|---------|
71| autonomous-builder | Idea → artifact (survives disconnect) |
72| resilient-executor | Disconnect-proof via tmux |
73| delegate-to-agent | Spawn isolated sub-agents |
74
75### Development (7 skills)
76| Skill | Triggers | Purpose |
77|-------|----------|---------|
78| refactorer | "refactor", "clean up" | Systematic refactoring |
79| test-runner | "run tests", "coverage" | Test execution + analysis |
80| performance-optimizer | "slow", "optimize" | Evidence-based optimization |
81| parallel-validator | "validate", "check everything" | Run tests/lint/security in parallel |
82| batch-processor | "rename across", "update all" | Apply changes to many files |
83| auto-updater | (auto on session start) | Auto-update from GitHub |
84| hooks-manager | "hooks", "lifecycle" | Git hooks automation |
85
86### Operations (6 skills)
87| Skill | Triggers | Purpose |
88|-------|----------|---------|
89| git-workflow | "commit", "PR", "push" | Conventional commits, PRs |
90| docker-composer | "docker", "containerize" | Docker/Compose setup |
91| ci-cd-setup | "CI", "CD", "pipeline" | GitHub Actions, pipelines |
92| push-to-cloud | "deploy", "host this" | Deploy to OCI-Dev |
93| remote-exec | "run on homelab", "ssh" | Execute on remote machines |
94| observability-setup | "monitoring", "metrics" | Logging, metrics, alerts |
95
96### Data & APIs (4 skills)
97| Skill | Triggers | Purpose |
98|-------|----------|---------|
99| database-migrator | "migration", "schema" | Safe schema changes |
100| api-designer | "design API", "REST" | API specifications |
101| oci-resources | "oci database", "storage" | OCI free-tier resources |
102| convex-resources | "convex", "reactive" | Convex backend for web apps |
103
104### Documentation (1 skill)
105| Skill | Triggers | Purpose |
106|-------|----------|---------|
107| documentation-generator | "update docs", "README" | Generate docs, ADRs |
108
109### Secrets (2 skills)
110| Skill | Triggers | Purpose |
111|-------|----------|---------|
112| secrets-vault-manager | "secrets", "env", "API keys" | SOPS/Age encryption |
113| secrets-sync | "sync secrets", "pull secrets" | Two-way vault sync |
114
115### Interview Control (3 skills)
116| Skill | Purpose |
117|-------|---------|
118| full-interview | All 13+ questions (greenfield) |
119| quick-interview | Q1,Q2,Q6,Q12 (experienced users) |
120| smart-interview | Auto-detect depth (default) |
121
122### Specialized (3 skills)
123| Skill | Triggers | Purpose |
124|-------|----------|---------|
125| the-audit | "audit this", "make strategic" | Strategic communication filter |
126| visual-iteration | "polish UI", "10/10" | Self-scoring design loop |
127| skillsmp-browser | "browse skillsmp", "find skills" | External skill marketplace |
128
129---
130
131## Fuzzy Search Examples
132
133```bash
134/browse test # → test-runner, parallel-validator
135/browse deploy # → push-to-cloud, ci-cd-setup
136/browse secret # → secrets-vault-manager, secrets-sync
137/browse docker # → docker-composer
138/browse research # → freesearch, deep-research, dispatch
139/browse memory # → beads, create-handoff, resume-handoff
140/browse parallel # → parallel-validator, batch-processor
141/browse optimize # → performance-optimizer, refactorer
142/browse remote # → remote-exec, push-to-cloud
143/browse docs # → documentation-generator
144```
145
146---
147
148## Output Format
149
150### Search Results
151```
152🔍 Found 3 skills matching "test":
153
1541. test-runner
155 Triggers: "run tests", "coverage", "pytest"
156 Purpose: Run tests, analyze results, improve coverage
157 Category: Development
158
1592. parallel-validator
160 Triggers: "validate", "check everything"
161 Purpose: Run tests/lint/security in parallel
162 Category: Development
163
1643. debugger
165 Triggers: "bug", "broken", "fix"
166 Purpose: Systematic debugging
167 Category: Core
168```
169
170### Category View
171```
172📁 ONE_SHOT Skills by Category (43 total)
173
174Core (5): front-door, create-plan, implement-plan, debugger, code-reviewer
175Research (4): freesearch, dispatch, deep-research, search-fallback
176Context (5): beads, create-handoff, resume-handoff, failure-recovery, thinking-modes
177...
178```
179
180### Stats View
181```
182📊 Skill Statistics
183
184Total Skills: 43
185Core: 5 (most used)
186Development: 7
187Operations: 6
188Research: 4 (token-free available)
189Data & APIs: 4
190Context: 5
191Autonomous: 3
192```
193
194---
195
196## Implementation Notes
197
198**Skill data source:** Read from `~/.claude/skills/*/SKILL.md` or use INDEX.md
199
200**Fuzzy matching:** Use simple substring matching (case-insensitive)
201
202**Categories:** Parse from SKILL.md frontmatter metadata or infer from INDEX.md
203
204**Usage stats:** (Future) Track skill invocations via beads or log files
205
206---
207
208## Quick Wins from Research
209
210Based on competitor analysis (Cline, SkillsMP, Cursor):
211- Visual skill discovery is the #1 requested feature
212- 43 skills is overwhelming without search
213- Cline has `/browse` → ONE_SHOT needs it too
214
215---
216
217## Keywords
218
219browse, skills, find skill, skill search, list skills, skill discovery, fuzzy search