chore(skills): Update linear-project-status skill with more details & context#21234
Merged
Conversation
… a people review Sharpens the linear-project-status skill so it's clearly a tool for project leads auditing their own projects, not a performance review of any individual. Key changes: - Add an "Audience and intent" section: the audience is the project lead, the verdict is a signal (not a grade), and the audit can't see PTO / competing priorities / work outside Linear — recommendations should target the project's process, not the people. - Lead engagement (dim 2b) reframed around whether the lead is finding time to engage with the project. Explicitly recognizes two healthy shapes: implementer (assigned to issues) and orchestrator (drives via updates / comments / milestones). A `warn` is not a critique. - Target date stability (dim 4) now weighs both push count and quality of explanation. Well-documented pushes (illness, scope change, dependency slip) earn `warn`; vague or undocumented pushes earn `bad`. - Target date presence/realism (dim 3) adds a special-case block for "target date is today or past, project not Completed" — common enough to deserve explicit handling. - Milestone health (dim 6) adds a distinct "tracking-hygiene gap" verdict for past-due milestones where the work clearly shipped but wasn't marked complete — the fix is cleanup, not a delivery concern. - Status update cadence (dim 1) now reads trajectory across the last ~6 weeks. A long silence followed by a fresh update is `warn` with positive framing (recognize the correction). Steady recent rhythm is `ok` even if there was an old gap further back. - Scope stability (dim 7) carves out planned decomposition: new issues sharing a common `parentId` are a structural breakdown of existing scope, not drift — never flag them. - Common failure modes: "Reviewing people instead of the project" added as the top entry. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
chargome
approved these changes
May 29, 2026
s1gr1d
approved these changes
May 29, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sharpens the
linear-project-statusskill so it's clearly a tool for project leads auditing their own projects, not a performance review of any individual. The verdict (Green/Yellow/Red) becomes a signal for the lead to interpret with context the audit can't see (PTO, competing priorities, work outside Linear) — not a grade.Key changes
warnis explicitly not a critique.warn; vague or undocumented pushes →bad. Avoids over-penalising a lead who's transparent about slippage.warnframed positively (the lead has already corrected course). Steady recent rhythm →okeven if there was an old gap further back. Don't dwell on distant history.parentId, that's a structural breakdown of existing scope (healthy), not drift — never flag it.Validation
Iterated against two real Sentry projects (Hono SDK and Multi-Runtime Server Integrations) — each pass surfaced specific phrasings or rules that needed adjustment, which are now folded in.
🤖 Generated with Claude Code