project-health-check
Project Health Check
Run the scheduled health checks for this project, in order. Each check is independent — if one can't complete (a tool is missing, a command fails, access is denied), report what went wrong and continue to the next check. Never let one failed check abort the rest. Post a short summary at the end covering every check.
Inputs
These are provided when the skill is invoked — don't hardcode them:
- Linear team (required for Check 3) — the name or key of the team whose backlog to triage (e.g. a team key like
PXL). If it wasn't provided and can't be inferred unambiguously from the project, ask once. - Ticket date cutoff (optional) — ignore tickets created before this date. If not provided, apply no cutoff.
Check 1 — Sync main branch with remote
In the main worktree (not any feature worktree), bring the local main branch in sync with origin/main via a fast-forward only. Do this regardless of which branch the worktree is currently on or whether it's dirty — a worktree sitting on a feature branch with uncommitted changes is the normal case, not a reason to skip. The mechanism for not disturbing in-progress work is to stash it, sync, and put everything back exactly as it was — not to bail out. A worktree that ends on the same branch it started on, with the same changes restored, has not been disturbed.
The shape of the work, which is safe and reversible throughout: