claude-skills: The Project Manager Hidden Inside Claude Code

It scans the repo, weighs blockers, and splits work into what Claude can finish versus what only a human can unlock.

12 min read • View on GitHub • More from durang

A control-room desk faces a wall of status panels, with a markdown dashboard centered like a mission board and task cards spread across the surface. Some cards look ready for machine execution, while others sit behind a human checkpoint. The scene explains that this skill acts like a project manager for the repo, not just a passive status checker.
Claude Code becomes the operator, but the dashboard stays in the repo.
Key Takeaways

The repo is not the product. The decision engine is.

This is not a tracker in the usual sense. track turns Claude Code into a coordinator that inspects the repo, decides which tasks are worth touching, and leaves behind a dashboard that survives the session. The surprise is not the markdown file. It is the policy engine behind it.

Under the hood, the repo is tiny. SKILL.md carries the behavior, install.sh places it where Claude can load it, and the dashboard file holds the live state. That is enough to make the skill feel less like a utility and more like an operating layer.

The contract: what Claude can do, and what it cannot

Most agent tools blur ownership. track does the opposite. It makes the boundary explicit with ← auto and ← user.

A close-up split scene shows two narrow rails carrying task cards through different lanes. One lane moves smoothly through gears and tools, while the other stops at a locked gate where a human hand takes over. The image explains how the skill separates work Claude can finish from work that requires a person.
The contract is simple: Claude stays in the lane it can actually complete.

That distinction is the whole contract. Claude should spend its context on file edits, scans, and docs. It should hand back anything that needs credentials, external access, approvals, or a human judgment call.

How the scan decides: full, incremental, skip, or kickstart

The scan is a state machine disguised as a skill. It checks whether the repo is empty, whether the last sync is stale, and whether the commit hash has changed. From there it chooses FULL, INCREMENTAL, SKIP, or kickstart.

A simple state machine keeps the agent from re-reading the whole repo every time.

That matters because context is not free. A full repo pass is expensive. An incremental pass is cheaper. A skip is a gift when nothing changed.

It also keeps the dashboard honest. Launch readiness is not a vibe. Blockers count more than easy wins, so the file does not pretend that cosmetic progress equals shipping.

Why the dashboard matters more than the command

The dashboard is the real interface. The command starts the work, but the file is what makes the work legible later. Progress bars, build health, security posture, and change logs turn the repo into a persistent operations board.

That persistence changes the unit of value. Claude does not just answer a prompt. It updates a shared artifact that another run, or another person, can read without reconstructing the whole story.

The repo becomes a memory surface. Every run can compare itself against the last sync timestamp, the last commit hash, and the current state of the launch checklist. That is how a skill stops being a helper and starts behaving like a coordinator.

What it replaces

Compared with raw Claude Code, track moves state out of the operator's head and into the repo. Compared with manual status docs, it refreshes itself from actual repository signals. Compared with broad extension bundles like claude-forge, it is narrower and more opinionated: one workflow, one contract, one dashboard.

ApproachWhere state livesWhat breaksWhat track adds
Raw Claude CodeIn the operator's headContext resets between sessionsA repo-level dashboard and decision logic
Manual status docsMarkdown files and memoryThey drift as soon as someone forgets an updateAutomatic regeneration from repo signals
Broad extension bundlesDistributed across agents, hooks, and commandsPower without a single readiness surfaceA focused skill that centralizes launch state
trackInside <code>SKILL.md</code> plus the dashboardHuman approval still needed for locked-down workExplicit ownership, weighted progress, and scan modes

What to steal from it

The real lesson is simple. Teach the agent to refuse work it cannot finish. Preserve context in the repo, not in the session. Make the handoff visible, because visible handoffs are easier to trust.

That is the strongest version of AI-assisted development right now. Not magic. Governance. A skill can be small and still reshape the way a team sees progress, blockers, and ownership.