# Superpowers Ruby:handoff List

> Use when viewing available handoff documents — lists active and archived handoffs with their status, date, topic, and branch

- **Type:** Skill
- **Install:** `agentstack add skill-zarpay-rails-template-handoff-list`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [zarpay](https://agentstack.voostack.com/s/zarpay)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [zarpay](https://github.com/zarpay)
- **Source:** https://github.com/zarpay/rails-template/tree/main/files/.claude/skills/handoff-list

## Install

```sh
agentstack add skill-zarpay-rails-template-handoff-list
```

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

## About

# Handoff List

## Overview

Display all available handoff documents, both active (unrestored) and archived (consumed). Helps you decide which handoff to resume or review.

**Announce at start:** "I'm using the handoff-list skill to show available handoffs."

## When to Use

- When starting a session and unsure if handoffs exist
- When you want to review past handoff history
- Before using `superpowers-ruby:handoff-resume` to see what's available

## The Process

### Step 1: Scan Handoff Directories

```bash
# Active handoffs
ls docs/handoffs/*.md 2>/dev/null

# Archived handoffs
ls docs/handoffs/_archive/*.md 2>/dev/null
```

### Step 2: Parse Frontmatter

For each file found, read the YAML frontmatter to extract: `created`, `topic`, `branch`, `trigger`, `restored`.

### Step 3: Display Table

Present results with active (unrestored) handoffs first, then archived, sorted by date descending:

```
## Active Handoffs

| Date | Topic | Branch | Trigger |
|------|-------|--------|---------|
| 2026-04-14 | handoff-skill | lg/handoff | manual |

## Archived Handoffs

| Date | Topic | Branch | Trigger | Restored At |
|------|-------|--------|---------|-------------|
| 2026-04-13 | auth-refactor | fix/auth | compact | 2026-04-13T15:30:00 |
```

**If no handoffs exist:**

```
No handoff documents found in docs/handoffs/ or docs/handoffs/_archive/.

Use `/superpowers-ruby:handoff` to create one.
```

### Step 4: Offer Next Action

If active handoffs exist, offer:

> "Would you like to resume from one of the active handoffs? Use `/superpowers-ruby:handoff-resume`."

## Pairs With

- **superpowers-ruby:handoff** — Creates new handoff documents
- **superpowers-ruby:handoff-resume** — Resume from a specific handoff

## Source & license

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

- **Author:** [zarpay](https://github.com/zarpay)
- **Source:** [zarpay/rails-template](https://github.com/zarpay/rails-template)
- **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-zarpay-rails-template-handoff-list
- Seller: https://agentstack.voostack.com/s/zarpay
- 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%.