How do I install the List Plans skill?

Run npx skillmds@latest add tomevault-io/list-plans in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is List Plans safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with List Plans?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is List Plans free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published List Plans?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

List Plans by tomevault-io — Agent Skill

Name: List Plans
Author: tomevault-io

List Plans

List Claude Code plan files with titles, purposes, and progress. Use when user asks about plans, wants to see planning history, or needs to find a specific plan. Triggers on phrases like "list plans", "show my plans", "what plans exist", "planning history". Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

List Plans Command

Display Claude Code plan files stored in ~/.claude/plans/ with extracted metadata.

Quick Reference

list-plans-tool                    # Show 10 most recent plans
list-plans-tool --all              # Show all plans
list-plans-tool --limit 5          # Show 5 most recent
list-plans-tool --filter "deploy"  # Filter by title
list-plans-tool --json             # JSON output for scripting
list-plans-tool --help             # Show help

Output Information

For each plan file, displays:

Filename: The plan file name (e.g., happy-soaring-rabin.md)
Title: Extracted from first # heading in the file
Purpose: First paragraph after the title
Progress: Count of [x] completed vs [ ] pending checkboxes
Modified: Last modification timestamp

Use Cases

Find a plan: Use --filter to search by title keywords
Review recent work: Default shows 10 most recent by modification time
Scripting: Use --json for machine-readable output
Full inventory: Use --all to see complete plan history

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

Frequently asked questions