Open-source repos
OthmanAdi/planning-with-files
File-based task planning
This page provides source information and editorial guidance. Recommendations and trust labels do not mean every skill here was tested. Results for individual skills are on the skill data pages. See skill data · Listing policy
Overview
OthmanAdi/planning-with-files is an open-source skill project for organizing agent task planning in files. It offers practices for preserving goals, progress and context during longer tasks, making it relevant to developers who want multi-step work to be easier to inspect and resume.
SkillFlux sample check
On 2026-10-31, SkillFlux pinned this source at commit b6580cd, drew a seeded sample of 18 from the 18 entries it contains, and ran static health check 1.0.0 on each. 78% had no failing check, said when to use the skill and carried a license.
- 18/18sampled entries had a SKILL.md we could check
- 0/18fail at least one check
- 4/18do not say when to use the skill
- 0/18have no license we could find
- 18/18bundle scripts the agent may run
- 0/18include scripts that call the network
- 14/18include destructive shell commands
- 3/18exceed the 5,000-token body guideline
See the 18 sampled entries
| Entry | Result | Flags |
|---|---|---|
| OthmanAdi/planning-with-files/.mastracode/skills/planning-with-files | 14 pass, 1 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/skills/planning-with-files | 13 pass, 2 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.factory/skills/planning-with-files | 14 pass, 1 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.cursor/skills/planning-with-files | 14 pass, 1 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.codebuddy/skills/planning-with-files | 13 pass, 2 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/skills/i18n/planning-with-files-zht | 13 pass, 2 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.pi/skills/planning-with-files | 13 pass, 2 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/skills/i18n/planning-with-files-zh | 14 pass, 1 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.hermes/skills/planning-with-files | 14 pass, 1 warn, 0 fail | Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/skills/i18n/planning-with-files-es | 13 pass, 2 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/skills/i18n/planning-with-files-ar | 13 pass, 2 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.continue/skills/planning-with-files | 14 pass, 1 warn, 0 fail | Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.opencode/skills/planning-with-files | 14 pass, 1 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/skills/i18n/planning-with-files-de | 13 pass, 2 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.agents/skills/planning-with-files | 13 pass, 2 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.kiro/skills/planning-with-files | 15 pass, 0 warn, 0 fail | Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.codex/skills/planning-with-files | 14 pass, 1 warn, 0 fail | Scripts contain rm -rf, sudo or similar, Bundles scripts the agent may run |
| OthmanAdi/planning-with-files/.gemini/skills/planning-with-files | 15 pass, 0 warn, 0 fail | Bundles scripts the agent may run |
The sample reads files only; it does not run any skill and does not describe entries outside the sample. Flags describe what a skill contains; they are not verdicts. Raw data · Method
Best for
- Developers continuing work across multiple steps or sessions.
- Teams that want task state recorded in project files.
Use cases
- Planning & long tasks
- Coding & development
SkillFlux notes
Try a real task with its goal, acceptance criteria and current state recorded, then check whether those files guide the next step when resuming. The records are useful only when updated from actual outcomes; a written plan is not completed work.
Installation and use
Open the original repository and read its README, the selected skill instructions and any linked scripts. Check installation paths, host requirements, dependencies and licenses, then follow the project documentation to verify a small task in a workspace you can restore.
Limitations
- File records depend on the agent reading and maintaining them correctly; they do not automatically eliminate omissions or context errors.
Alternatives
- Superpowers (obra)
Compare Superpowers when planning needs to sit alongside debugging and testing in a development workflow.
- everything-claude-code (Chinese Edition)
Read the Chinese everything-claude-code collection when you need broader Claude Code configuration examples in Chinese.