CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning-with-files

Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; Kiro skill instructions and steering state read selected project planning context. Recovery reads project planning files and their timestamps only, not agent transcript stores. This adapter registers no Stop hook, never requests continuation, and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls.

Quality

78%

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 ./.kiro/skills/planning-with-files/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 content is a strong, highly actionable skill body: fully executable commands with cross-platform variants, a clearly sequenced workflow with explicit validation gates and error-recovery loops, and clean one-level-deep progressive disclosure. The only notable weakness is redundancy — Critical Rules and the Anti-Patterns table restate each other, and core-pattern exposition duplicates delegated reference material.

DimensionReasoningScore

Conciseness

The body is mostly efficient (tables, terse rules, copy-paste commands), but the Critical Rules are substantially duplicated in the Anti-Patterns table ('Start executing immediately / Create plan file FIRST' restates Rule 1; 'Silent retries' restates Rules 5-6), and the 'Context Window = RAM' pattern section repeats concepts already delegated to references/manus-principles.md. This is 'mostly efficient but could be tightened' rather than anchor 4's 'minor instances of over-explanation'.

3 / 5

Actionability

Every procedural step ships a copy-paste-ready command with exact paths and both POSIX and PowerShell variants (e.g., 'sh .kiro/skills/planning-with-files/assets/scripts/bootstrap.sh', 'pwsh -File ...bootstrap.ps1', 'check-complete.sh --validate .kiro/plan/task_plan.md'), plus a concrete fallback when helpers cannot run ('copy the shipped template exactly and state that native validation is unavailable') and an explicit plan-format contract. Fully executable and covers the common cases.

5 / 5

Workflow Clarity

STEP 0 through STEP 3 form a clearly sequenced workflow with an explicit validation gate ('Validation must succeed before substantive work and after changing phase structure'), a full error-recovery feedback loop (the 3-Strike protocol ending in escalation to the user), and checklists (Read vs Write decision matrix, phase status markers). No destructive or batch operations are involved, so the validation cap does not apply.

5 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled one-level-deep references — all three referenced files (references/manus-principles.md, references/planning-rules.md, references/planning-templates.md) exist and do not chain to further reference documents, and every script under assets/scripts/ referenced by commands is present. Bulk detail (Manus principles, full rules, template skeletons) is appropriately split into separate files with an 'Advanced Topics' navigation section.

5 / 5

Total

18

/

20

Passed

Description

62%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 clearly states what the skill does and includes an explicit Use-when clause, with named planning files that make it fairly distinct. Its weaknesses are the heavy use of negative scope/meta statements in place of listed capabilities and a thin set of natural trigger terms, which leave both specificity and trigger coverage at the mid tier.

Suggestions

Replace some of the negative scope statements ('registers no Stop hook, never requests continuation...') with 2-3 additional concrete positive actions (e.g., 'creates phase checklists, logs errors, and validates plan completion') to lift specificity.

Expand the trigger clause with natural synonyms users would actually say, e.g., 'Use when the user asks to plan a multi-step task, track progress across sessions, do research, run a refactor, or any work needing 5+ tool calls.'

Consider mentioning plan validation or session recovery in the capability list, since those concrete behaviors already exist in the body (check-complete, session-catchup) and strengthen distinctiveness.

DimensionReasoningScore

Specificity

Names the domain ("Persistent file-based planning for multi-step AI-agent work") and 1-2 concrete actions ("Keeps task_plan.md, findings.md, and progress.md on disk"; "Recovery reads project planning files and their timestamps only"), but a large share of the description is negative scope statements ("registers no Stop hook, never requests continuation, and never runs commands declared in Markdown") rather than listed capabilities. It sits at the 'names domain and 1-2 concrete actions' anchor, below anchor 4 which expects several specific actions.

3 / 5

Completeness

Both what ("Persistent file-based planning... Keeps task_plan.md, findings.md, and progress.md on disk") and when ("Use for research or work needing 5+ tool calls") are explicitly present, satisfying the explicit-trigger requirement. However, the when-clause is narrow — it omits broader triggers like multi-step tasks, refactors, or context recovery that the body itself lists — so it falls at 'when could be more explicit or specific' rather than anchor 5's comprehensive concrete trigger phrases.

4 / 5

Trigger Term Quality

Relevant keywords like "planning", "multi-step", and "research" are present, but common natural variations users would say are missing (e.g., "track progress", "todo", "long-running task", "context recovery", "refactor"). This matches 'some relevant keywords but missing common variations or synonyms', below the 'good keyword coverage' anchor.

3 / 5

Distinctiveness Conflict Risk

Specific file names (task_plan.md, findings.md, progress.md) and the Kiro integration carve a mostly distinct niche with only minor overlap risk against generic planning or todo-list skills. It does not fully reach anchor 5 because 'planning for multi-step work' as a trigger still slightly overlaps the broad family of planning/tracking skills.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 5 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

OthmanAdi/planning-with-files

Path

.kiro/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.