Agent skill

Extract Plan Md

by closedloop-ai in closedloop-ai/claude-plugins

Sync plan.md with plan.json content. An agent skill from closedloop-ai/claude-plugins.

Apache-2.0Auto-check passedDocuments & Office

Install Extract Plan Md

skills CLI
$ npx skills add closedloop-ai/claude-plugins --skill extract-plan-md -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install closedloop-ai/claude-plugins extract-plan-md --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/closedloop-ai/claude-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/code/skills/extract-plan-md .claude/skills/extract-plan-md && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
extract-plan-md
GitHub stars
122
Token cost
~437 tokens
SKILL.md length
138 words
Files
2 (incl. scripts)
Skills in repo
41
Repo updated
First seen
Licence
Apache-2.0

At a glance

Sync plan.md with plan.json content. An agent skill from closedloop-ai/claude-plugins.

  • Works in 4 steps: Reads the plan.json file → Extracts the content key (which contains… → Fixes any escaped line breaks (\n ->… → …
  • Tasks that involve Markdown
  • SKILL.md covers IMPORTANT: When to Use, Usage and Examples
  • Runs Python scripts from its folder; calls python3

What it does

Extract Plan Md is an agent skill from closedloop-ai/claude-plugins. Sync plan.md with plan.json content. MUST be used after ANY edit to plan.json to keep plan.md in sync. Triggers: - After editing plan.json with Edit tool (REQUIRED - always sync after edits) - User asks to "sync plan.md", "update plan.md", "extract the md from a plan" - Converting plan.json to markdown or viewing plan as standalone markdown IMPORTANT: Whenever plan.json is modified, plan.md must be updated to match.

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/extract.py`).

It sits in Documents & Office, covering Markdown. The repository describes itself as: Open-source Claude Code plugins for multi-agent software delivery. Plan-first SDLC workflow, code review, LLM quality judges, and self-learning — grounded in your codebase… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Markdown

Example prompts

  • “sync plan.md”
  • “update plan.md”
  • “extract the md from a plan”
  • “/extract-plan-md”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Reads the plan.json file
  2. Extracts the content key (which contains the full markdown plan)
  3. Fixes any escaped line breaks (\n -> actual newlines)
  4. Writes to plan.md in the same directory as the plan.json

What it can do on your machine

Read from SKILL.md and the folder at commit 476b54c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Extract Plan Md loads about 437 tokens when it runs. Until then it costs about 109 tokens; SKILL.md has 138 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~109
When it runs · the whole SKILL.md, loaded when a task matches
~437

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from closedloop-ai/claude-plugins at commit 476b54c, republished under its Apache-2.0 licence (© closedloop-ai). 138 words, ~437 tokens.

Download SKILL.mdSave it as .claude/skills/extract-plan-md/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
extract-plan-md
description
Sync plan.md with plan.json content. MUST be used after ANY edit to plan.json to keep plan.md in sync. Triggers: - After editing plan.json with Edit tool (REQUIRED - always sync after edits) - User asks to "sync plan.md", "update plan.md", "extract the md from a plan" - Converting plan.json to markdown or viewing plan as standalone markdown IMPORTANT: Whenever plan.json is modified, plan.md must be updated to match.

Extract Plan MD

Sync plan.md with plan.json content. Use this skill after ANY edit to plan.json.

IMPORTANT: When to Use

REQUIRED after plan.json edits:

  • After using the Edit tool on plan.json → run this skill to sync plan.md
  • After programmatically modifying plan.json content field
  • After plan amendments, task status changes, or any plan modifications

Also use for:

  • User requests to sync/extract/convert plan.json to markdown
  • Reviewing a plan outside of the JSON structure
  • Sharing the plan with others who don't need the structured JSON fields

Usage

To sync plan.md with plan.json:

bash
python3 ${CLAUDE_SKILL_DIR}/scripts/extract.py /path/to/plan.json

The script:

  1. Reads the plan.json file
  2. Extracts the content key (which contains the full markdown plan)
  3. Fixes any escaped line breaks (\n -> actual newlines)
  4. Writes to plan.md in the same directory as the plan.json

Examples

After editing plan.json, sync plan.md:

bash
python3 ${CLAUDE_SKILL_DIR}/scripts/extract.py .closedloop-ai/work/plan.json
# Updates .closedloop-ai/work/plan.md to match

Extract from a specific plan:

bash
python3 ${CLAUDE_SKILL_DIR}/scripts/extract.py ~/work/plan.json
# Creates/updates ~/work/plan.md

© closedloop-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in plugins/code/skills/extract-plan-md of closedloop-ai/claude-plugins.

  • SKILL.md
  • scripts/extract.py

Open the folder on GitHubat commit 476b54c

Compare with similar skills

Extract Plan Md next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Extract Plan Md compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Extract Plan Md this skillclosedloop-ai/claude-plugins122—~437Automated safety check: PassApache-2.0
Markdown Article FormatterJimLiu/baoyu-skills26k7 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0
Crosspostingwasp-lang/wasp19k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 7 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Review The Docs

    supabase/supabase

    Official

    Review Supabase docs changes locally in your supabase/supabase checkout — either an open PR (triage, classify, verify) or your own branch before opening a PR (local self-review).

    111k GitHub stars~4.6k tokensUpdated today
    Documents & OfficeAuto-check passed

More from closedloop-ai/claude-plugins

All 41 skills in this repo
  • Codex Review

    closedloop-ai/claude-plugins

    Run Codex to review a plan file and return structured feedback with a verdict.

    122 GitHub stars~1.4k tokensUpdated today
    Auto-check: notes
  • Critic Cache

    closedloop-ai/claude-plugins

    Check if critic reviews are still valid before re-running Phase 2.5 critics.

    122 GitHub stars~528 tokensUpdated today
    Auto-check: notes
  • Cross Repo Cache

    closedloop-ai/claude-plugins

    Check if cross-repo coordinator results can be reused, avoiding redundant Sonnet agent launches.

    122 GitHub stars~683 tokensUpdated today
    Auto-check: notes
  • Eval Cache

    closedloop-ai/claude-plugins

    Check for a cached plan-evaluation.json result before launching the plan-evaluator agent.

    122 GitHub stars~516 tokensUpdated today
    Auto-check: notes
  • Find Plugin File

    closedloop-ai/claude-plugins

    This skill should be used when needing to locate files within the Claude Code plugins cache directory (~/.claude/plugins/cache).

    122 GitHub stars~812 tokensUpdated today
    Auto-check passed
  • Gh Monitor PR

    closedloop-ai/claude-plugins

    Start a detached GitHub pull-request monitor that wakes the exact launching Codex Desktop or CLI root through the managed Codex App Server when review, CI, conflict, merge-queue, closure, readiness…

    122 GitHub stars~5.1k tokensUpdated today
    Auto-check passed

Questions about Extract Plan Md

What does Extract Plan Md do?

Sync plan.md with plan.json content. An agent skill from closedloop-ai/claude-plugins. Extract Plan Md is an agent skill from closedloop-ai/claude-plugins.json content.

When should I use Extract Plan Md?

Extract Plan Md fits situations like: tasks that involve Markdown.

How do I install Extract Plan Md in Claude Code?

Run `npx skills add closedloop-ai/claude-plugins --skill extract-plan-md -a claude-code`. Or copy the skill folder (plugins/code/skills/extract-plan-md in closedloop-ai/claude-plugins) into .claude/skills/extract-plan-md in your project. Claude Code loads it when a task matches its description.

How do I install Extract Plan Md in Codex?

Run `npx skills add closedloop-ai/claude-plugins --skill extract-plan-md -a codex`. Or copy the skill folder (plugins/code/skills/extract-plan-md in closedloop-ai/claude-plugins) into .agents/skills/extract-plan-md in your project. Codex loads it when a task matches its description.

Can I use Extract Plan Md in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add closedloop-ai/claude-plugins --skill extract-plan-md -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/extract-plan-md, .gemini/skills/extract-plan-md, .github/skills/extract-plan-md and .opencode/skills/extract-plan-md in your project.

What does Extract Plan Md need to run?

Going by SKILL.md and its folder, Extract Plan Md needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Extract Plan Md access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Extract Plan Md safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Extract Plan Md use?

Extract Plan Md is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Extract Plan Md use?

About 437 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Extract Plan Md?

Skills that share tags, products or a category with Extract Plan Md: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and Gzh Design (isjiamu/gzh-design-skill, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Extract Plan Md?

closedloop-ai (a GitHub organization) maintains it in closedloop-ai/claude-plugins, which has 122 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 7, 2026.

Source: closedloop-ai/claude-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.