Marketplace 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.

install

source · Clone the upstream repo

git clone https://github.com/aiskillstore/marketplace

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/aiskillstore/marketplace "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/0xdarkmatter/project-planner" ~/.claude/skills/aiskillstore-marketplace-project-planner && rm -rf "$T"

manifest: skills/0xdarkmatter/project-planner/SKILL.md

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

Situation	Suggestion
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
```