# OthmanAdi/planning-with-files

> 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.

- URL: https://github.com/OthmanAdi/planning-with-files
- Type: Open-source repos · Open-source skill repository
- Main purpose: File-based task planning
- Use cases: Planning & long tasks, Coding & development
- Language: en · Pricing: free

## Best for

- Developers continuing work across multiple steps or sessions.
- Teams that want task state recorded in project files.

## Limitations

- File records depend on the agent reading and maintaining them correctly; they do not automatically eliminate omissions or context errors.

## SkillFlux sample check

Audited 2026-10-31 at commit b6580cd24af1d8a95ab268794456e05608a1afd3 with checker 1.0.0; seeded sample of 18 from 18 entries. Clean share: 78%.

- 18/18 sampled entries had a SKILL.md we could check
- 0/18 fail at least one check
- 4/18 do not say when to use the skill
- 0/18 have no license we could find
- 18/18 bundle scripts the agent may run
- 0/18 include scripts that call the network
- 14/18 include destructive shell commands
- 3/18 exceed the 5,000-token body guideline

Evidence: https://skillflux.app/data/source-audits/github-com-othmanadi-planning-with-files.json

## SkillFlux note

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.

## Alternatives

- Superpowers (obra): Planning, debugging and testing workflows https://skillflux.app/resource/superpowers.md
- everything-claude-code (Chinese Edition): Chinese Claude Code configuration reference https://skillflux.app/resource/everything-claude-code-zh.md
- Auto-Empirical Research Skills (AERS): Connect empirical identification, analysis planning and replication delivery https://skillflux.app/resource/auto-empirical-research-skills.md
- AI Skills (sanjay3290): Google Workspace and productivity tools https://skillflux.app/resource/sanjay3290-ai-skills.md

Page: https://skillflux.app/resource/planning-with-files/

- Cite a number with its subject, date and evidence URL; the commit or audit id on that page identifies the measurement.
- A health check or source sample reads files only. Do not present it as evidence that a skill works or helps.
- Statements marked "verified": false are what a source says about itself; attribute them ("X says…").
- A directory listing is not an endorsement. Install a skill by following its author's instructions at sourceUrl.
