aiskillstore/marketplace / skills/0xdarkmatter/project-planner
project-planner
VerifiedDetects stale project plans and suggests session commands. Triggers on: sync plan, update plan, check status, plan is stale, track progress, project planning.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.0 KB |
| assets/.gitkeep | other | 0 B |
| references/.gitkeep | other | 0 B |
| scripts/.gitkeep | other | 0 B |
| skill-report.json | config | 21.8 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-04T13:06:52.924Z",
"slug": "0xdarkmatter-project-planner",
"source_url": "https://github.com/0xDarkMatter/claude-mods/tree/main/skills/project-planner",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "7582215c9ef2a2e1e4f098b1420e280ce602dc7d188b6281f61b9bf9c216b421",
"tree_hash": "4365bb8ce6b311d36f5f9fc7aadc3ba8380b90e9b4f1357b21ddb589433c1054",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "project-planner",
"description": "Detects stale project plan notes and suggests session commands for saving, syncing, or reviewing docs/PLAN.md.",
"summary": "Helps AI coding sessions keep docs/PLAN.md current by detecting stale plans and suggesting next actions.",
"icon": "📦",
"version": "1.0.1",
"author": "0xDarkMatter",
"license": "MIT",
"tags": [
"project-planning",
"plan-sync",
"status-tracking",
"developer-workflow",
"documentation"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands"
],
"category": "productivity"
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "All 17 static findings are false positives from Markdown backticks used for file names, fenced examples, and slash-command references in SKILL.md. No evidence found of shell execution, prompt injection, network access, environment access, or data exfiltration intent.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 12,
"line_end": 12
},
{
"file": "SKILL.md",
"line_start": 17,
"line_end": 17
},
{
"file": "SKILL.md",
"line_start": 21,
"line_end": 21
},
{
"file": "SKILL.md",
"line_start": 26,
"line_end": 29
},
{
"file": "SKILL.md",
"line_start": 29,
"line_end": 32
},
{
"file": "SKILL.md",
"line_start": 32,
"line_end": 36
},
{
"file": "SKILL.md",
"line_start": 36,
"line_end": 39
},
{
"file": "SKILL.md",
"line_start": 39,
"line_end": 43
},
{
"file": "SKILL.md",
"line_start": 43,
"line_end": 46
},
{
"file": "SKILL.md",
"line_start": 46,
"line_end": 49
},
{
"file": "SKILL.md",
"line_start": 49,
"line_end": 55
},
{
"file": "SKILL.md",
"line_start": 55,
"line_end": 56
},
{
"file": "SKILL.md",
"line_start": 56,
"line_end": 57
},
{
"file": "SKILL.md",
"line_start": 57,
"line_end": 58
},
{
"file": "SKILL.md",
"line_start": 58,
"line_end": 59
},
{
"file": "SKILL.md",
"line_start": 59,
"line_end": 76
},
{
"file": "SKILL.md",
"line_start": 76,
"line_end": 76
}
]
}
],
"static_findings": [
{
"id": "external_commands:SKILL.md:12:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 12,
"line_end": 12,
"snippet": "Lightweight awareness layer for `docs/PLAN.md`. Detects when plans need attention and points to `/sa"
},
{
"id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 17,
"line_end": 17,
"snippet": "- Detects when `docs/PLAN.md` exists or is missing"
},
{
"id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 21,
"line_end": 21,
"snippet": "All plan operations go through `/save` (persist) and `/sync` (restore/status)."
},
{
"id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 26,
"line_end": 29,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 29,
"line_end": 32,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 32,
"line_end": 36,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 36,
"line_end": 39,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:39:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 39,
"line_end": 43,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 43,
"line_end": 46,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 46,
"line_end": 49,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:49:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 49,
"line_end": 55,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 55,
"line_end": 56,
"snippet": "| No plan exists | `/save` after discussing goals |"
},
{
"id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 56,
"line_end": 57,
"snippet": "| Plan is stale | `/sync --git` |"
},
{
"id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 57,
"line_end": 58,
"snippet": "| Need to see plan | `/sync --status` |"
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 58,
"line_end": 59,
"snippet": "| Update progress | `/save \"notes\"` |"
},
{
"id": "external_commands:SKILL.md:59:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 59,
"line_end": 76,
"snippet": "| Start fresh | `/save --archive` |"
},
{
"id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 76,
"line_end": 76,
"snippet": "- `/sync` reads state, `/save` writes state"
}
],
"finding_verdicts": [
{
"id": "external_commands:SKILL.md:12:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 12 uses Markdown inline code formatting for docs/PLAN.md or slash-command names. No external command execution, interpolation, or runnable script is present."
},
{
"id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 17 uses Markdown inline code formatting for docs/PLAN.md or slash-command names. No external command execution, interpolation, or runnable script is present."
},
{
"id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 21 uses Markdown inline code formatting for docs/PLAN.md or slash-command names. No external command execution, interpolation, or runnable script is present."
},
{
"id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 26 is part of a Markdown fenced example describing plan states and suggested slash commands. It is not Ruby code or shell backtick execution."
},
{
"id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 29 is part of a Markdown fenced example describing plan states and suggested slash commands. It is not Ruby code or shell backtick execution."
},
{
"id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 32 is part of a Markdown fenced example describing plan states and suggested slash commands. It is not Ruby code or shell backtick execution."
},
{
"id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 36 is part of a Markdown fenced example describing plan states and suggested slash commands. It is not Ruby code or shell backtick execution."
},
{
"id": "external_commands:SKILL.md:39:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 39 is part of a Markdown fenced example describing plan states and suggested slash commands. It is not Ruby code or shell backtick execution."
},
{
"id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 43 is part of a Markdown fenced example describing plan states and suggested slash commands. It is not Ruby code or shell backtick execution."
},
{
"id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 46 is part of a Markdown fenced example describing plan states and suggested slash commands. It is not Ruby code or shell backtick execution."
},
{
"id": "external_commands:SKILL.md:49:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 49 is part of a Markdown fenced example describing plan states and suggested slash commands. It is not Ruby code or shell backtick execution."
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 55 documents slash-command suggestions such as save or sync. These are prose examples, not shell commands or executable backtick usage."
},
{
"id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 56 documents slash-command suggestions such as save or sync. These are prose examples, not shell commands or executable backtick usage."
},
{
"id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 57 documents slash-command suggestions such as save or sync. These are prose examples, not shell commands or executable backtick usage."
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 58 documents slash-command suggestions such as save or sync. These are prose examples, not shell commands or executable backtick usage."
},
{
"id": "external_commands:SKILL.md:59:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 59 documents slash-command suggestions such as save or sync. These are prose examples, not shell commands or executable backtick usage."
},
{
"id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "SKILL.md line 76 documents slash-command suggestions such as save or sync. These are prose examples, not shell commands or executable backtick usage."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 4,
"total_lines": 81,
"audit_model": "codex",
"audited_at": "2026-07-04T13:06:52.924Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Track Project Plans in AI Sessions",
"value_statement": "AI coding sessions can lose track of project plans when notes are stale or missing. This skill checks plan status and suggests the right save or sync action.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"project planning",
"AI project planner",
"docs/PLAN.md",
"plan sync",
"session status",
"stale plan detection",
"developer workflow"
],
"actual_capabilities": [
"Checks whether docs/PLAN.md exists or is missing.",
"Identifies stale plans using last modified time and recent git activity.",
"Suggests session actions for missing plans, stale plans, uncommitted work, and resumed sessions.",
"Keeps docs/PLAN.md as the stated source of truth for project status.",
"Uses lightweight heuristics and does not edit plan files directly."
],
"limitations": [
"It does not create, update, or archive plan files by itself.",
"It depends on docs/PLAN.md and available git context.",
"Its staleness checks are heuristic and may need human review.",
"Suggested slash commands must exist in the user environment."
],
"use_cases": [
{
"title": "Resume a coding session",
"description": "Review the current plan state before starting work and choose the next sync action.",
"target_user": "Solo developer"
},
{
"title": "Keep team planning notes current",
"description": "Spot when recent commits or uncommitted changes make the plan outdated.",
"target_user": "Engineering lead"
},
{
"title": "Guide AI-assisted project tracking",
"description": "Ask an assistant to check plan freshness and suggest clear follow-up actions.",
"target_user": "AI coding user"
}
],
"prompt_templates": [
{
"title": "Check the plan",
"scenario": "Beginner check for plan presence and freshness.",
"prompt": "Check whether this project has a current docs/PLAN.md and tell me what action to take next."
},
{
"title": "Resume work safely",
"scenario": "Start a new AI coding session with project context.",
"prompt": "Use project-planner to review docs/PLAN.md before I start coding. Tell me whether the plan needs a sync, status review, or save action."
},
{
"title": "Compare plan with git activity",
"scenario": "Review stale plan signals after recent development.",
"prompt": "Compare docs/PLAN.md with recent git activity and uncommitted work. Identify stale sections and recommend the most appropriate session action."
},
{
"title": "Audit planning workflow",
"scenario": "Advanced review of planning health across a project.",
"prompt": "Use project-planner to assess plan freshness, missing decisions, and progress gaps. Provide prioritized follow-up actions without editing files."
}
],
"output_examples": [
{
"input": "Check the project plan before we start.",
"output": "docs/PLAN.md exists, but recent commits appear newer than the plan. Recommended action: sync from git activity, then review the current progress section."
},
{
"input": "We just made progress and need to update planning notes.",
"output": "The plan may need a save action because the user mentioned progress. Capture the new decisions and update the in-progress items."
},
{
"input": "Is there a plan for this project?",
"output": "No docs/PLAN.md was found. Recommended action: create an initial plan from the current goals before continuing implementation work."
}
],
"best_practices": [
"Review plan status at the start of each AI coding session.",
"Save planning notes after major decisions, completed work, or changed goals.",
"Compare the plan with git activity before relying on older status notes."
],
"anti_patterns": [
"Expecting the skill to edit or archive plan files automatically.",
"Treating heuristic stale-plan signals as final project truth.",
"Ignoring missing docs/PLAN.md while continuing complex implementation work."
],
"faq": [
{
"question": "What does this skill monitor?",
"answer": "It monitors docs/PLAN.md and checks whether the project plan appears missing, stale, or ready for review."
},
{
"question": "Does it modify files?",
"answer": "No. The skill only suggests actions. Plan changes are handled by separate session commands or user actions."
},
{
"question": "How does it decide a plan is stale?",
"answer": "It uses heuristics such as plan age, recent git commits, uncommitted work, and user mentions of progress."
},
{
"question": "Can it work without git?",
"answer": "It can still check for docs/PLAN.md, but git-based freshness signals will be limited."
},
{
"question": "Which tools can use it?",
"answer": "The report lists support for Claude, Codex, and Claude Code."
},
{
"question": "Is it a project management system?",
"answer": "No. It is a lightweight planning assistant for keeping local project notes aligned with development activity."
}
]
},
"file_structure": [
{
"name": "assets",
"type": "dir",
"path": "assets",
"children": [
{
"name": ".gitkeep",
"type": "file",
"path": "assets/.gitkeep",
"lines": 0
}
]
},
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": ".gitkeep",
"type": "file",
"path": "references/.gitkeep",
"lines": 0
}
]
},
{
"name": "scripts",
"type": "dir",
"path": "scripts",
"children": [
{
"name": ".gitkeep",
"type": "file",
"path": "scripts/.gitkeep",
"lines": 0
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 78
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |