# SVK Setup

> >

- **Type:** Skill
- **Install:** `agentstack add skill-metallegbob-solana-vibes-kit-svk-setup`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [MetalLegBob](https://agentstack.voostack.com/s/metallegbob)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [MetalLegBob](https://github.com/MetalLegBob)
- **Source:** https://github.com/MetalLegBob/solana-vibes-kit/tree/main/svk-setup

## Install

```sh
agentstack add skill-metallegbob-solana-vibes-kit-svk-setup
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

**On first invocation this session**, silently perform a version check:

1. Look for `.claude/svk-meta.json` in the current project. If it doesn't exist, skip this check entirely.
2. Read the `svk_repo` path and `installed_version` from the metadata file.
3. Run: `git -C  fetch --tags --quiet 2>/dev/null`
4. Run: `git -C  tag --sort=-v:refname | head -1` to get the latest tag.
5. Compare the installed version against the latest tag (strip the leading `v`).
6. If they match, skip — the user is up to date.
7. If the latest tag is newer, show this message ONCE (never repeat in this session):

> **SVK Update Available:** v{latest} is available (you're on v{installed}).
> - **Update now:** I can pull and reinstall the changed skills in this session
> - **Update later:** Start a new chat and run `/SVK:update`

8. If the git commands fail (offline, repo moved, etc.), skip silently. Never show errors from version checking.

**Important:** Do NOT block or delay the user's actual command. Perform this check, show the notification if needed, then proceed with the command they invoked.

# SVK Setup

A guided onboarding skill that sets up your entire Solana development environment — not just SVK, but the full ecosystem of plugins, MCPs, and skills needed for productive Solana development.

> *"The first 30 minutes determine whether someone stays or bounces. Make them count."*

---

## Getting Started

SVK Setup runs as a 4-phase guided flow. The full command runs all phases in sequence; sub-commands let you re-run individual phases.

### Quick Start

```
/SVK-setup
```

This begins with a short interview about your experience and project, then recommends tools, walks through installation, and generates a reference doc. Follow the prompts.

### Full Pipeline

```
┌─────────────────────────────────────────────────────────────────────┐
│                         SVK SETUP v1.0                              │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  /SVK-setup:interview    Phase 1 — User Interview                  │
│  ═══════════════════     5-7 questions, one at a time               │
│  Experience gauging: git, Solana, Claude Code                       │
│  Project scoping: new/existing, type, frontend/backend, team       │
│  Output: .svk/SETUP_PROFILE.json                                    │
│                          │                                          │
│                          ▼                                          │
│  /SVK-setup:recommend    Phase 2 — Tiered Recommendations          │
│  ═══════════════════     Three tiers based on profile               │
│  Essential: always recommended (GSD, Superpowers, Safety Net, etc) │
│  Recommended: profile-dependent (Trail of Bits, Context7, etc)     │
│  Optional: shown but not pushed (Figma, Vercel, Docker, etc)       │
│  Output: .svk/SETUP_RECOMMENDATIONS.json                           │
│                          │                                          │
│                          ▼                                          │
│  /SVK-setup:install      Phase 3 — Installation Walkthrough        │
│  ═══════════════════     One category at a time                     │
│  Explain → choose → install → verify per tool                      │
│  Category order: Workflow → Safety → Solana → Search → Memory →    │
│    Security → Frontend → Backend → DevOps → Utility                │
│  Output: .svk/SETUP_INSTALLED.json                                  │
│                          │                                          │
│                          ▼                                          │
│  /SVK-setup:reference    Phase 4 — Reference Document              │
│  ═══════════════════     Personalized setup reference               │
│  Getting started, installed tools, skipped tools, quick reference  │
│  Output: docs/svk-setup-reference.md                                │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘
```

### Typical Workflow

For first-time users, just run `/SVK-setup` and follow the prompts. The full flow takes 10-20 minutes depending on how many tools you install.

To re-run individual phases later:
- **`/SVK-setup:interview`** — Re-do the interview (resets profile)
- **`/SVK-setup:recommend`** — Re-generate recommendations from existing profile
- **`/SVK-setup:install`** — Install additional tools
- **`/SVK-setup:reference`** — Re-generate the reference document

---

## Foundation Patterns

| Pattern | How SVK Setup Uses It |
|---------|----------------------|
| Progressive Disclosure | Tool catalog indexed by category, loaded per-category during walkthrough |
| Signal-Based Indexing | Interview answers drive which catalog entries are surfaced |

---

## Output Structure

SVK Setup writes state to `.svk/` in the project root and the reference doc to `docs/`:

```
.svk/
├── SETUP_PROFILE.json          # User profile from interview
├── SETUP_RECOMMENDATIONS.json  # Tiered tool recommendations
└── SETUP_INSTALLED.json        # What was installed/skipped

docs/
└── svk-setup-reference.md      # Personalized reference document
```

---

## User Profiles

The interview produces one of three profiles that tune all subsequent behavior:

| Profile | Git | Solana | Claude Code | Behavior |
|---------|-----|--------|-------------|----------|
| **Beginner** | None/Basic | No/Learning | New | Extra explanations, guardrails emphasized, learning resources |
| **Intermediate** | Comfortable | Learning/Shipped | Some | Standard explanations, full recommended tier |
| **Advanced** | Comfortable | Shipped | Power user | Minimal hand-holding, full catalog available, cherry-pick |

---

## Tool Tiers

| Tier | Selection Logic |
|------|----------------|
| **Essential** | Always recommended regardless of profile |
| **Recommended** | Shown based on project type and experience |
| **Optional** | Listed for awareness, not pushed |

See `resources/tool-catalog.md` for the complete registry.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [MetalLegBob](https://github.com/MetalLegBob)
- **Source:** [MetalLegBob/solana-vibes-kit](https://github.com/MetalLegBob/solana-vibes-kit)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-metallegbob-solana-vibes-kit-svk-setup
- Seller: https://agentstack.voostack.com/s/metallegbob
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
