progress-report
Write a short progress report of what an orchestrated or long session did since the last report (never overlapping): done, what worked, what didn't, concerns, decisions made for the user, manual steps. Use for "update doc", "what's been done", "write up progress".
KrishP147 · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add KrishP147/skills --skill progress-reportAbout this skill
name: progress-report description: Write a short progress report of what an orchestrated or long session did since the last report (never overlapping): done, what worked, what didn't, concerns, decisions made for the user, manual steps. Use for "update doc", "what's been done", "write up progress". argument-hint: "[reports folder] [docx] [full]"
A document the user reads in two minutes.
1. Range
- Folder: the one given, else
skilleddocs/reports/(untracked → excludeskilleddocs/per TRACKING.md). - Ledger:
skilleddocs/orchestrator/ledger.md(older runs:ledger.mdin the folder). None → reconstruct fromgit log, merged PRs, issues, and this conversation, and say so in the report. - Watermark:
.last-reportedin the folder, one line<NNN> <report filename> <entry NNN's header timestamp>(e.g.007 002-2026-10-16-x.md 2026-10-16 14:05 EDT): NNN = last ledger entry reported (no ledger → last reported commit SHA, no timestamp). The report number is that filename's number + 1. No file → report 001, covers everything. - Ledger restart (a new run numbers from 001 again): NNN > the latest entry, or entry NNN's timestamp differs from the stored one (no stored timestamp: the first check only) → cover the ledger from 001, keep the stored timestamp for the git scan below, and say "ledger restarted" in the Summary. A range still empty → write no report; say "nothing new since ".
No overlap: cover entries watermark+1 … latest (no ledger: commits after the SHA). Ledger present → also scan git log and merged PRs since the watermark's timestamp; work with no ledger entry goes in the report marked "not in ledger" (skip commits touching only the reports folder, .last-reported or the ledger). Something already reported that later changed (revert, reversed decision, broken "done") goes under Revisions, citing the earlier report. full → ignore the watermark; title it "Full report".
2. Sections (this order; an empty one says "none")
- Header:
Progress report NNN · <date> · covers <start> → <end> (<zone>, ledger NNN–MMM)+ repo/branch + previous report. No#before the number (reads as an issue ref). - Summary: 3–6 bullets.
- Done: table, Issue · Title · PR · Tests · CI.
- What worked / What didn't (each with what was done about it).
- Concerns: ranked, blockers marked.
- Decided for you:
Q → A · reason · where it landed, reversible. - Assumed decisions open:
A-nfrom ledgerassumptionentries / decision record, still unconfirmed. - Manual steps for you: numbered.
- Revisions to earlier reports.
- Next up: 2–4 bullets.
Bullets, one idea each, numbers in the table, 1–2 pages. Times in the user's local zone, taken from the ledger, git log --date=format-local, or API UTC timestamps via datetime.fromisoformat(s).astimezone(); zone: reuse the one named at the top of the ledger, else run python -c "import datetime as d; n=d.datetime.now().astimezone(); z=n.tzname(); print(z if ' ' not in z else n.strftime('UTC%z'))" (abbreviation on Unix, UTC offset on Windows). Never estimated or offset by hand.
3. Links
Resolve the repo URL once: gh repo view <o>/<r> --json url -q .url, <o>/<r> per the next skill's BOARD.md, Target repo section (on a fork, the repo the run wrote issues and PRs to; issues read from the parent, as when the fork has issues off, link to the parent: resolve its URL too and use it for rule 4). Link every reference in every section with one left-to-right pass over each paragraph and cell, one combined regex, alternatives tried in this order at each position:
- existing markdown link
[..](..),<url>or barehttps?://\S+→ copy unchanged - inline code span → copy unchanged
PR #n,PR#nor a listPRs #n, #m→ link each#nin it to<repo>/pull/n#n(not preceded by a letter, digit or&) → link "#n" to<repo>/issues/n- hex sha, 7–40 chars of
[0-9a-f]with at least one digit and one a–f letter, word-bounded and not inside a branch name or path (not touching/,-or_, and not joined to a word by a single.) → link "<first 7>" to<repo>/commit/<full> D<k>/A-<k>/ADR id, word-bounded → link to the decisions file (its heading anchor for that id, if it has one); no decisions file → leave as text
Never link: heading lines (#–###### then a space, incl. the report header), decimal-only tokens (CI run ids). Never re-scan output. Then check link count ≥ the #n mentions in the ledger range, counting only mentions outside code spans and URLs (rules 1–2 never link those).
4. Write
Commit mode on a protected <default> → first switch to the docs branch docs/report-<NNN> per TRACKING.md. NNN-YYYY-MM-DD-<slug>.md in the folder (local date; never overwrite). docx → same name .docx, via the docx skill or python-docx: heading styles, real bullets, a Done table, real hyperlinks. Read it back once to check nothing's empty.
5. Advance
Write .last-reported (<NNN> <filename> <timestamp>; no ledger → last reported SHA), append a ledger report entry with the range (no ledger → skip it and say so), and print the report path + range. Commit the report, .last-reported and ledger entry only in commit mode per TRACKING.md and only on <default> (defined there) or §4's docs branch; else leave them on disk.