Files
skillshare/website/docs/workflows/skill-discovery.md
T
Willie 0c49860d63 feat: add project mode labels, privacy-first messaging, and UI polish
- Add (project) labels to status, sync, collect, target, and uninstall
  headers for clear mode distinction (matching list/target list pattern)
- Add ui.WithModeLabel() helper for shared functions that run in both modes
- Update uninstall confirmation prompt: "from the project?" in project mode
- Add "Privacy-first" to README Why section and website homepage
- Replace "Unified Source" card with "Privacy-First" card on website
- Unify Quick Actions card heights with h-full in DashboardPage
- Add frontend rebuild note to Docker sandbox docs
2026-02-09 21:08:03 +08:00

186 lines
3.8 KiB
Markdown

---
sidebar_position: 3
---
# Skill Discovery
Find, evaluate, and install skills from the community.
## Overview
```
┌─────────────────────────────────────────────────────────────┐
│ SKILL DISCOVERY FLOW │
│ │
│ SEARCH ──► BROWSE ──► EVALUATE ──► INSTALL ──► SYNC │
│ │
└─────────────────────────────────────────────────────────────┘
```
---
## Step 1: Search
Find skills by keyword, or browse popular skills:
```bash
skillshare search # Browse popular skills
skillshare search pdf
skillshare search "code review"
skillshare search react
```
---
## Step 2: Browse Repositories
Explore skills in a repository:
```bash
# Official Anthropic skills
skillshare install anthropics/skills
# Community skills
skillshare install ComposioHQ/awesome-claude-skills
```
This enters **discovery mode** — shows all available skills in the repo.
---
## Step 3: Evaluate
Before installing, consider:
- **Does it solve my problem?** Read the description
- **Is it well-maintained?** Check the repo's activity
- **Will it conflict?** Check for name collisions with existing skills
Preview what would be installed:
```bash
skillshare install anthropics/skills/skills/pdf --dry-run
```
---
## Step 4: Install
### Single skill
```bash
skillshare install anthropics/skills/skills/pdf
```
### Multiple skills from one repo
```bash
# Interactive browse
skillshare install anthropics/skills
# Select specific skills (non-interactive)
skillshare install anthropics/skills -s pdf,commit
# Install all skills
skillshare install anthropics/skills --all
```
### Entire repo (for teams)
```bash
skillshare install github.com/team/skills --track
```
---
## Step 5: Sync
Don't forget to sync after installing:
```bash
skillshare sync
```
---
## Popular Skill Sources
| Source | URL |
|--------|-----|
| Anthropic Official | `anthropics/skills` |
| Vercel Agent Skills | `vercel-labs/agent-skills` |
| Community | [skillsmp.com](https://skillsmp.com/) |
---
## Discovery Commands
| Command | Purpose |
|---------|---------|
| `search` | Browse popular skills |
| `search <query>` | Search for skills |
| `check` | Check for available updates |
| `install <repo>` | Browse repo (discovery mode) |
| `install <repo/path>` | Install specific skill |
| `list` | Show installed skills |
---
## Installing Options
```bash
# Custom name
skillshare install anthropics/skills/skills/pdf --name my-pdf
# Force overwrite
skillshare install anthropics/skills/skills/pdf --force
# Update existing
skillshare install anthropics/skills/skills/pdf --update
# Track for team sharing
skillshare install github.com/team/skills --track
```
`--name` is valid only when the install target is a single skill.
Using `--name` with repo discovery that returns multiple skills will return an error.
---
## After Installing
### Verify
```bash
skillshare list
skillshare status
```
### Test
Use the skill in your AI CLI to make sure it works as expected.
### Check for updates
```bash
skillshare check # See what has updates available
```
### Update later
```bash
# Single skill (with source metadata)
skillshare install pdf --update
# Tracked repo
skillshare update _team-skills
```
---
## Related
- [Commands: search](/docs/commands/search) — Search command
- [Commands: install](/docs/commands/install) — Install command
- [Commands: check](/docs/commands/check) — Check for updates
- [Commands: list](/docs/commands/list) — List command