status-template

What problem does it solve?

Projects accumulate status across many places — chat threads, READMEs, ticket comments, and individual knowledge — making it hard for a newcomer or decision-maker to quickly understand current health, structure, and immediate needs. This Skill consolidates heartbeat (current state), anatomy (directory map), and checkup (health assessment) perspectives into a single, agent-friendly .status.md audit so the repository's condition is discoverable, actionable, and versionable.

Core Features & Use Cases

• Structured 10‑section template: Produces a comprehensive .status.md with Vision & Purpose, Current State with emoji statuses, annotated Directory Structure, Semantic Clusters, File Importance Ranking, Health Assessment, Active Workstreams, Blockers, Next Steps, and Aggregate Statistics; sections adapt by project size.
• Filesystem-aware auditing: Walks the repo to annotate directories, count LOC, and surface critical files and dependencies to inform the health and importance analyses.
• Onboarding, handoffs, and pre-decision audits: Use it to onboard new contributors, prepare a handoff document, summarize current progress before major decisions, or as the final phase of a repo-status workflow.

Quick Start

Ask the status-template skill to generate a .status.md for the repository at /path/to/repo by providing repo_path.