New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Active Plan Audit

by withkynam in withkynam/vibecode-pro-max-kit

Reviews a codebase's active plan files for staleness and completion, then archives only the ones confirmed done or obsolete against the real code.

MITAuto-check passedProduct & Project Management

Install Active Plan Audit

skills CLI
$ npx skills add withkynam/vibecode-pro-max-kit --skill vc-audit-plans -a claude-code

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

GitHub CLI
$ gh skill install withkynam/vibecode-pro-max-kit vc-audit-plans --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/withkynam/vibecode-pro-max-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/vc-audit-plans .claude/skills/vc-audit-plans && 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
vc-audit-plans
GitHub stars
1.1k
Token cost
~757 tokens
SKILL.md length
343 words
Files
19 (incl. scripts, references)
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

Reviews a codebase's active plan files for staleness and completion, then archives only the ones confirmed done or obsolete against the real code.

  • Works in 3 steps: Read references/audit-plans.md for the… → Run the inventory validator → Inventory plans in…
  • Cleaning up active plan files after a burst of finished work
  • SKILL.md covers Workflow and Output
  • Calls node and git

What it does

Treats plan cleanup as maintenance and recovery rather than something run automatically after every task, triggered when drift has built up, a periodic cleanup is wanted, or several active plans need reconciling after a burst of work. It reads a dedicated audit reference for the full process, then runs a bundled inventory validator script before scanning both general and feature-scoped active-plan folders one level deep into their dated task subfolders.

Only files whose name ends in `_PLAN_` count as plans; co-located report, reference and spec files inside the same task folder are scanned alongside each plan but not counted as plans themselves, and any such file sitting in a deprecated sibling folder instead of inside its owning task folder gets flagged as mis-located with a suggested move. Each plan is then cross-checked against the actual codebase with file-existence checks and targeted searches and classified as Completed, Partially Done, Obsolete, Stale, Active, or Reference.

Only plans clearly completed or obsolete get moved, as a whole task folder, into the matching completed directory, and the skill asks before deleting anything at all. The inventory validator is run again after any move or edit to confirm the audited state actually matches disk.

When your agent uses it

  • Cleaning up active plan files after a burst of finished work
  • Reconciling several active plans against what the codebase actually has
  • Running a periodic audit of stale or completed project plans
  • Finding plan artifacts that landed in the wrong folder

Example prompts

  • “Audit the active plans under the billing feature and archive anything that's done.”
  • “Run a full plan audit across process/features and flag anything stale.”
  • “Check if this plan folder's report files are sitting in the wrong place.”

Requirements

  • Node.js, to run the bundled inventory validator script

Workflow steps

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

  1. Read references/audit-plans.md for the full audit process.
  2. Run the inventory validator
  3. Inventory plans in process/general-plans/active/ and process/features/*/active/. Plans now live inside {slug}_{date}/ task subfolders…

What it can do on your machine

Read from SKILL.md and the folder at commit 3bcb2f9. 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 9 files in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Active Plan Audit loads about 757 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 45 tokens; SKILL.md has 343 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~757
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

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 withkynam/vibecode-pro-max-kit at commit 3bcb2f9, republished under its MIT licence (© withkynam). 343 words, ~757 tokens.

Download SKILL.mdSave it as .claude/skills/vc-audit-plans/SKILL.md (or your agent's skills folder). This skill also uses 18 other files; get the full folder from GitHub.
name
vc-audit-plans
description
Audit active project plan files for staleness, completion, and routing truth. Use when cleaning up plans, reconciling active work, or archiving completed artifacts.
trigger_keywords
audit plans, plan inventory, stale plans, active plan count
layer
contract
metadata.author
vibecode-pro-max-kit
metadata.version
1.0.0

Audit Plans

Output style: Follow process/development-protocols/communication-standards.md — answer-first, plain language, no unexplained jargon, TL;DR on long responses.

Use this skill to review active plan artifacts and reconcile them with the current codebase.

This is a maintenance and recovery skill, not an automatic post-task hook.

Optional input: a feature, folder, plan filename, or maintenance scope to prioritize.

Prefer it when:

  • UPDATE PROCESS was skipped and active-plan cleanup drift accumulated
  • the user wants a periodic active-plan cleanup pass
  • multiple active plans need reconciliation after a burst of work

Workflow

  1. Read references/audit-plans.md for the full audit process.
  2. Run the inventory validator:
    bash
    node .claude/skills/vc-audit-plans/scripts/validate-plan-inventory.mjs
  3. Inventory plans in process/general-plans/active/ and process/features/*/active/. Plans now live inside {slug}_{date}/ task subfolders — scan one level deep. Do NOT count _REPORT_, _REF_, or _SPEC_ files inside task folders as plans; only _PLAN_ files count. For feature-scoped audits, first run find process/features/{feature}/ -type f | sort for full artifact visibility. For full audits, run find process/features/ -type f | sort to see all feature artifacts across all subdirs (active, completed, backlog, references, reports). 3.5. Scan task folder contents (co-located REPORT/REF/SPEC files) alongside each plan. Per task-folder artefact colocation, the correct home for every artefact (plan, spec, reports, references) is INSIDE its {slug}_{date}/ task folder; flag any task artefact found in the deprecated sibling reports//references/ dirs or any ad-hoc location as mis-located, and recommend moving it into the owning task folder. Match by feature slug, date proximity (7 days), or content reference to the plan filename.
  4. Cross-check each plan against the actual codebase with file existence checks and targeted rg searches.
  5. Classify each plan as Completed, Partially Done, Obsolete, Stale, Active, or Reference.
  6. Move only clearly completed or obsolete plans to the appropriate completed/ folder. Use git mv active/{slug}_{date}/ completed/{slug}_{date}/ — move the WHOLE task folder; no completed_ prefix added.
  7. Ask before deleting anything.
  8. Re-run the inventory validator after moving or editing plan files.

