project-monitor

Logs project activity, decisions, issues, and risks into structured markdown files for KPI reporting.

Updated Aug 20, 2026
One-click install
npx skills add https://github.com/rhorba/RestoLedger --skill project-monitor-rhorba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-monitor
Source: https://github.com/rhorba/RestoLedger/tree/main/skills/project-monitor
Command: npx skills add https://github.com/rhorba/RestoLedger --skill project-monitor-rhorba

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams lose track of decisions, bugs, scope changes, and progress across sessions, making retrospectives, status reports, and session resumption unreliable. This Skill creates a persistent, append-only project memory in a .logs/ directory so nothing important is forgotten. ## Core Features & Use Cases - Structured Logging Protocol: Eight append-only markdown logs (activity, decisions, issues, risks, corrections, communications, sessions, metrics) with a standardized entry format and automatic trigger table defining who logs what and when. - KPI Tracking & Health Scoring: Defines ten KPIs (velocity, completion rate, bug rate, scope creep, estimation accuracy, etc.) plus a 0-100 health score computed from open issues, blockers, and risks. - Automated Status Reports: A Python report generator parses the logs and produces a formatted status report with progress, quality metrics, open items, and recent decisions. - Use Case: When resuming work after a break, the Skill reads the last SESSION_END entry and presents what was completed, what is in progress, and what is blocked, so the session continues without re-explaining context. ## Quick Start Ask the assistant to initialize project logging and show the current project status report from the .logs directory.

Frequently Asked Questions about project-monitor

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

FAQPage Schema
How do I track project decisions and activity across AI sessions?

Use an append-only markdown logging protocol where each event (task completion, decision, bug, scope change) is appended to a dedicated log file in a .logs directory. Session start and end entries let you resume work by reading only the last session summary.

How to generate a project status report from log files?

Run the included generate-report.py script, which parses the .logs directory and outputs a markdown report with a health score, progress summary, quality metrics, open issues, open risks, and recent decisions. It requires only the Python standard library.

What KPIs should a software project track per sprint?

Track velocity, completion rate, bug rate, bug fix rate, blocker duration, scope creep, estimation accuracy, security issue rate, rework rate, and decision speed. The Skill defines formulas and target thresholds for each of these ten KPIs.

Does the report generator need external Python packages?

No, generate-report.py uses only the Python standard library (os, re, sys, datetime, collections). It reads markdown log files with regex parsing and requires no pip installs or third-party dependencies.

When should events not be logged in project monitoring?

Skip trivial actions like typo fixes and formatting changes. Log only decisions, completions, issues, risks, and plan changes that would matter in a retrospective, and append entries after the action rather than before to save tokens.