CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning-with-files

Implements Manus-style file-based planning to organize and track progress on complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when asked to plan out, break down, or organize a multi-step project, research task, or any work requiring >5 tool calls. Supports automatic session recovery after /clear.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/planning-with-files/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

A well-structured, actionable instruction-only skill with excellent progressive disclosure and a genuine error-recovery loop. Its main weakness is redundancy: the same rules are repeated across the table, rules, use-case list, and anti-patterns sections, plus a hype tagline that adds tokens without guidance.

Suggestions

Collapse the File Purposes table, Critical Rules, and Anti-Patterns table into a single section — they restate 'create the plan first, update it constantly, log errors, never repeat failures' three to four times.

Remove or replace the closing 'This pattern is why Manus went from launch to $2B acquisition in 8 months' line; it is unverifiable, time-sensitive marketing copy that earns no instructional value.

Add a short inline example of a minimal filled-in task_plan.md (3-5 lines) so the workflow is executable without opening references/.

DimensionReasoningScore

Conciseness

The file-purposes table, Critical Rules, 'When to Use' list, and Anti-Patterns table restate the same guidance three to four times, and the closing 'This pattern is why Manus went from launch to $2B acquisition in 8 months' line is time-sensitive hype rather than instruction. Mostly efficient but noticeably padded in these places.

3 / 5

Actionability

Concrete, executable instructions (create the three named files first, mark phases 'in_progress' → 'complete', log every error) backed by real template files in references/. Minor gaps: no minimal worked example of a filled-in plan inline, and the 'if action_failed: next_action != same_action' snippet is illustrative pseudocode rather than something runnable.

4 / 5

Workflow Clarity

A clear sequence is present (create plan first → update after each phase → 3-strike error protocol → escalate to user) and the 3-strike protocol is an explicit error-recovery feedback loop. Checkpoints in the main planning loop (e.g., verifying the plan covers all requirements before executing) are implicit rather than explicit, keeping this below a 5.

4 / 5

Progressive Disclosure

The body is a concise overview and every referenced file (task_plan.md, findings.md, progress.md, references.md, examples.md) exists, is one level deep, and is clearly signaled with paths in the Templates and Advanced Topics sections. Navigation is easy and content is appropriately split.

5 / 5

Total

16

/

20

Passed

Description

80%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.

A strong description that clearly and explicitly states both capabilities and trigger conditions in third person with concrete file names. Its one weakness is breadth: the '>5 tool calls' trigger makes it a candidate for almost any complex task, raising conflict risk with other skills.

DimensionReasoningScore

Specificity

'Implements Manus-style file-based planning to organize and track progress… Creates task_plan.md, findings.md, and progress.md… Supports automatic session recovery after /clear' lists several specific actions with named artifacts, but 'organize and track progress' is generic, leaving minor coverage gaps versus the comprehensive anchor 5.

4 / 5

Completeness

It explicitly answers both what ('file-based planning… Creates task_plan.md, findings.md, and progress.md') and when ('Use when asked to plan out, break down, or organize a multi-step project, research task, or any work requiring >5 tool calls') with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

'Use when asked to plan out, break down, or organize a multi-step project, research task' uses natural user phrasing with good coverage, but misses common synonyms such as 'task list', 'roadmap', or 'keep track of progress', placing it just below comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The trigger 'any work requiring >5 tool calls' is extremely broad and would fire for nearly any non-trivial task, creating real overlap risk with other productivity and planning skills; it fits anchor 3 ('somewhat specific but could still overlap') rather than anchor 4's 'minor overlap risk with closely related skills'.

3 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

saski/arnesto

Path

.agents/skills/planning-with-files/SKILL.md

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.