Output

Return a concise summary table with classification, action taken, and any user decisions needed. Include stale artifact findings (reports/references tied to completed or obsolete plans) with recommended actions.

© withkynam, MIT. 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 18 other files (scripts, references) in .claude/skills/vc-audit-plans of withkynam/vibecode-pro-max-kit.

  • SKILL.md
  • references/audit-plans.md
  • scripts/eval-coverage-known-gaps.json
  • scripts/fixtures/validate-backlog-notes/fail/malformed_NOTE.md
  • scripts/fixtures/validate-backlog-notes/pass/d2-fix-deferred_NOTE.md
  • scripts/fixtures/validate-phase-plan-completeness/fail.md
  • scripts/fixtures/validate-phase-plan-completeness/pass.md
  • scripts/fixtures/validate-phase-reports/fail/umbrella.md
  • scripts/fixtures/validate-phase-reports/pass/phase-01_REPORT.md
  • scripts/fixtures/validate-phase-reports/pass/umbrella.md
  • scripts/fixtures/validate-umbrella-state
  • … and 8 more

Open the folder on GitHubat commit 3bcb2f9

Compare with similar skills

Active Plan Audit 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.

Active Plan Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Active Plan Audit this skillwithkynam/vibecode-pro-max-kit1.1k—~757Automated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Jira Natural Language Interfacejjmartres/opencode1333 repos~1.7kAutomated safety check: PassMIT
Project Planneradrianpuiu/claude-skills-marketplace1001 repos~6kAutomated safety check: PassNone
Milestone Project Managerfinna/project-manager-skill135—~4.3kAutomated safety check: PassNone
Linear Ticket SOPbybren-llc/safe-agentic-workflow421—~1.8kAutomated safety check: PassMIT

Similar skills

  • CCPM Project Management

    automazeio/ccpm

    Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed

  • Jira Natural Language Interface

    jjmartres/opencode

    Lets an agent view, create, update and transition Jira issues in natural language, automatically choosing between the jira CLI and Atlassian MCP tools.

    133 GitHub starsUsed in 3 repos~1.7k tokens
    Product & Project ManagementAuto-check passed

  • Project Planner

    adrianpuiu/claude-skills-marketplace

    Comprehensive project planning and documentation generator for software projects.

    100 GitHub starsUsed in 1 repo~6k tokens
    Product & Project ManagementAuto-check passed

  • Milestone Project Manager

    finna/project-manager-skill

    Drives an authorized software, app or game project to completion through small milestones, an existing implementation thread, independent testing of the exact build and retest loops.

    135 GitHub stars~4.3k tokensUpdated 8 days ago
    Product & Project ManagementAuto-check passed

  • Linear Ticket SOP

    bybren-llc/safe-agentic-workflow

    Ticket management best practices for Linear or equivalent project tracker. Use when creating issues, updating ticket status, attaching evidence, parsing…

    421 GitHub stars~1.8k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed

  • Gsd Plant Seed

    SpillwaveSolutions/agent-brain

    Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone

    119 GitHub starsUsed in 2 repos~691 tokens
    Product & Project ManagementAuto-check passed

