skills.rest
jmgirard
jmgirardCOMMUNITY
Explore all skills by this author →
Website𝕏@jeffreymgirardGitHub

milestone

Audits cairn project tracking files and routes the next milestone action.

4|Updated Jul 11, 2026
Search Tags:#markdown#milestone tracking#project status#github cli#workflow routing#health audit#git reconciliation
One-click install
npx skills add https://github.com/jmgirard/cairn --skill milestone-jmgirard
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: milestone
Source: https://github.com/jmgirard/cairn/tree/main/skills/milestone
Command: npx skills add https://github.com/jmgirard/cairn --skill milestone-jmgirard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When returning to a cairn-tracked repository, it is hard to know where the project stands, whether the tracking files have drifted from git reality, and what to work on next. This Skill produces a status snapshot, runs a health audit over the tracking files, and routes you to the correct next command. ## Core Features & Use Cases - Status Snapshot: Runs read-only Python scripts (cairn_status.py, cairn_validate.py, cairn_next.py, cairn_cost.py) over the cairn/ directory to report milestone counts, active work, and measured cost. - Health Audit: Fixes mechanical tracking inconsistencies, checks byte budgets, detects stale milestones, orphaned issues, untriaged GitHub inboxes, and merges made outside the cairn workflow. - Next-Action Routing: Recommends the single most sensible next command (resume, review, implement, or plan) with disposition chips for items needing user decisions. - Use Case: After two weeks away from a project, ask for a project status check to get a snapshot of active milestones, confirmation that tracking files match git history, and a routed next step such as resuming an in-progress milestone. ## Quick Start Ask the assistant to run a project status and health check on this cairn-tracked repository and tell you what to do next.

Frequently Asked Questions about milestone

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check project status in a cairn-tracked repository?▼

Invoke the milestone skill to get a status snapshot. It runs cairn_status.py over the cairn/ directory to report milestone counts by status, active milestones, the next planned milestone by priority, and the last hygiene check date.

How do I reconcile tracking files with git history?▼

The health audit compares commits since the last work-log entry against the tracking files and adds a one-line catch-up entry for anything unreflected. It also detects uncommitted changes under cairn/ and reports them as semantic orphans.

Does the milestone skill work without the GitHub CLI?▼

Yes, but with reduced coverage. When gh is missing, unauthenticated, or the repo has no remote, the audit names which condition occurred, skips the inbox and orphan-issue sweeps, and finishes the rest of the audit as a reported gap rather than a failure.

Can the milestone skill start implementation work automatically?▼

No. It is read-mostly by design: it fixes mechanical tracking problems immediately but never starts implementation. It routes to commands like /milestone-implement or /milestone-plan, and the user decides via the close block or triage chips.

What happens when the tracking health audit finds a failure?▼

Each FAIL from cairn_validate.py is treated as a mechanical problem and fixed with a docs-only commit, then the validation is re-run to confirm green. A scaffold-present failure is instead repaired by running /cairn-init in repair mode.

Related Skills

Explore More Software Engineering Skills→
platyplusplatyplus

evolve

Manage Cairn schema migrations with dry-run previews and confirmations.

Official
Advanced
diShine-digital-agencydiShine-digital-agency
1

shine-complete-milestone

Archive completed milestones into versioned ROADMAP and REQUIREMENTS files.

Community
Advanced
yusaduymazyusaduymaz

gsd-inbox

Triage GitHub issues and pull requests against repository templates and guidelines.

Community
Intermediate
NominexHQNominexHQ
15

pmm-status

Report PMM memory repository health with git logs, config data, and file stats.

Official
Intermediate