CtrlK
BlogDocsLog inGet started
Tessl Logo

project-planner

Detects stale project plans and suggests session commands. Triggers on: sync plan, update plan, check status, plan is stale, track progress, project planning.

79

1.54x
Quality

69%

Does it follow best practices?

Impact

94%

1.54x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./data/skills-md/0xdarkmatter/claude-mods/project-planner/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
NeverSight/skills_feed
Reviewed

Table of Contents

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.