What it is
Keeps task_plan.md, findings.md and progress.md on disk so a long agent task can survive context loss, with hooks that re-inject the plan.
Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. 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. Optional gated mode can request continuation only when the host supports it and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls.
Benchmark results
This skill has not been benchmarked yet. Only the static health check below has been run. Request a benchmark
Static health check
Checker 1.0.0 at commit 5d29800: 14 pass, 2 warning, 0 fail, 5 informational. Result last changed 2026-10-29.
- Scripts contain rm -rf, sudo or similar
- Bundles scripts the agent may run
| Check | Result | Detail |
|---|---|---|
body.tokensApproxApproximate token count of the SKILL.md body; above 5000 is a warning. | Warning | large body; consider moving detail into referenced files |
scripts.destructiveScripts with destructive commands such as rm -rf, sudo or chmod 777. | Warning | scripts/inject-plan.sh (rm-rf) |
frontmatter.unknownKeysFrontmatter keys outside the documented set (information only). | Info | none |
files.inventoryNumber and total size of files in the skill directory (information only). | Info | 32 files, 470223 bytes |
scripts.presentBundled scripts the agent may run (information only). | Info | 5 files
|
scripts.networkScripts that call the network (information only). | Info | no network calls found |
pinned.driftWhether upstream changed the skill after the pinned commit (information only). | Info | unchanged since the pinned commit |
skillmd.presentA SKILL.md file exists at the skill root. | Pass | SKILL.md found |
frontmatter.parseSKILL.md starts with YAML frontmatter that parses as a mapping. | Pass | frontmatter parsed |
frontmatter.namename is present, at most 64 characters, lowercase letters, digits and hyphens. | Pass | valid name |
frontmatter.nameMatchesDirname matches the directory that contains SKILL.md. | Pass | name matches its directory |
frontmatter.descriptiondescription is present and at most 1024 characters; under 50 is a warning. | Pass | 606 characters |
frontmatter.descriptionTriggerdescription says when to use the skill ("use when…", "when the user…"). | Pass | states when to use the skill |
frontmatter.descriptionVoicedescription is written in the third person and contains no XML tags. | Pass | third person, no XML |
body.linesLine count of the SKILL.md body; above 500 is a warning. | Pass | 481 lines |
refs.brokenLinksRelative links in SKILL.md point to files that exist. | Pass | all relative links resolve |
files.binaryNo executables or archives (.exe, .zip, .jar, …) are bundled. | Pass | no executables or archives |
secrets.scanNo strings that look like private keys or API tokens. | Pass | none found |
instructions.riskNo instructions to override prior instructions, exfiltrate secrets or bypass safety controls. | Pass | none found |
license.detectedA license is declared in frontmatter, the skill directory or the repository. | Pass | repository license |
repo.activityThe skill path changed within 365 days of the check, and the repository is not archived. | Pass | last changed 0 days before the check |
Limits of this report
- Results describe one commit of the skill. Later versions may behave differently.
- The static check reads files; it does not show whether the skill helps on a task.
- The skill's author was not consulted before publication. Corrections are welcome. Report an error
Questions
- What does SkillFlux's data say about Planning with files?
- As of 2026-10-29, SkillFlux's static health check of Planning with files at commit 5d29800 recorded 14 passes, 2 warnings and 0 failures, plus 5 informational results, across 21 checks; it has not been benchmarked yet.
- Has Planning with files been benchmarked?
- Not yet. Only the static health check has been run. You can request a benchmark by email from the submit page.
- What license is Planning with files under?
- MIT, as detected at commit 5d29800. Check the repository for the authoritative terms.
How to cite
SkillFlux (2026-10-29). Planning with files health check, commit 5d29800, checker 1.0.0. https://skillflux.app/skills/othmanadi-planning-with-files/
BibTeX
@misc{skillflux_othmanadi_planning_with_files_20261029,
author = {{SkillFlux}},
title = {Planning with files health check (commit 5d29800)},
year = {2026},
month = {10},
howpublished = {\url{https://skillflux.app/skills/othmanadi-planning-with-files/}},
note = {Methodology v1. Data: https://skillflux.app/data/skills/othmanadi-planning-with-files.json. Accessed 2026-10-29.},
}