# AutoVault Quick Start

Install AutoVault, seed the bundled skills, add a skill, scope it, and run it from an agent.

## 1. Install

```bash
curl -fsSL https://autovault.sh | sh
export PATH="$HOME/.autovault/bin:$PATH"
autovault skill list
```

The installer builds the Node app under ~/.autovault/app, writes the shim to ~/.autovault/bin/autovault, preserves ~/.autovault as storage, and bootstraps bundled skills unless AUTOVAULT_NO_BOOTSTRAP=1 is set.

## 2. Seed bundled skills manually

```bash
npm run build
node scripts/bootstrap-skills.mjs
```

Bootstrap installs every bundled skill (skills/*/SKILL.md) through the same validation path as any other skill and refreshes discovered host profiles.

## 3. Add a remote skill

```bash
autovault add github:autoworks-ai/skills/extract-pdf
```

Remote skills are untrusted until they pass validation and signing.

## 4. Add a local bundle

```bash
autovault add-local ./skills/railway --source railway/skills --sync-profiles
```

add-local requires SKILL.md, gathers sibling resources, refuses symlinks, records local provenance, and can refresh discovered profile roots. MCP add_skill and update_skill local-bundle calls sync configured profile links by default.

## 5. Sync native agent profiles

```bash
autovault sync-profiles --discover
```

Discovery checks native skill roots such as ~/.claude/skills, ~/.codex/skills, and ~/.cursor/skills. Set AUTOVAULT_PROFILE_LINKS for managed roots that should refresh on install, propose, update, delete, or transform changes.

## 6. Vendor installer routing

AUTOVAULT_SKILL_INSTALL controls whether vendor installers prefer AutoVault, install both AutoVault and native copies, use native-first fallback, native-only, or skip skill installation.