skills.rest
davepoon
davepoonCOMMUNITY
Explore all skills by this author →
Website𝕏@davepoonGitHub

project-milestone-tracker

Track project milestones and timestamped events in a local JSON file using Python stdlib.

3.4k|487|Updated Jul 25, 2025
Search Tags:#status report#stakeholder#milestone tracking#Json#event log#Project management#python CLI
One-click install
npx skills add https://github.com/davepoon/buildwithclaude --skill project-milestone-tracker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-milestone-tracker
Source: https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/project-milestone-tracker
Command: npx skills add https://github.com/davepoon/buildwithclaude --skill project-milestone-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

When working on projects inside a repo session, milestone dates and stakeholder promises get lost or invented. This Skill keeps a local, traceable record of milestones and events so nothing is fabricated and every claim has an original quote plus timestamp.

Core Features & Use Cases

  • Three-Tier Milestone Rule: Every milestone is tagged as file-sourced (contract/document), client-stated (verbal), or pending (must ask the client) so dates are never invented.
  • Verbatim Event Log: Record promises, decisions, and events with original text, who said it, and when, for traceable claims.
  • Status & Markdown Reports: Generate a project status view or a markdown progress report including pending-milestone risk warnings.
  • Use Case: While managing a renovation project in a repo session, log the contract's acceptance date as a file-sourced milestone, record the client's verbal payment promise as an event, and produce a markdown report flagging unconfirmed nodes.

Quick Start

Ask the agent to initialize a milestone tracker for your project and add milestones with their source tier, then request a status report.

Frequently Asked Questions about project-milestone-tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track project milestones locally without external services?▼

Run the bundled pm_track.py script with commands like init, add-milestone, and status. All state is stored in a local JSON file, and the script uses only Python 3.8+ stdlib modules with no network access or pip installs.

How to record stakeholder promises with timestamps in a project?▼

Use the add-event command with the original quoted text plus optional --who and --when flags. Events are stored verbatim with a recording timestamp so claims remain traceable to their source.

What is the three-tier milestone source rule?▼

Every milestone must be tagged file (from a contract or document), client (stated verbally by a stakeholder), or pending (no information yet). Pending milestones are flagged as needing client confirmation and dates are never self-invented.

Does the milestone tracker require installing Python packages?▼

No, the script uses only Python standard library modules: argparse, json, and datetime. It runs on any Python 3.8+ environment with a shell, and the JSON data file can be committed to the repo or git-ignored.

Can I generate a markdown project status report from the tracker?▼

Yes, run the report command to print a markdown progress report to stdout, including milestones, events, and a risk section listing pending milestones. Pipe the output to a file with > report.md to save it.

Related Skills

Explore More Product & Management Skills→
ShubhamsabooShubhamsaboo
131.7k

meeting-notes

Generate structured meeting minutes with attendees, agenda, decisions, and action items.

Community
Basic
robwestzrobwestz

status-report-generator

Generate project status reports from Git history and issue trackers.

Community
Intermediate
agentflockagentflock
8

calendar

Plan private calendar time blocks and reminders with user confirmation.

Official
Intermediate
JohannesKoningsJohannesKonings
9

wayfinder

Decompose high-level goals into linked issue-based tickets on a repository issue tracker.

Community
Advanced