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.
Verdict
OthmanAdi/planning-with-files/.opencode/skills/planning-with-files at 6b30f32
Spec 9 · Efficiency 19 · Clarity 21 · Security 25 (each out of 25)
Always loaded 157 tokens · on trigger 2,274 · on demand 67,879
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:49References task_plan.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:49References progress.md, which isn't in the skill folder.spec/broken-refwarn · SKILL.md:49References findings.md, which isn't in the skill folder.clarity/outputwarn · SKILL.mdDoesn't say what the result should look like. Add an Output section.eff/orphan-fileinfo · templates/analytics_findings.mdtemplates/analytics_findings.md is never mentioned in SKILL.md, so the agent won't know to read it.eff/orphan-fileinfo · 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-fileinfo · templates/loop.mdtemplates/loop.md is never mentioned in SKILL.md, so the agent won't know to read it.
Source
| Fact | Value |
|---|---|
| Repository | OthmanAdi/planning-with-files |
| Skill folder | .opencode/skills/planning-with-files |
| Stars | 27,477 |
| License | MIT |
| Commit scanned | 6b30f32 |
| Scanned | 2026-10-16 |
| Files | 22 |
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.
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-planning-with-files-10)
Scanned alternatives on ProSkills
Skills in the ProSkills catalog that cover similar ground. Every one passes the same scanner before it ships.
- Trend Radar$9Scan 100/1004 rules · Viral HooksThe last 30 days, dated and linked.Loads when the user needs current research on a topic.
- AGENTS.md ArchitectFreeScan 100/1005 rules · Agent OpsA short instructions file from your real repo.Loads when the user writes, rewrites or audits CLAUDE.md, AGENTS.md or rules files.
- Hook Smith$9Scan 100/1005 rules · Agent OpsHooks and CI checks the agent can't skip.Loads when a rule must always run or must never be broken.
More from OthmanAdi/planning-with-files
| Skill | Scan | Grade |
|---|---|---|
| planning-with-files | 64/100 | D |
| planning-with-files | 62/100 | D |
| planning-with-files | 74/100 | C |
| planning-with-files | 76/100 | C |
| planning-with-files | 74/100 | C |
| planning-with-files | 74/100 | C |
| planning-with-files | 66/100 | D |
| planning-with-files | 68/100 | D |
| planning-with-files | 64/100 | D |
| planning-with-files | 80/100 | B |
| planning-with-files-ar | 86/100 | B |
| planning-with-files-de | 86/100 | B |
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.
Keep reading
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.