Agent Skill
2/7/2026

review

Quick status review across all modules (read-only)

F
fpontejos
0GitHub Stars
1Views
npx skills add fpontejos/claude-helpers

SKILL.md

Namereview
DescriptionQuick status review across all modules (read-only)

name: review description: Quick status review across all modules (read-only)

Review

Quick status review across all work areas. Read-only - does not modify memory bank.

Usage

/review # Full review with all sections /review brief # One-line status per work area /review time # Focus on time tracking summary

Argument provided: "$ARGUMENTS"


Step 0: Parse Arguments

Parse $ARGUMENTS to determine mode:

  • Empty or full → Full review mode
  • brief → Brief mode (compact output)
  • time → Time tracking focus

Step 1: Read State (All Modes)

Read memory bank files:

  1. .claude/memorybank/session.md - Current focus, recent work, next steps
  2. .claude/memorybank/progress.md - Work history, decisions, blockers
  3. .claude/memorybank/overview.md - Work areas, project identity

Also read: 4. logs/log_index.yaml - Session timing information 5. Current log file (if session active) - Today's work entries

Important: Do NOT modify any files. This is a read-only operation.


Mode: Brief (/review brief)

Compact single-screen overview.

Output Format

## Status: [Project Name]

| Area | Status | Progress | Updated |
|------|--------|----------|---------|
| [area-1] | ● active | [████████░░] 80% | 2h ago |
| [area-2] | ◐ in-progress | [████░░░░░░] 40% | 1d ago |
| [area-3] | ○ not started | [░░░░░░░░░░] 0% | - |
| [area-4] | ✓ complete | [██████████] 100% | 3d ago |

**Focus**: [current focus from session.md]
**Session**: [active/inactive] | [duration if active]
**Blockers**: [count] ([brief list or "None"])

→ `/plan` to update plan | `/document` to record progress

Mode: Time (/review time)

Focus on time investment and session history.

Output Format

## Time Review: [Project Name]

### Current Session
- **Status**: [Active / Not active]
- **Started**: [timestamp or "No active session"]
- **Duration**: [Xh Ym] (ongoing)
- **Entries**: [N] logged items

### Project Totals
- **Total tracked time**: [Xh Ym]
- **Sessions**: [N] sessions
- **Average session**: [Xh Ym]

### Recent Sessions

| Date | Duration | Title/Summary |
|------|----------|---------------|
| [date] | [Xh Ym] | [title from frontmatter] |
| [date] | [Xh Ym] | [title] |
| [date] | [Xh Ym] | [title] |

### Time by Work Area (estimated)
Based on session content analysis:

| Area | Time | % of Total |
|------|------|------------|
| [area-1] | [Xh] | [██████░░░░] 60% |
| [area-2] | [Xh] | [████░░░░░░] 40% |

---
→ `/logwork start` to begin tracking | `/logwork end` to close session

Mode: Full (/review)

Comprehensive status review.

Process

  1. Read all memory bank files
  2. Extract work areas from overview.md
  3. Calculate progress for each area from progress.md
  4. Get current focus and blockers from session.md
  5. Get time tracking info from logs/
  6. Format and display

Output Format

## Session Review: [Project Name]

*Review generated: [timestamp]*
*Memory bank last updated: [session.md timestamp]*

---

### Quick Stats

| Metric | Value |
|--------|-------|
| Work areas | [N] total ([X] active, [Y] complete) |
| Current focus | [focus area] |
| Session status | [Active: Xh Ym / Not active] |
| Total project time | [Xh Ym] across [N] sessions |
| Blockers | [N] ([High/None]) |

---

### Work Areas Status

| Area | Status | Progress | Last Activity |
|------|--------|----------|---------------|
| [area-1] | ● active | [████████░░] 80% | [relative time] |
| [area-2] | ◐ paused | [████░░░░░░] 40% | [relative time] |
| [area-3] | ○ pending | [░░░░░░░░░░] 0% | Not started |
| [area-4] | ✓ complete | [██████████] 100% | [relative time] |

**Legend**: ● active | ◐ paused | ○ pending | ✓ complete | ⊘ blocked

---

### Current Focus

**Area**: [from session.md]

**Recent Work** ([date]):
- [item 1 from session.md]
- [item 2]
- [item 3]

**Next Steps** (from session.md):
- [ ] [next step 1]
- [ ] [next step 2]
- [ ] [next step 3]

---

### Blockers & Open Questions

| # | Blocker | Area | Severity | Since |
|---|---------|------|----------|-------|
| 1 | [description] | [area] | High | [date] |
| 2 | [description] | [area] | Medium | [date] |

