name	project-status
description	Quick "where are we? what's next?" dashboard with handoffs, sessions, imports, and git activity

Project Status

Overview

Get instant project status visibility: active handoffs, recent work, import queue, and git activity.

Use when: Starting a session, returning after time away, checking project state.

Announce at start: "I'm using the project-status skill to show current project status."

What This Skill Does

Aggregates status from multiple sources:

Active Handoffs - Work requiring attention (from /docs/handoffs/current/)
Recent Sessions - Last 5 work summaries (from /docs/sessions/)
Current TODOs - Action items (from /docs/status/TODO-*.md)
Import Queue - Files awaiting import (from /imports/)
Recent Activity - Last 10 git commits

Operation

Display Project Status

Process:

Collect Active Handoffs
```
find /Users/anthonybyrnes/PycharmProjects/Python419/docs/handoffs/current -name "*.md" -type f | sort -r
```
For each handoff:
- Extract filename
- Read YAML frontmatter to get creation date
- Calculate age (days since creation)
- Extract title from filename

List Recent Sessions

find /Users/anthonybyrnes/PycharmProjects/Python419/docs/sessions -name "SESSION-*.md" -type f | sort -r | head -5

Show last 5 session files

Check TODO Files

ls /Users/anthonybyrnes/PycharmProjects/Python419/docs/status/TODO-*.md 2>/dev/null

Read and display content of TODO files

Count Import Queue

# Inbox
find /Users/anthonybyrnes/PycharmProjects/Python419/imports/inbox -type f 2>/dev/null | wc -l

# Staged by type
for type in lbhra ps-lb lbsr08e 419f program-list cota-persistence; do
  find /Users/anthonybyrnes/PycharmProjects/Python419/imports/staged/$type -type f 2>/dev/null | wc -l
done

# Processing
find /Users/anthonybyrnes/PycharmProjects/Python419/imports/processing -type f 2>/dev/null | wc -l

Show Recent Git Activity

cd /Users/anthonybyrnes/PycharmProjects/Python419
git log --oneline -10

Display NEXT_STEPS if exists

cat /Users/anthonybyrnes/PycharmProjects/Python419/docs/status/NEXT_STEPS.md

Output Format

## Project Status - 2025-11-14

### Active Handoffs (2)
- import-coverage-completion
  Created: 2025-11-13 (1 day ago)
  File: docs/handoffs/current/2025-11-13-import-coverage-completion-handoff.md

- formula-correction-audit
  Created: 2025-11-13 (1 day ago)
  File: docs/handoffs/current/2025-11-13-formula-correction-audit-handoff.md

### Recent Sessions (last 5)
- SESSION-2025-11-13-import-coverage-matrix-handoff.md
- SESSION-2025-11-12-import-status-dashboard-mvp.md
- SESSION-2025-11-12-delta-cost-dashboard-mvp.md
- SESSION-2025-11-12-COMPLETE-SUMMARY.md
- SESSION-2025-11-12-autonomous-development.md

### Import Queue
Inbox: 0 files
Staged: 12 files
  - LBHRA: 5
  - PS_LB: 4
  - 419F: 3
Processing: 0 files

### Next Steps
[Content from /docs/status/NEXT_STEPS.md]

### Recent Activity (last 10 commits)
[git log --oneline -10]

Implementation Details

Date Calculation:

from datetime import datetime

def calculate_age(created_date_str: str) -> str:
    """Calculate age in days from YYYY-MM-DD string."""
    created = datetime.strptime(created_date_str, '%Y-%m-%d')
    today = datetime.now()
    delta = today - created
    days = delta.days

    if days == 0:
        return "today"
    elif days == 1:
        return "1 day ago"
    else:
        return f"{days} days ago"

Parse Handoff Filename:

import re

def parse_handoff_filename(filename: str) -> tuple:
    """Extract date and title from handoff filename."""
    # Pattern: YYYY-MM-DD-{title}-handoff.md
    match = re.match(r'(\d{4}-\d{2}-\d{2})-(.+)-handoff\.md', filename)
    if match:
        date_str = match.group(1)
        title = match.group(2).replace('-', ' ').title()
        return (date_str, title)
    return (None, filename)

Extract YAML Frontmatter:

import re

def extract_frontmatter(content: str) -> dict:
    """Extract YAML frontmatter from markdown file."""
    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
    if match:
        import yaml
        return yaml.safe_load(match.group(1))
    return {}

Usage Example

User: "What's the current project status?"

Assistant: "I'm using the project-status skill to show current project status."

[Runs all collection steps]

Output:

## Project Status - 2025-11-14

### Active Handoffs (2)
- Import Coverage Completion
  Created: 2025-11-13 (1 day ago)
  File: docs/handoffs/current/2025-11-13-import-coverage-completion-handoff.md

- Formula Correction Audit
  Created: 2025-11-13 (1 day ago)
  File: docs/handoffs/current/2025-11-13-formula-correction-audit-handoff.md

### Recent Sessions (last 5)
- SESSION-2025-11-13-import-coverage-matrix-handoff.md
- SESSION-2025-11-12-import-status-dashboard-mvp.md
- SESSION-2025-11-12-delta-cost-dashboard-mvp.md
- SESSION-2025-11-12-COMPLETE-SUMMARY.md
- SESSION-2025-11-12-autonomous-development.md

### Import Queue
Inbox: 0 files
Staged: 12 files
  - LBHRA: 5 files
  - PS_LB: 4 files
  - 419F: 3 files
Processing: 0 files

### Next Steps
[Displays content from NEXT_STEPS.md]

### Recent Activity (last 10 commits)
d5c98fc docs: add comprehensive quick start guide for web UI features
dd025d4 docs: add remaining web UI session summaries and implementation plans
5943b09 docs: add comprehensive session summary for Import Status Dashboard MVP
685f61c feat: complete Task 8 - Import Status Dashboard integration
da09d53 feat: add sortable ImportHistoryTable component
...

Integration

Used by:

Session startup workflow
Project handoff preparation
Status check during development

Depends on:

/docs/handoffs/current/ - Active handoffs
/docs/sessions/ - Session summaries
/docs/status/ - TODO and NEXT_STEPS files
/imports/ - Import workflow directories
Git repository - Recent commits

Common Mistakes

Reading deleted files:

Problem: Try to read files that have been archived
Fix: Only scan current/ directory, not resolved/ or archive/

Not handling empty directories:

Problem: Errors when directories are empty
Fix: Use 2>/dev/null to suppress errors, show "0 files" for empty

Stale git log:

Problem: Not running from correct directory
Fix: Always cd to project root before git log

Red Flags

Never:

Modify any files (read-only operation)
Run without announcing skill usage
Skip sections if data is missing (show "0" or "None")
Cache results (always run fresh)

Always:

Calculate ages dynamically (not from cache)
Show absolute file paths
Handle missing directories gracefully
Display all sections even if empty

project-status

Install Skill

SKILL.md