# Quickstart

> Guided first-run that produces a real verified win in under five minutes using the skill library on a seeded offline fixture. Load when a new user asks how to start, run the demo, try agent-loom, or get a quick win. Also triggers on "quickstart", "first run", "demo agent-loom", "try the skills", or onboarding to the library. Zero external credentials required. Idempotent — safe to run multiple times.

- Skill: `dvy1987/quickstart` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add dvy1987/quickstart`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvy1987/quickstart/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: dvy1987 (https://skillmd.com/u/dvy1987)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/dvy1987/quickstart

---

# Quickstart

You get a new user to a **real, verified result** in ~5 minutes — not a staged fake. Demo uses `safe-change` on `examples/seed/calc/`.

## Hard Rules

Zero external credentials — offline fixture only.
Invoke a **real skill** (`safe-change`) — never simulate success.
Idempotent — if fix already applied, run impact map + tests and report "already done."
End with one-line "what just happened" + link to `examples/` tours.
Total flow ≤5 minutes wall clock.

---

## Workflow

### Step 1 — Confirm install

User has agent-loom skills visible (`.agents/skills/` or global install). If missing, point to `README.md` Installation.

### Step 2 — Run demo (read `references/DEMO-FLOW.md`)

1. `cd examples/seed/calc` (or pass path to verify.sh)
2. `dependency-mapping` on `divide` in `calc.py`
3. `safe-change` — add zero guard; **verify fails before fix, passes after**
4. `bash .agents/skills/safe-change/scripts/verify.sh examples/seed/calc`

### Step 3 — Explain

```markdown
**What just happened:** You ran impact mapping → one verified edit → tests green.
That's the safe-change loop — the library's highest-leverage coding skill.
```

### Step 4 — Next steps

Point to:
- `examples/safe-change-demo/README.md`
- `examples/structured-planning-demo/README.md`
- `examples/deploy-anywhere-demo/README.md`
- `docs/why-agent-loom.md`

---

## Gotchas

- pytest may need `pip install pytest` once — document if missing.
- User on Windows: use same paths with forward slashes in agent prompts.

---

## Output Format

```markdown
## Quickstart complete

Result: [KEPT | already fixed]
Verify: pytest → [pass]
What happened: [one line]
Next: [examples link]
```

---

## Examples

Full walkthrough: `references/DEMO-FLOW.md`

---

## Common Rationalizations

| Excuse | Reality |
|--------|---------|
| "Fake a passing test" | Destroys trust — run real safe-change. |
| "Skip install check" | User without skills gets a confusing failure. |
| "Long architecture tour first" | Win first, depth second. |
| "Use a remote repo" | Needs network + creds — seed is offline. |
| "Combine all five skills" | One win — safe-change only. |

## Verification

- [ ] Real skill invoked (not simulated)
- [ ] pytest run on seed fixture
- [ ] User told what happened in one line
- [ ] Next-step links provided

## Red Flags

- Simulated verify pass
- Demo requires API keys
- No reference to examples/

## Prune Log
Last pruned: 2026-07-05
- Initial release from high-leverage skill spec (Skill 5 family)

## Impact Report

```
Quickstart: [pass|already-done] | Skill: safe-change | Fixture: examples/seed/calc
```