Files
David Maynor 11c23bb4a6 fix: use >- folded scalar for SKILL.md descriptions (#20)
The literal block scalar (description: |) preserves newlines, causing
multi-line descriptions to render poorly in the Claude Code /skills
menu. This converts all 5 affected SKILL.md files to use the folded
strip scalar (>-), which collapses to a single line at parse time.

Also updates the skill-template reference to recommend >- so future
skills don't reintroduce the issue.

Affected plugins:
- skill-extractor
- ffuf-web-fuzzing
- humanizer
- planning-with-files
- wooyun-legacy
2026-02-22 22:09:49 -08:00
..
2026-02-11 18:47:40 -05:00
2026-02-11 18:47:40 -05:00
2026-02-11 18:47:40 -05:00
2026-02-11 18:47:40 -05:00

Planning with Files

File-based planning with persistent markdown files for complex multi-step tasks.

Installation

/plugin install trailofbits/skills-curated/plugins/planning-with-files

Usage

/plan

Creates three planning files in your project root:

  • task_plan.md -- phases, progress, decisions, error log
  • findings.md -- research discoveries and technical decisions
  • progress.md -- session log and test results

/status

Shows a compact summary of your current task phases and progress.

How It Works

The core idea: your context window is volatile RAM, the filesystem is persistent disk. Writing goals, decisions, and findings to markdown files prevents context drift during long tasks.

The key pattern is read-before-decide: re-reading task_plan.md before major decisions pushes goals back into the attention window, counteracting the "lost in the middle" effect that occurs after many tool calls.

The plugin includes a Stop hook that reports phase completion status when a session ends.

What's Included

Component Purpose
Skill Core planning methodology and rules
/plan command Create planning files from templates
/status command Show phase summary
Stop hook Report completion status on session end

Credits

Based on OthmanAdi/planning-with-files, which implements context engineering principles from Manus. Restructured as a curated Claude Code plugin with multi-IDE bloat removed, expensive hooks dropped, and templates cleaned up.