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; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning… 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

62/100 · grade D

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

Spec 1 · Efficiency 15 · Clarity 21 · Security 25 (each out of 25)

Always loaded 157 tokens · on trigger 1,863 · on demand 94,313

  • spec/non-portable-keys warn · SKILL.mdNon-spec frontmatter (user-invocable, hooks). claude.ai and the Skills API reject the upload; move them under `metadata` or drop them.
  • spec/broken-ref warn · SKILL.md:49References task_plan.md, which isn't in the skill folder.
  • spec/broken-ref warn · SKILL.md:49References progress.md, which isn't in the skill folder.
  • spec/broken-ref warn · SKILL.md:49References findings.md, which isn't in the skill folder.
  • spec/broken-ref warn · SKILL.md:224References reference.md, which isn't in the skill folder.
  • spec/broken-ref warn · SKILL.md:225References examples.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 · references/examples.mdreferences/examples.md is never mentioned in SKILL.md, so the agent won't know to read it.
  • eff/orphan-file info · references/reference.mdreferences/reference.md is never mentioned in SKILL.md, so the agent won't know to read it.
  • eff/orphan-file info · templates/analytics_findings.mdtemplates/analytics_findings.md is never mentioned in SKILL.md, so the agent won't know to read it.
  • eff/orphan-file info · templates/analytics_task_plan.mdtemplates/analytics_task_plan.md is never mentioned in SKILL.md, so the agent won't know to read it.
  • eff/orphan-file info · templates/loop.mdtemplates/loop.md is never mentioned in SKILL.md, so the agent won't know to read it.

Where it comes from

Source

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

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 62/100](https://proskills.dev/badge?score=62)](https://proskills.dev/reports/othmanadi-planning-with-files-planning-with-files)

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.