# Snapshot

> >

- **Type:** Skill
- **Install:** `agentstack add skill-pedro-b-siqueira-snapshot-snapshot`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Pedro-B-Siqueira](https://agentstack.voostack.com/s/pedro-b-siqueira)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Pedro-B-Siqueira](https://github.com/Pedro-B-Siqueira)
- **Source:** https://github.com/Pedro-B-Siqueira/snapshot/tree/master/skills/snapshot

## Install

```sh
agentstack add skill-pedro-b-siqueira-snapshot-snapshot
```

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

## About

# Snapshot — `/snapshot`

## What this skill does

When the user types `/snapshot`, read the entire conversation and produce a single
copy-pasteable block that preserves all critical context — so they can open a new
chat and pick up exactly where they left off, without re-explaining anything.

---

## How to generate the snapshot

### Step 1 — Read the full conversation
Scan every message before writing a single word of output.

### Step 2 — Extract critical elements
Look for:
- **Project context**: name, stack, language, frameworks, environment, repo
- **Main goal**: what was being built or solved
- **Key decisions**: architecture choices, libraries picked, alternatives rejected and why
- **Essential code**: central functions, data structures, configs, API contracts
- **Problems & fixes**: bugs hit, errors seen, workarounds applied
- **Current state**: what's working, what's broken, what's untouched
- **Next steps**: anything explicitly agreed upon or left pending
- **Sensitive data screening**: STRICTLY IDENTIFY AND IGNORE all API keys, access tokens, passwords, and sensitive credentials.

### Step 3 — Write the output block

Use **exactly** this format — no extra commentary before or after:

~~~
## 📸 Session Snapshot

**Project:** [name / one-line description]
**Stack:** [languages, frameworks, key tools]
**Goal:** [what was being built or solved]

---

### What we did

• [Bullet 1 — critical decision or action, self-contained with enough context to never need re-asking]
• [Bullet 2 — ...]
• [Bullet 3 — ...]
• [Bullet 4 — ...]
• [Bullet 5 — ...] ← minimum 5
• [Bullet 6 — ...] ← include if there's relevant content
• [Bullet 7 — ...] ← include if there's relevant content

---

### Current state
[2–4 lines: what's working, what's pending, what's broken]

---

### Essential code
```[language]
[Only the most critical snippet — key function, data structure, config, or API shape.
Omit this section entirely if no code is relevant.]
```

---

### Security Note
[Include ONLY IF sensitive data like API keys/tokens were shared in the session but skipped:]
> ⚠️ **Notice:** Chaves sensíveis (API keys, tokens, etc.) foram compartilhadas na sessão original, mas foram ignoradas e removidas na criação deste snapshot por motivos de segurança.

---

### Agreed next steps
• [Next step 1]
• [Next step 2]

---
> Paste this block at the top of your next chat to continue right where you left off.
~~~

---

## Quality rules

- **Every bullet must be self-contained** — someone reading it cold should have full context, no guessing.
- **Be specific** — use real file names, function names, variable names, error messages. Never generalize.
- **Decisions need reasons** — if something was rejected, say why (e.g., "dropped Redux for Zustand — too much boilerplate for this scope").
- **Code only if essential** — don't paste everything; only what a new chat would need to avoid rework.
- **No filler** — never write "we did several interesting things". Be direct and dense.
- **Privacy first** — NEVER include API keys, passwords, or sensitive credentials in the snapshot.
- **Match the user's language** — if they wrote in Portuguese, snapshot in Portuguese. If English, English.
- **Bullet length** — 1–3 lines each. No sub-bullets.

---

## Short session handling

If the session has fewer than 3 meaningful exchanges or no substantial technical content, respond with:

> "The session is too short for a useful snapshot yet. Keep working and run `/snapshot` again when there's more to capture."

---

## Example: bad bullet vs. good bullet

❌ Bad:
> • We worked on authentication and fixed some issues.

✅ Good:
> • Implemented JWT auth with refresh tokens — access token expires in 15min, refresh in 7 days. Refresh token is stored in an `httpOnly` cookie (not localStorage) to prevent XSS. Refresh endpoint is `POST /api/auth/refresh`. Rejected session-based auth because the app is stateless.

## Source & license

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

- **Author:** [Pedro-B-Siqueira](https://github.com/Pedro-B-Siqueira)
- **Source:** [Pedro-B-Siqueira/snapshot](https://github.com/Pedro-B-Siqueira/snapshot)
- **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-pedro-b-siqueira-snapshot-snapshot
- Seller: https://agentstack.voostack.com/s/pedro-b-siqueira
- 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%.