*Or: "No active blockers"*

---

### Recent Decisions

From progress.md (last 5):

| Date | Decision | Rationale |
|------|----------|-----------|
| [date] | [decision] | [brief rationale] |

*Or: "No recent decisions recorded"*

---

### Session History (Last 5)

| Date | Duration | Focus | Key Accomplishments |
|------|----------|-------|---------------------|
| [date] | [Xh Ym] | [area] | [brief summary] |

---

### Suggested Actions

Based on current state:

| Condition | Suggestion |
|-----------|------------|
| No active session | → `/logwork start` to begin tracking |
| Blockers exist | → `/clarify [blocker]` to resolve |
| Stale session.md | → `/document` to update progress |
| Ready to work | → Continue with: [next step] |
| Need direction | → `/plan` to create/update plan |

Status Indicators

Work Area Status

SymbolStatusMeaning
activeCurrently being worked on
pausedStarted but temporarily stopped
pendingNot yet started
completeFinished
blockedCannot proceed

Progress Bars (10 characters)

[░░░░░░░░░░] 0%
[█░░░░░░░░░] 10%
[██░░░░░░░░] 20%
[███░░░░░░░] 30%
[████░░░░░░] 40%
[█████░░░░░] 50%
[██████░░░░] 60%
[███████░░░] 70%
[████████░░] 80%
[█████████░] 90%
[██████████] 100%

Calculating Progress

Progress percentage is estimated from progress.md content:

  • Count completed items for each work area
  • Compare to total expected items (from plan or overview.md)
  • If no explicit tracking, estimate from milestone descriptions

Staleness Detection

Check how current the memory bank is:

StalenessConditionIndicator
FreshUpdated within 1 hour✓ Current
RecentUpdated within 4 hoursUpdated [X]h ago
StaleUpdated more than 4 hours ago⚠ Updated [X]h ago
Very staleUpdated more than 24 hours ago⚠ Updated [X]d ago - consider /document

Display staleness in header:

*Memory bank last updated: 2h ago (Recent)*

Information Sources

InformationSourceFallback
Project nameoverview.md "Project Identity"Directory name
Work areasoverview.md "Work Areas" table"No work areas defined"
Current focussession.md "Focus Area""Not specified"
Recent worksession.md "Recent Work""No recent work recorded"
Next stepssession.md "Next Steps""No next steps defined"
Blockerssession.md "Blockers" + progress.md"None"
Decisionsprogress.md "Decisions" sections"No decisions recorded"
Time trackinglogs/log_index.yaml"No time tracking data"

Error Handling

Missing Memory Bank

If .claude/memorybank/ doesn't exist:

## Review Error

Memory bank not found at `.claude/memorybank/`.

Run `/onboard-claude` to initialize the memory bank for this project.

Partial Memory Bank

If some files are missing, show what's available:

## Partial Review

⚠ Some memory bank files are missing:
- [x] overview.md - Found
- [ ] progress.md - Missing
- [x] session.md - Found

Showing available information...

No Log Data

If logs/log_index.yaml doesn't exist or is empty:

### Time Tracking
No time tracking data available. Run `/logwork start` to begin tracking.

Examples

Example 1: Full Review

User: /review

Claude:
1. Reads all memory bank files
2. Finds: 3 work areas, 1 active, session running for 2h
3. Calculates progress percentages
4. Identifies 1 blocker
5. Shows full formatted review
6. Suggests: "Continue with [current task]"

Example 2: Brief Check

User: /review brief

Claude:
1. Reads memory bank files
2. Outputs compact table
3. Shows one-line focus and blocker count
4. Suggests next action

Example 3: Time Focus

User: /review time

Claude:
1. Reads log_index.yaml and recent log files
2. Calculates session statistics
3. Shows time breakdown by area
4. Shows recent session history

Skill Chaining

After review, suggest appropriate next action:

StateSuggestion
No active session/logwork start
Blockers present/clarify [blocker]
Memory bank stale (>4h)/document
No plan or outdated plan/plan
Ready to continue"Continue with: [next step from session.md]"

Checklist

  • Parsed arguments to determine mode
  • Read all available memory bank files
  • Handled missing files gracefully
  • Calculated progress for each work area
  • Retrieved time tracking information
  • Detected memory bank staleness
  • Used consistent status indicators
  • Formatted output for selected mode
  • Suggested appropriate next action
  • Did NOT modify any files (read-only)
Skills Info
Original Name:reviewAuthor:fpontejos