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; agent instructions read selected project planning context when invoked. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. This adapter registers no lifecycle or 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

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

70%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 delivers a coherent, heavily validated planning workflow with executable commands, strong error-recovery loops, and thoughtful safety gating on destructive actions. Its weaknesses are repetition across rule sections, inlined detail that belongs in separate files, and a set of prominently referenced template/reference documents that are missing from the bundle.

Suggestions

Ship the referenced files (templates/task_plan.md, templates/findings.md, templates/progress.md, reference.md, examples.md, plan-inventory.md) in the bundle or remove/inline the links — the Quick Start's first three steps currently point at files that don't exist.

Move the per-script documentation and the Security Boundary detail into a separate reference file, keeping SKILL.md as a lean overview.

Deduplicate the repeated 're-read plan before decisions' guidance (Quick Start, Critical Rule 3, decision matrix, Anti-Patterns) into a single stated rule.

DimensionReasoningScore

Conciseness

The body is mostly efficient, actionable guidance with no basic-concept exposition, but it repeats the same rules across sections — "Re-read plan before decisions" appears in Quick Start step 4, Critical Rule 3, the Read vs Write matrix, and the Anti-Patterns table — and the Security Boundary section restates the frontmatter's defensive disclaimers at length. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim level at 4.

3 / 5

Actionability

Most guidance is copy-paste executable: the session-catchup command with python3/python fallback, `sh "$PWF_SKILL_DIR/scripts/init-session.sh"`, `check-complete.sh --validate`, `set-active-plan.sh --list`, attest-plan usage, and concrete two-terminal PLAN_ID examples with PowerShell equivalents. It stops short of 5 because the primary Quick Start steps depend on template files absent from the bundle, and some rules are abstract pseudocode ("if action_failed: next_action != same_action", "Mutate the approach").

4 / 5

Workflow Clarity

The workflow is clearly sequenced with explicit validation and feedback loops: restore state first (with git diff check), initialize via script, "Validation must succeed before substantive work and after changing phase structure", phase status transitions, the 3-Strike error protocol with escalation, and the 5-Question Reboot checklist. Even the mildly destructive archive operation is gated by user approval ("Never archive on age or completion alone", --archive previews before --yes applies), matching the top anchor.

5 / 5

Progressive Disclosure

References are clearly signaled and one level deep (Templates section, "See [reference.md](reference.md)", "See [examples.md](examples.md)", plan-inventory.md), but scored against the actual bundle, six referenced files do not exist — templates/task_plan.md, templates/findings.md, templates/progress.md, reference.md, examples.md, and plan-inventory.md — so the Quick Start's primary path dead-ends. Script docs, security detail, and the parallel-workflow walkthrough are also inlined in an already-long SKILL.md rather than split out, fitting 'could be better organized' rather than the minor-gap level at 4.

3 / 5

Total

15

/

20

Passed

Description

67%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 answers both 'what' and 'when' with several concrete, distinctive capabilities anchored on named planning files, and correctly uses third-person voice. However, it is weighed down by security-disclaimer negations that crowd out natural trigger phrases, leaving keyword coverage thin relative to its length.

Suggestions

Replace most of the defensive negations ("registers no lifecycle or Stop hook", "never runs commands declared in Markdown", "no network upload path") with a one-line privacy note, freeing space for capability and trigger language.

Expand the 'Use for' clause with concrete trigger phrases users would actually say, e.g. "Use for multi-step tasks, research, project builds, resuming interrupted work, or any task spanning many tool calls."

Add common synonyms such as "task tracking", "staying organized", and "long-running tasks" so the skill triggers on natural user phrasing beyond "research".

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Keeps task_plan.md, findings.md, and progress.md on disk", "read selected project planning context", "reads same-project local agent session records and emits aggregate counts only", "--replay may emit bounded nonce-framed excerpts" — matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because roughly half the text is defensive negation ("registers no lifecycle or Stop hook", "never runs commands declared in Markdown", "no network upload path") rather than capability coverage, and the core planning workflow actions (create plans, track phases, validate) are underrepresented.

4 / 5

Completeness

Both parts are explicit: 'what' is "Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk..." and 'when' is "Use for research or work needing 5+ tool calls", so the missing-trigger cap of 3 does not apply. It does not reach 5 because the 'when' clause is a single terse trigger covering fewer concrete phrases than the anchor-5 example, omitting triggers the body itself supports (multi-step builds, resuming work across sessions, project organization).

4 / 5

Trigger Term Quality

Natural terms present are limited to "planning", "multi-step", "research", and the file names task_plan.md/findings.md/progress.md, while common user phrasings like "task tracking", "todo", "staying organized", "long-running task", or "resuming interrupted work" are absent. The bulk of the text is implementation jargon ("session-catchup.py --metadata", "nonce-framed excerpts", "Stop hook", "adapter"), matching the 'some relevant keywords but missing common variations or synonyms' anchor rather than the good-coverage anchor at 4.

3 / 5

Distinctiveness Conflict Risk

The specific file trio (task_plan.md, findings.md, progress.md) and the session-catchup mechanism carve out a mostly distinct niche with only minor overlap risk against generic planning/todo skills. Not 5 because "planning for multi-step AI-agent work" and the broad trigger "work needing 5+ tool calls" still overlap the space of general task-management and planning skills.

4 / 5

Total

15

/

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

relative_links

Relative link issues: 9 missing

Warning

Total

15

/

16

Passed

Repository

OthmanAdi/planning-with-files

Path

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