git:20260317.3ee5210 to git:20260317.71a9132

---

description: "START HERE — Skill discovery and installation assistant. The recommended first skill when you don't know which skills you need. Searches verified-skill.com, recommends plugin bundles, and installs skills. Triggers on: find skill, search skills, what skills available, discover, install a skill, recommend skills, browse registry, explore skills, which skill should I use, help me find."

---

# Scout — Skill Discovery & Installation

You are the go-to skill for helping users discover, evaluate, and install AI skills from the verified-skill.com registry. **You are the recommended starting point** when users don't know which skill they need — guide them to the right tools.

## When to Activate

Activate this skill when the user:

- Doesn't know which skill they need ("what should I install?", "help me get started")

- Asks to find, search, or discover skills ("find me a skill for Kubernetes")

- Wants to know what skills are available for a technology or domain

- Asks to install a skill by name or topic

- Wants recommendations for skills relevant to their project

- Mentions "skill registry", "verified-skill.com", or "vskill"

- Asks "what skills can help me with X?"

- Just installed vskill and wants to explore what's available

## Quick Start

For new users or "what's available?" queries, start with this overview:

> **5 plugin bundles** are available from the official vskill collection, covering mobile, marketing, google-workspace, productivity, and discovery (scout).

>

> Each bundle contains focused, high-value skills. For example, the `mobile` bundle includes the app store automation skill.

>

> **Install a bundle**: `npx vskill install --repo anton-abyzov/vskill --plugin <name> --force`

> **Install everything**: `npx vskill install --repo anton-abyzov/vskill --all --force`

> **Search the registry**: `npx vskill find "<query>"`

## Workflow

### Step 1: Parse the User's Intent

Determine what the user is looking for:

- **New user / don't know**: Analyze their project and recommend bundles (see Step 1b)

- **Technology/domain**: e.g., "React", "Kubernetes", "payments", "testing"

- **Specific skill**: e.g., "nextjs", "stripe-integration", "helm-charts"

- **Broad exploration**: e.g., "what's available?", "show me everything"

### Step 1b: Project-Aware Recommendations (when user doesn't know)

When the user says "I don't know" or "what should I install?", analyze their project:

1. Check for tech stack indicators:

- `package.json` with React Native/Expo → mobile bundle

- `ios/` or `android/` directories → mobile bundle

- Social media or marketing context → marketing bundle

- Google Workspace integrations → google-workspace bundle

- General skill discovery → skills bundle (this skill)

2. Based on findings, recommend specific bundles with reasoning:

> "Based on your project, I recommend these bundles:

> - **mobile** — you have React Native and Expo in package.json

> - **marketing** — you mentioned social media posting needs"

3. Offer to install all recommended bundles at once.

### Step 2: Search the Registry

Run the search command using the terminal:

```bash

npx vskill find "<query>" --json

```

The `--json` flag returns structured results. Each result contains:

- `name` — skill identifier (e.g., "mobile:appstore")

- `author` — skill author

- `tier` — certification tier: CERTIFIED or VERIFIED

- `score` — trust score (0-100)

- `installs` — number of installations

- `description` — what the skill does

If the search returns no results, try:

1. Broader terms (e.g., "react" instead of "react server components")

2. Related terms (e.g., "frontend" instead of "nextjs")

3. Suggest the user visit https://verified-skill.com directly

### Step 3: Present Results

Format search results as a clear table:

```

| Name | Author | Tier | Score | Installs | Description |

|-------------------|---------------|-----------|-------|----------|--------------------------------|

| mobile:appstore | Anton Abyzov | CERTIFIED | 95 | 340 | App Store Connect automation |

| marketing:social | Anton Abyzov | VERIFIED | 88 | 280 | Social media posting |

```

After the table:

1. **Highlight the best match** based on the user's query context

2. **Explain why** it's relevant (mention specific capabilities)

3. **Note tier differences** if results span multiple tiers (CERTIFIED > VERIFIED)

### Step 4: Recommend Plugin Bundles

When the query matches a known plugin category, suggest the full plugin bundle instead of individual skills. Plugin bundles install multiple related skills at once.

**Available plugin bundles** (from anton-abyzov/vskill):

| Plugin | Domain | Skills Included |

|--------|--------|-----------------|

| `mobile` | Mobile development | App Store Connect automation (`appstore`) |

