weekly-review

Use when someone wants to run a weekly review, close open loops, audit stalled projects and commitments, get their system back to trusted, restart a lapsed review habit, or says "/cs:weekly-review". Walks David Allen's three-phase loop — GET CLEAR, GET CURRENT, GET CREATIVE — with deterministic scripts that inventory open loops, gate the checklist with named gaps, and score commitment health 0-100.

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, executable ritual skill: copy-paste commands per phase, an honest gating validation step, and cleanly split references/assets one level deep. Only minor motivational prose in the intro keeps conciseness from a perfect score.

Suggestions

Trim the motivational framing in 'What this does' (e.g. 'David Allen calls the weekly review the critical success factor of the whole method') to keep the opening purely action-oriented and lift conciseness to 5.

Dimension	Reasoning	Score
Conciseness	Largely lean and action-oriented with minimal padding, but the 'What this does' opener includes light motivational framing ('David Allen calls the weekly review the critical success factor…') that could be trimmed without losing actionability.	4 / 5
Actionability	Provides copy-paste-ready commands with real flags per phase — e.g. 'python scripts/open_loop_scanner.py --dir ~/notes --stale-days 14' and 'python scripts/weekly_review_gate.py --done "1,2,3,4,5,6,7,8" --skip "9:no someday list yet"' — fully executable and covering common cases.	5 / 5
Workflow Clarity	Clear three-phase sequence with numbered steps and an explicit validation checkpoint: the gate issues COMPLETE (exit 0) / INCOMPLETE (exit 2), names every missing step, and 'always forces INCOMPLETE' on unskipped mandatory steps — a real feedback loop for error recovery.	5 / 5
Progressive Disclosure	SKILL.md is a concise overview with well-signaled one-level-deep navigation: a scripts role table, three references (each described with source counts), two assets, and a distinct-from section — all referenced files verified present on disk.	5 / 5
	Total	19 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is exemplary: concrete actions, comprehensive natural trigger terms, explicit what-and-when guidance, and a clearly delineated niche. It is concise, third-person, and avoids vague fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'inventory open loops', 'gate the checklist with named gaps', and 'score commitment health 0-100' — with comprehensive coverage across the three-phase loop, matching the anchor for multiple specific concrete actions.	5 / 5
Completeness	Explicitly answers both: 'what' ('Walks David Allen's three-phase loop… with deterministic scripts…') and 'when' ('Use when someone wants to run a weekly review, close open loops…'), with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural terms users would actually say — 'run a weekly review', 'close open loops', 'audit stalled projects and commitments', 'restart a lapsed review habit', plus the explicit '/cs:weekly-review' invocation — covering synonyms and a direct command phrase.	5 / 5
Distinctiveness Conflict Risk	Occupies a clear GTD weekly-review niche with distinct triggers (open loops, commitment health 0-100, three-phase loop) and a literal command trigger, minimizing conflict with adjacent productivity or project-management skills.	5 / 5
	Total	20 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: alirezarezvani/claude-skills
Path: productivity/weekly-review/skills/weekly-review/SKILL.md
Commit: 19392f7

Reviewed: ~1 hour ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.