---
name: claude-plan-reader
description: Read and list planning documents from the ~/.claude/plans directory. Use when the user references a plan file located in the Claude plans directory or asks to see available plans.
---

# Claude Plan Reader

This skill allows you to interact with planning documents stored in the standard Claude plans directory (`~/.claude/plans/`).

## Workflows

### Listing Available Plans

When asked to see available plans or when you need to find a specific plan, list the contents of the plans directory.

**Command:**
```bash
ls ~/.claude/plans/
```

### Reading a Specific Plan

When a user provides a plan filename or path relative to the plans directory, read its content. Note that these files are outside the workspace, so you must use shell commands.

**Command:**
```bash
cat ~/.claude/plans/<filename>.md
```

## Guidelines

- **Always verify existence**: Use `ls` or `[ -f ... ]` to check if a file exists before attempting to read it if the filename is ambiguous.
- **Contextual Awareness**: Once a plan is read, treat its contents as the primary instructions for the subsequent tasks, as they often contain specific implementation steps and verification requirements.
- **Path Resolution**: If the user provides just a name (e.g., "hidden-swimming-clock"), assume it is a `.md` file in `~/.claude/plans/`.