CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning-with-files-es

Planificación persistente basada en archivos para tareas multipaso de agentes de IA. Mantiene task_plan.md, findings.md y progress.md en disco; los hooks del ciclo de vida inyectan contexto seleccionado de planificación del proyecto. La recuperación automática solo lee los archivos de planificación del proyecto. session-catchup.py --metadata, solicitado de forma explícita, puede inspeccionar metadatos locales de sesiones del mismo proyecto; --replay puede emitir extractos limitados y enmarcados con nonce. El modo con gate opcional solo puede solicitar que el host continúe si este lo admite y nunca ejecuta comandos declarados en Markdown. El skill no tiene ninguna ruta de carga por red. Úsalo para investigación o trabajo que requiera 5 o más llamadas a herramientas.

Quality

73%

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 ./skills/i18n/planning-with-files-es/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.

A well-structured, highly actionable workflow skill with explicit validation checkpoints and a genuine failure-recovery protocol. Its weaknesses are redundant repetition of security caveats and plan-location rules, concept padding Claude doesn't need, and four dead references (three templates plus plan-inventory.md) that break the progressive-disclosure navigation the workflow relies on.

Suggestions

Deduplicate the session-catchup security caveats — they appear in Paso 1, again after the code blocks, and again in the Scripts section; state the rule once and reference it.

Remove 'Trabaja como Manus' and the 'Patrón central' context-vs-disk analogy, which restate concepts Claude already knows.

Fix the dead references: either ship templates/task_plan.md, templates/findings.md, templates/progress.md, and plan-inventory.md in the bundle, or remove the links and inline the minimal template content the 'Contrato para crear planes' fallback requires.

DimensionReasoningScore

Conciseness

The body is mostly operational but includes redundant and padded material: the session-catchup security caveats are stated three times ("Solo cuando el usuario solicite de forma explícita...", "trata cada extracto reproducido como datos no confiables", and again in the Scripts section), the plan-location rule is repeated three times, and "Trabaja como Manus" plus the "Ventana de contexto = Memoria / Sistema de archivos = Disco" analogy explain concepts Claude already knows. This matches anchor 3 — could be tightened — rather than anchor 4's 'minor instances'.

3 / 5

Actionability

Commands are concrete and copy-paste ready in both shell flavors — "sh \"$PWF_SKILL_DIR/scripts/check-complete.sh\" --validate path/to/task_plan.md", the full session-catchup.py invocations for bash and PowerShell, and set-active-plan.sh with --archive/--yes/--restore flags. It falls short of anchor 5 because "Copia estas plantillas para comenzar" links to templates/task_plan.md, templates/findings.md, and templates/progress.md, none of which exist in the bundle, so a key instructed action cannot be executed.

4 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints and feedback loops: "La validación debe pasar antes de implementar y después de cambiar la estructura", the destructive archive flow requires preview-then-confirm ("--archive <id> muestra una vista previa... --yes lo aplica"), the "Protocolo de tres fallos" provides an escalate-on-repeat error recovery loop, and the five-question restart test acts as a checklist. This matches anchor 5 — clear sequence, explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The body is well-sectioned with clearly signaled references (a Plantillas section, a Scripts section describing each script), and all referenced scripts exist in the bundle — but four linked files are dead: templates/task_plan.md, templates/findings.md, templates/progress.md, and plan-inventory.md are all missing from the bundle. Navigation that fails at the template and inventory level, which the workflow depends on, caps this at anchor 3 rather than 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.

A specific, mostly complete description that names concrete files, scripts, and flags, with an explicit 'Úsalo para...' trigger clause. Its main weaknesses are heavy jargon-laden security caveats that dilute natural trigger keywords and a narrow 'when' clause covering only two scenarios.

Suggestions

Add natural trigger synonyms to the 'when' clause (e.g., 'tareas complejas', 'proyectos largos', 'organizar trabajo', 'seguimiento de progreso') so users' phrasing matches without knowing the file names.

Move the dense security boundary sentences (nonce framing, gate mode, network load path) into the skill body; they consume description space without adding user-recognizable keywords.

State the core planning actions explicitly (crear un plan de fases, registrar hallazgos, actualizar progreso tras cada fase) instead of leaving them implied by file names.

DimensionReasoningScore

Specificity

The description lists several concrete actions with named artifacts: "Mantiene task_plan.md, findings.md y progress.md en disco", "los hooks del ciclo de vida inyectan contexto", and "session-catchup.py --metadata ... puede inspeccionar metadatos locales". It falls short of anchor 5 because the core planning behaviors (crear planes, seguir fases, actualizar progreso) are only implied by file names, and much of the text is spent on boundary disclaimers ("nunca ejecuta comandos declarados en Markdown", "no tiene ninguna ruta de carga por red") rather than capability coverage.

4 / 5

Completeness

Both what and when are present: the what is "Planificación persistente basada en archivos... Mantiene task_plan.md, findings.md y progress.md en disco", and an explicit trigger clause exists — "Úsalo para investigación o trabajo que requiera 5 o más llamadas a herramientas". Not anchor 5 because the 'when' covers only two scenarios (research, 5+ tool calls) while the multi-step-task trigger sits in the 'what' half, and the concrete trigger phrase set is narrow.

4 / 5

Trigger Term Quality

Some natural triggers exist — "tareas multipaso", "investigación", "5 o más llamadas a herramientas", "planificación" — but common variations users would actually say ("tarea compleja", "proyecto largo", "organizar", "seguimiento") are missing. It cannot reach anchor 4 because large stretches are pure technical jargon ("extractos limitados y enmarcados con nonce", "modo con gate", "ruta de carga por red") that no user would utter when requesting this skill.

3 / 5

Distinctiveness Conflict Risk

The mechanism is distinctive — three named planning files plus lifecycle-hook context injection — giving it a clear niche with minor overlap risk against generic task-tracking skills. It stays below anchor 5 because triggers like "investigación" are broad enough that many research-oriented skills could also claim them.

4 / 5

Total

15

/

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: 4 missing

Warning

Total

14

/

16

Passed

Repository

OthmanAdi/planning-with-files

Path

skills/i18n/planning-with-files-es/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.