Skills

Project Status

Draft a Linear project status update from what actually moved, progress, risks, and...

Install

npx skills add ParadevAI/Paradev --skill project-status -g -a claude-code -y
Repository
ParadevAI/Paradev15.8k
Category
Engineering
Updated
3d ago
License
See repository
Context cost
Lightabout 736 tokens
Runs scripts
No, instructions only

What it does

Draft a Linear project status update from what actually moved, progress, risks, and the one decision that needs making. Use when someone asks for a project update, a status post, where a project stands, whether it will land on time, or what to tell stakeholders.

Draft a project status update

A status update is read by people who will not open a single issue. It has to survive being the only thing they read: is this landing, what changed, and what do you need from them.

1. Read the movement, not the snapshot

Percent-complete is the number people reach for and the one that lies. A project can sit at 70% for a month while the last three issues get harder. What tells the story is what moved since the previous update: issues completed, issues added, and target dates that shifted.

Fetch the project's issues plus its previous status update. Without the previous one you are writing a summary, not an update, and the reader cannot tell what is new.

2. Judge the trajectory honestly

Pick one and commit to it. Hedging every sentence is how a project stays green until the week it ships late.

CallWhat justifies it
On trackRemaining scope fits the remaining time at the current rate
At riskA dependency, an unknown, or a rate that has to improve to land
Off trackThe date will move, or scope has to be cut, say which

If you cannot tell, the answer is at risk, and the reason is that nobody can tell.

3. Name risks as things that could happen

"Backend integration is risky" gives the reader nothing. "The export endpoint is not built, we cannot finish import until it is, and the owner is on the payments migration until the 14th" tells them what to move. A risk is a specific event with a specific consequence and usually a specific person who can prevent it.

Include scope that was added mid-project. Silently absorbed scope is why the date moves, and it is invisible unless the update names it.

4. Ask for what you need

Most updates end with nothing to do, so nothing is done. If a decision, a person, or a descope would help, state it as the last line with a name and a date attached. One ask is better than three, because three get triaged and one gets answered.

Read the whole SKILL.md on GitHub

More in Engineering