extract-plan-md

Synchronize markdown content from a JSON plan file to a markdown file.

102|10|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/closedloop-ai/claude-plugins --skill extract-plan-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extract-plan-md
Source: https://github.com/closedloop-ai/claude-plugins/tree/main/plugins/code/skills/extract-plan-md
Command: npx skills add https://github.com/closedloop-ai/claude-plugins --skill extract-plan-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures that your human-readable plan.md file accurately reflects the structured data within your plan.json file, preventing discrepancies and keeping your project documentation up-to-date.

Core Features & Use Cases

  • Automatic Synchronization: Updates plan.md whenever plan.json is modified.
  • Content Extraction: Extracts the markdown content from the content field of plan.json.
  • Use Case: After making changes to your project plan in plan.json using an editor tool, run this Skill to instantly update the corresponding plan.md so that the latest details are visible and accessible.

Quick Start

Use the extract-plan-md skill to sync plan.md with plan.json located at .claude/work/plan.json.

Frequently Asked Questions about extract-plan-md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync a markdown file with a JSON plan file?

You can sync a markdown file with a JSON plan file by running a Python script that parses the JSON data and writes the extracted content directly into the corresponding markdown documentation.

How to extract markdown content from a JSON file for project planning?

To extract markdown content from a JSON file, the script reads the structured plan.json file, retrieves the content field, and writes that human-readable data into a markdown file to keep project documentation accurate.

Why does my plan.md not match my plan.json after updates?

Your plan.md may not match plan.json because the markdown file requires manual synchronization after JSON edits. Running a script to extract and write the JSON content field updates the markdown automatically.

Do I need Python to synchronize plan.json with plan.md?

Yes, you need Python to synchronize plan.json with plan.md because the process relies on executing a Python script to parse the structured JSON data and write the extracted content into the markdown file.

What is the best way to maintain consistency between structured JSON data and markdown documentation?

The best way to maintain consistency between structured JSON data and markdown documentation is to use a synchronization script that automatically extracts the JSON content field and overwrites the markdown file whenever changes occur.