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
64/100 · grade D
OthmanAdi/planning-with-files/.agents/skills/planning-with-files at 6b30f32
Spec 0 · Efficiency 14 · Clarity 25 · Security 25 (each out of 25)
Always loaded 157 tokens · on trigger 8,427 · on demand 102,619
eff/body-tokenswarn · SKILL.md~8427 tokens load every time this triggers. Aim for under 5,000; split into reference files read on demand.spec/non-portable-keyswarn · 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-refwarn · SKILL.md:42References task_plan.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:42References progress.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:42References findings.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:42References task_plan.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:48References session-catchup.py, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:227References task_plan.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:329References task_plan.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:330References task_plan.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:346References loop.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:348References .claude/loop.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:348References templates/loop.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:429References task_plan.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:429References progress.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:484References findings.md, which isn't in the skill folder.
Where it comes from
Source
| Fact | Value |
|---|---|
| Repository | OthmanAdi/planning-with-files |
| Skill folder | .agents/skills/planning-with-files |
| Stars | 27,477 |
| License | MIT |
| Commit scanned | 6b30f32 |
| Scanned | 2026-10-16 |
| Files | 25 |
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.
[](https://proskills.dev/reports/othmanadi-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.
- Trend RadarThe last 30 days, dated and linked.Loads when the user needs current research on a topic.4 rules · Viral HooksScan 100$9
- AGENTS.md ArchitectA short instructions file from your real repo.Loads when the user writes, rewrites or audits CLAUDE.md, AGENTS.md or rules files.5 rules · Agent OpsScan 100Free
- Hook SmithHooks and CI checks the agent can't skip.Loads when a rule must always run or must never be broken.5 rules · Agent OpsScan 100$9
Same repository
More from OthmanAdi/planning-with-files
- planning-with-filesGrade D62/100
- planning-with-filesGrade C74/100
- planning-with-filesGrade C76/100
- planning-with-filesGrade C74/100
- planning-with-filesGrade C74/100
- planning-with-filesGrade D66/100
- planning-with-filesGrade D68/100
- planning-with-filesGrade D64/100
- planning-with-filesGrade B80/100
- planning-with-filesGrade C74/100
- planning-with-files-arGrade B86/100
- planning-with-files-deGrade B86/100
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.