CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning-with-files

Work like Manus: Use persistent markdown files as your "working memory on disk."

44

Quality

55%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/planning-with-files/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 teaches a coherent, actionable planning pattern with a strong error-recovery protocol, but it under-delivers on its own file structure: most referenced bundle files are missing, and key guidance (where files go) is repeated multiple times. Tightening the duplication and shipping the referenced templates would raise it substantially.

Suggestions

Ship the referenced bundle files (templates/task_plan.md, templates/findings.md, templates/progress.md, reference.md, examples.md) or remove/replace the links — 5 of 7 referenced paths currently do not exist, so the Templates and Advanced Topics sections are dead ends.

State the file-location rule once (the 'Where Files Go' table) and delete the repeats in the Quick Start note and the Anti-Patterns row; also trim the RAM/Disk metaphor and 5-Question Reboot Test to recover tokens.

Integrate scripts/check-complete.sh as an explicit end-of-phase validation checkpoint in the workflow steps rather than only listing it in a Scripts section.

DimensionReasoningScore

Conciseness

Mostly efficient tables and sections, but the file-location guidance is repeated three times ('Where Files Go', the Quick Start note, and the Anti-Patterns row), and the RAM/Disk metaphor and decorative '5-Question Reboot Test' could be trimmed. This is 'some unnecessary explanation or could be tightened' rather than the minor over-explanation of level 4.

3 / 5

Actionability

Concrete file names (task_plan.md, findings.md, progress.md), explicit update triggers, an error-table format, a decision matrix, and two executable scripts give mostly executable guidance. It is not 5 because the Quick Start's central steps direct readers to template files that do not exist in the bundle, so those steps cannot be followed exactly as written.

4 / 5

Workflow Clarity

A numbered Quick Start sequence, per-phase update checkpoints, and a real feedback loop (the 3-Strike protocol with diagnose/alternative/rethink/escalate) give a clear sequence with most checkpoints present. It is not 5 because check-complete.sh is merely listed in a Scripts section rather than integrated as an explicit validation step in the workflow.

4 / 5

Progressive Disclosure

The SKILL.md itself is well structured with clearly signaled one-level-deep references, but scored against the actual bundle, 5 of 7 referenced paths (templates/task_plan.md, templates/findings.md, templates/progress.md, reference.md, examples.md) do not exist, so navigation leads to dead ends. 'Minor organization gaps' at level 4 cannot cover a majority-broken reference set, so it lands at 3.

3 / 5

Total

14

/

20

Passed

Description

28%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 a memorable one-liner but fails as a functional skill description: it gives no concrete actions, no trigger terms a user would naturally say, and no guidance on when to use the skill. Adding an explicit 'Use when...' clause and naming the actual capabilities (create task_plan.md/findings.md/progress.md, track phases, log errors) would fix all four dimensions at once.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when starting multi-step tasks, research sessions, or projects spanning many tool calls' — completeness is currently capped by its total absence.

Replace the metaphor with concrete capability verbs: 'Create task_plan.md, findings.md, and progress.md files to track phases, log discoveries, and record session progress' instead of the generic 'Use persistent markdown files'.

Include natural trigger terms users would actually say — 'plan', 'track progress', 'complex task', 'multi-step project', 'context management' — rather than relying on the niche 'Manus' reference.

DimensionReasoningScore

Specificity

The description names its domain ('persistent markdown files', 'working memory on disk') but the only action is the generic 'Use', matching 'Names the domain but actions are minimal or generic'. It is not 3 because it lists no concrete actions such as creating task plans or tracking progress, and not 1 because it is not pure abstract language.

2 / 5

Completeness

It has a vague 'what' — a metaphor that depends on knowing what Manus is, with no concrete capability list — and no 'when' clause whatsoever, matching anchor 2. It is not 3 because the 'what' is not a clear action list; the missing 'Use when...' guidance alone would cap it at 3 even if the 'what' were strong.

2 / 5

Trigger Term Quality

Available keywords are 'Manus', 'markdown files', and 'working memory' — one or two generic or niche terms while the natural phrases users would actually say ('plan a complex task', 'track progress', 'multi-step project', 'context management') are absent. This matches 'One or two generic keywords; missing the natural phrases users say'.

2 / 5

Distinctiveness Conflict Risk

The 'working memory on disk' framing carves a niche, but 'markdown files' is generic enough to overlap with note-taking and general file-management skills, matching 'Somewhat specific but could still overlap with similar skills'. It is not 4 because no concrete triggers distinguish it from those neighbors.

3 / 5

Total

9

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 8 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/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.