Agent skill · operations · aiskillstore
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.
Why this skill is useful
Adds specific detection logic and command suggestions for managing project plans that the AI wouldn't generate on its own.
What it needs
About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
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 Plan Stale Uncommitted Work Session Start 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
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/project-planner