ProSkillsLibraryFreePassScan

Scan reports · OthmanAdi/planning-with-files

planning-with-files: scan report

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… An automated scan of this public skill from OthmanAdi/planning-with-files: security, token cost, spec and clarity, with every finding and its fix.

Result

Verdict

planning-with-files

64/100 · grade D

OthmanAdi/planning-with-files/.kiro/skills/planning-with-files at 6b30f32

Spec 5 · Efficiency 13 · Clarity 21 · Security 25 (each out of 25)

Always loaded 129 tokens · on trigger 1,910 · on demand 5,610

  • spec/broken-ref warn · SKILL.md:54References .kiro/plan/task_plan.md, which isn't in the skill folder.
  • spec/broken-ref warn · SKILL.md:54References .kiro/plan/progress.md, which isn't in the skill folder.
  • spec/broken-ref warn · SKILL.md:60References .kiro/plan/task_plan.md, which isn't in the skill folder.
  • spec/broken-ref warn · SKILL.md:61References .kiro/plan/progress.md, which isn't in the skill folder.
  • spec/broken-ref warn · SKILL.md:211References findings.md, which isn't in the skill folder.
  • clarity/output warn · SKILL.mdDoesn't say what the result should look like. Add an Output section.
  • eff/orphan-file info · assets/templates/findings.mdassets/templates/findings.md is never mentioned in SKILL.md, so the agent won't know to read it.
  • eff/orphan-file info · assets/templates/planning-context.mdassets/templates/planning-context.md is never mentioned in SKILL.md, so the agent won't know to read it.
  • eff/orphan-file info · assets/templates/progress.mdassets/templates/progress.md is never mentioned in SKILL.md, so the agent won't know to read it.
  • eff/orphan-file info · assets/templates/task_plan.mdassets/templates/task_plan.md is never mentioned in SKILL.md, so the agent won't know to read it.
  • eff/nested-refs info · assets/templates/findings.mdassets/templates/findings.md is nested deeply; keep references one level below SKILL.md.
  • eff/nested-refs info · assets/templates/planning-context.mdassets/templates/planning-context.md is nested deeply; keep references one level below SKILL.md.
  • eff/nested-refs info · assets/templates/progress.mdassets/templates/progress.md is nested deeply; keep references one level below SKILL.md.
  • eff/nested-refs info · assets/templates/task_plan.mdassets/templates/task_plan.md is nested deeply; keep references one level below SKILL.md.

Where it comes from

Source

FactValue
RepositoryOthmanAdi/planning-with-files
Skill folder.kiro/skills/planning-with-files
Stars27,477
LicenseMIT
Commit scanned6b30f32
Scanned2026-10-16
Files13

ProSkills doesn't host or redistribute this skill. Get it from its repository, and check the license before reusing it. Something wrong here? Open an issue for a rescan or removal.

For maintainers

Badge for the README

If you maintain this skill, this badge shows its score and links to this report. Fix findings and the score moves with the next scan.

[![ProSkills scan 64/100](https://proskills.dev/badge?score=64)](https://proskills.dev/reports/othmanadi-planning-with-files-planning-with-files-8)

Alternatives

Scanned alternatives on ProSkills

Skills in the ProSkills catalog that cover similar ground. Every one passes the same scanner before it ships.

Same repository

More from OthmanAdi/planning-with-files

FAQ

Questions

Is planning-with-files safe to install?
No known risky patterns found. The scan covers prompt injection, hidden Unicode, remote code execution and credential access in every text file of the skill. It cannot judge intent, so read any flagged line in context before installing.
How was this score calculated?
Four checks of 25 points each: spec, efficiency, clarity and security. Findings take points off the check they belong to, and any critical finding caps the grade at F. The same scanner runs in your browser at proskills.dev/scan.
Is this report current?
It was made from commit 6b30f32 on 2026-10-16. If the skill has changed since, paste the new version into the scanner for a fresh score.
I wrote this skill. Can I fix the score or have the page removed?
Fix the findings and push. The reports are rebuilt from GitHub on a schedule, so the next run picks the change up. To have the page removed, open an issue on the ProSkills GitHub repo.

Related

Keep reading

Free tool

Scan your own skill

Paste a SKILL.md or drop a folder. It is scored in your browser and nothing is uploaded.

Want a skill that already passes? Start with a free one.