Detects stale project plans and suggests session commands. Triggers on: sync plan, update plan, check status, plan is stale, track progress, project planning.
79
69%
Does it follow best practices?
Impact
94%
1.54xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./data/skills-md/0xdarkmatter/claude-mods/project-planner/SKILL.mdQuality
Discovery
82%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 functional with a clear 'what' and explicit 'when' triggers, which is its strongest aspect. The trigger terms are natural and well-chosen. However, the description could be more specific about what 'suggests session commands' means and what concrete actions the skill performs, and some trigger terms like 'project planning' risk overlap with other skills.
Suggestions
Clarify what 'suggests session commands' means concretely — e.g., 'suggests commands to re-sync tasks, update milestones, or refresh timelines'.
Narrow the generic trigger 'project planning' to something more distinctive to reduce conflict risk with general project management skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (project plans) and two actions (detects stale plans, suggests session commands), but lacks detail on what 'suggests session commands' means concretely or what specific operations are performed. | 2 / 3 |
Completeness | Clearly answers both 'what' (detects stale project plans and suggests session commands) and 'when' (explicit 'Triggers on:' clause with multiple trigger phrases), satisfying the requirement for explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes a good set of natural trigger terms: 'sync plan', 'update plan', 'check status', 'plan is stale', 'track progress', 'project planning' — these are phrases users would naturally say when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Terms like 'project planning' and 'track progress' are somewhat generic and could overlap with general project management or task tracking skills. However, the specific focus on 'stale plans' and 'session commands' provides some distinctiveness. | 2 / 3 |
Total | 10 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a well-structured awareness/detection layer with clear situation-to-action mappings. Its main weakness is that the detection logic describes what to detect without providing the actual executable commands (git log, stat, etc.) needed to implement the detection, making it more descriptive than actionable. Some minor redundancy between sections could be tightened.
Suggestions
Add executable commands for the detection logic — e.g., `stat -c %Y docs/PLAN.md` and `git log --since='3 days ago' --oneline` — so Claude knows exactly how to check staleness rather than just what staleness means.
Remove the redundant 'Purpose' bullet points that restate the opening sentence, and consolidate the 'Notes' section into the purpose or remove it entirely since it repeats information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but has some redundancy — the 'Purpose' section restates what the intro already says, and the 'Notes' section repeats the read/write distinction already covered. The 'This skill does NOT manage plans directly' framing is slightly verbose. | 2 / 3 |
Actionability | Provides concrete command suggestions in a clear table format, but the detection logic sections use pseudocode-like notation rather than executable code or actual implementation. Claude doesn't get instructions on HOW to detect staleness (e.g., actual git commands to check modification dates), just descriptions of what to detect. | 2 / 3 |
Workflow Clarity | The detection scenarios are clearly enumerated and the quick reference table provides a good mapping of situations to actions. However, there's no sequenced workflow for how to actually perform the detection checks, and no validation/feedback loops for confirming whether suggestions were acted upon. | 2 / 3 |
Progressive Disclosure | For a skill under 50 lines with a single focused purpose, the content is well-organized with clear sections (Purpose, Detection Logic, Quick Reference, Staleness Heuristics, Notes). No unnecessary external references or deeply nested content. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
f772de4
Table of Contents
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.