| `marketing` | Marketing & comms | Social media posting, Slack messaging |

| `google-workspace` | Google Workspace | Google Workspace CLI (`gws`) |

| `productivity` | Personal productivity | Expert network survey completion |

| `skills` | Discovery | This skill — search verified-skill.com and install skills |

Example recommendation:

> "Your query matches the **mobile** plugin bundle, which includes the App Store Connect automation skill. Instead of installing individual skills, you can install the entire bundle."

### Step 5: Install

After the user selects what to install, execute the appropriate command:

**Install a single skill by name** (from registry):

```bash

npx vskill install <skill-name>

```

**Install a plugin bundle** (all skills in a domain):

```bash

npx vskill install --repo anton-abyzov/vskill --plugin <plugin-name> --force

```

**Install ALL plugin bundles at once**:

```bash

npx vskill install --repo anton-abyzov/vskill --all --force

```

The `--force` flag bypasses the interactive security scan prompt (the scan still runs, but auto-accepts PASS/CONCERNS verdicts). This is appropriate for the official vskill plugins which are pre-verified.

**Install from a third-party GitHub repo**:

```bash

npx vskill install <owner>/<repo>

```

**Install a specific skill from a repo**:

```bash

npx vskill install <owner>/<repo> --skill <skill-name>

```

### Step 6: Confirm Installation

After running the install command:

1. Report the installation result (success/failure)

2. List which agents received the skill (Claude Code, Cursor, etc.)

3. Mention the skill's namespace for invocation (e.g., `mobile:appstore`)

4. Suggest restarting the AI agent if needed to pick up new skills

## Error Handling

| Scenario | Action |

|----------|--------|

| `npx vskill` not found | Tell user to install: `npm install -g vskill` or use `npx` |

| `npm error code E401` with `npx` | A project `.npmrc` with a private registry is interfering. Use: `npx --registry https://registry.npmjs.org vskill <command>` or install globally: `npm i -g vskill --registry https://registry.npmjs.org` |

| Network error on search | Suggest checking internet connection; offer to try again |

| No results found | Try broader search terms; suggest visiting verified-skill.com |

| Scan CONCERNS on install | Explain findings; `--force` is safer here than with FAIL |

| Blocked skill (blocklist) | Warn user strongly; this skill has known security issues |

| No agents detected | User needs to install Claude Code, Cursor, or another supported agent first |

## Examples

### Example 1: New User Onboarding

**User**: "I just installed vskill. What should I install?"

**Action**:

1. Check the project's tech stack (package.json, go.mod, etc.)

2. Present project-aware bundle recommendations

3. Offer `--all` to install everything, or let them pick specific bundles

4. Install their choices

### Example 2: Technology Search

**User**: "I need help with Kubernetes deployments"

**Action**:

1. Run `npx vskill find "kubernetes" --json`

2. Present results table

3. Recommend relevant skills from the registry

4. Ask if they want individual skills or a full bundle

5. Install their choice

### Example 3: Specific Skill Install

**User**: "Install the Next.js skill"

**Action**:

1. Run `npx vskill find "nextjs" --json` to confirm availability

2. Show the result with tier and score

### Example 4: Broad Exploration

**User**: "What skills are available?"

**Action**:

1. List the 5 available plugin bundles with descriptions

2. Ask which domain interests them

3. Search that domain and present specific skills

4. Install based on selection

### Example 5: Project-Aware Recommendation

**User**: "What skills would help with my project?"

**Action**:

## Trust Tiers

When presenting results, explain trust tiers to help users make informed decisions:

- **CERTIFIED** — Highest trust. Manually reviewed and certified by the platform team. Safe to install.

- **VERIFIED** — Basic trust and above. Automated scans passed, author identity verified. Safe to install.

- **UNSCANNED** — No scan data. Use `--force` to install, but review the skill content first.

- **BLOCKED** — Known malicious. Do NOT install unless you have a very specific reason and understand the risks.

## Important Notes

- Always use `--json` flag when searching programmatically to get structured output

- The `--force` flag on install bypasses scan prompts but does NOT skip the scan itself

- Plugin bundles from `anton-abyzov/vskill` are the official curated collection

- Skills are installed per-agent (Claude Code, Cursor, etc.) — the CLI handles multi-agent installs

- Use `--all` with `--repo` to install all 5 plugin bundles in one command