More from withkynam/vibecode-pro-max-kit

All 32 skills in this repo

  • Library Documentation Seeker

    withkynam/vibecode-pro-max-kit

    Looks up library and framework documentation through Context7 first, with bundled Node scripts as a fallback that fetch and analyze llms.txt files.

    1.1k GitHub starsUsed in 2 repos~1k tokens
    Auto-check: notes

  • Vc Sequential Thinking

    withkynam/vibecode-pro-max-kit

    Apply step-by-step analysis for complex problems with revision capability.

    1.1k GitHub starsUsed in 2 repos~854 tokens
    Auto-check passed

  • Agent Browser Automation

    withkynam/vibecode-pro-max-kit

    Drives a browser through the agent-browser CLI, using compact snapshots with element refs to keep context small in long sessions, plus video recording and cloud browsers.

    1.1k GitHub stars~2.6k tokensUpdated 3 mo ago
    Auto-check passed

  • Context Routing Audit

    withkynam/vibecode-pro-max-kit

    Audits a project's context routing, skill discoverability and skill wiring by running a chain of validator scripts and fixing whatever they report.

    1.1k GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed

  • Systematic Debugging and Investigation

    withkynam/vibecode-pro-max-kit

    Forces root-cause investigation before any fix, combining a four-phase debugging method with log, CI and performance investigation techniques and a rule against unverified completion claims.

    1.1k GitHub stars~1.5k tokensUpdated 3 mo ago
    Auto-check passed

  • Repository Context Generator

    withkynam/vibecode-pro-max-kit

    Generates or refreshes a project's shared repository context file so both Codex and Claude work from the same up-to-date knowledge layer.

    1.1k GitHub stars~817 tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about Active Plan Audit

What does Active Plan Audit do?

Reviews a codebase's active plan files for staleness and completion, then archives only the ones confirmed done or obsolete against the real code. Treats plan cleanup as maintenance and recovery rather than something run automatically after every task, triggered when drift has built up, a periodic cleanup is wanted, or several active plans need reconciling after a burst of work. It reads a dedicated audit reference for the full process, then runs a bundled inventory validator script before scanning both general and feature-scoped active-plan folders one level deep into their dated task subfolders.

When should I use Active Plan Audit?

Active Plan Audit fits situations like: cleaning up active plan files after a burst of finished work; reconciling several active plans against what the codebase actually has; running a periodic audit of stale or completed project plans; finding plan artifacts that landed in the wrong folder.

How do I install Active Plan Audit in Claude Code?

Run `npx skills add withkynam/vibecode-pro-max-kit --skill vc-audit-plans -a claude-code`. Or copy the skill folder (.claude/skills/vc-audit-plans in withkynam/vibecode-pro-max-kit) into .claude/skills/vc-audit-plans in your project. Claude Code loads it when a task matches its description.

How do I install Active Plan Audit in Codex?

Run `npx skills add withkynam/vibecode-pro-max-kit --skill vc-audit-plans -a codex`. Or copy the skill folder (.claude/skills/vc-audit-plans in withkynam/vibecode-pro-max-kit) into .agents/skills/vc-audit-plans in your project. Codex loads it when a task matches its description.

Can I use Active Plan Audit 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 withkynam/vibecode-pro-max-kit --skill vc-audit-plans -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vc-audit-plans, .gemini/skills/vc-audit-plans, .github/skills/vc-audit-plans and .opencode/skills/vc-audit-plans in your project.

What does Active Plan Audit need to run?

Going by SKILL.md and its folder, Active Plan Audit needs the command-line tools its instructions call (node and git). Our summary lists: Node.js, to run the bundled inventory validator script.

Does Active Plan Audit access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Active Plan Audit 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 Active Plan Audit use?

Active Plan Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Active Plan Audit use?

About 757 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Active Plan Audit?

Skills that share tags, products or a category with Active Plan Audit: CCPM Project Management (automazeio/ccpm, 8.4k stars), Jira Natural Language Interface (jjmartres/opencode, 133 stars), Project Planner (adrianpuiu/claude-skills-marketplace, 100 stars) and Milestone Project Manager (finna/project-manager-skill, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Active Plan Audit?

withkynam (a GitHub user) maintains it in withkynam/vibecode-pro-max-kit, which has 1,145 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on June 21, 2026.

Source: withkynam/vibecode-pro-max-kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.