skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
0xdarkmatter/claude-mods55 installs

project-planner

Detects stale project plans and suggests session commands. Triggers on: sync plan, update plan, check status, plan is stale, track progress, project planning.

How do I install this agent skill?

npx skills add https://github.com/0xdarkmatter/claude-mods --skill project-planner
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is safe. It provides helpful reminders to update a project plan based on file activity and git history without performing any dangerous operations.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1 file scanned · No issues

What does this agent skill do?

Project Planner Skill

Lightweight awareness layer for docs/PLAN.md. Detects when plans need attention and points to /save and /sync commands.

Purpose

This skill does NOT manage plans directly. It:

  • Detects when docs/PLAN.md exists or is missing
  • Identifies stale plans (no recent updates vs git activity)
  • Suggests appropriate session commands

All plan operations go through /save (persist) and /sync (restore/status).

Detection Logic

Plan Missing

No docs/PLAN.md found
-> Suggest: /save to create initial plan from conversation

Plan Stale

docs/PLAN.md last modified: 5 days ago
git log shows: 12 commits since then
-> Suggest: /sync --git to update from commits

Uncommitted Work

git status shows: 5 modified files
docs/PLAN.md "In Progress" section outdated
-> Suggest: /sync --status to review

Session Start

Resuming work on project with docs/PLAN.md
-> Suggest: /sync to restore state

Quick Reference

SituationSuggestion
No plan exists/save after discussing goals
Plan is stale/sync --git
Need to see plan/sync --status
Update progress/save "notes"
Start fresh/save --archive

Staleness Heuristics

A plan is considered stale when:

  • Last modified > 3 days ago AND
  • Git shows commits since last modification AND
  • Commits relate to plan topics (feat:, fix:, refactor:)

A plan needs review when:

  • Session just started
  • Significant uncommitted changes exist
  • User mentions progress or completion

Notes

  • This skill only suggests, never modifies
  • /sync reads state, /save writes state
  • Single source of truth: docs/PLAN.md

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/0xdarkmatter/claude-mods/project-planner">View project-planner on skillZs</a>