Skills · Community project

Planning with Files

A skill that keeps plans, progress, and findings in persistent files so agents lose less context during long tasks and can recover after interruptions.

26.2k StarsMITShellUpdated 3 days ago
01

Project overview

Planning with Files is a Agent Skill built around a skill that keeps plans, progress, and findings in persistent files so agents lose less context during long tasks and can recover after interruptions. Its value is practical: break down complex tasks and record research findings are available from one documented project, while the repository remains inspectable before it is added to an agent workflow.

02

Core capabilities

01

Break down complex tasks

Break down complex tasks is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.

02

Record research findings

Record research findings is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.

03

Recover progress across sessions

Recover progress across sessions is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.

04

Preserve decision history

Preserve decision history is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.

03

Installation and usage

Set up Planning with Files from its public GitHub instructions, keep the initial permission scope small, and verify it with a low-risk task before regular use.

AI AGENT INSTALL

Let an AI Agent install it

Send this prompt to Codex, Claude Code, or another AI agent that can work with your local environment.

Help me set up Planning with Files.
Project URL: https://github.com/OthmanAdi/planning-with-files

Read the repository README and license first. Confirm the current host, prerequisites, destination paths, and permissions. Follow the repository's documented method, keep credentials out of files and logs, and start with the least-privilege or read-only option where available. Afterward, run a small verification and report the exact changes, commands, configuration path, and result. Ask before overwriting files or requesting broader access.
01Before you start
  • Node.js and npx are installed
  • The agent may create planning files in the project directory
02Copy the install command or configuration
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
03Complete the setup steps
  1. 1
    Review prerequisites and scope

    Read the README, confirm the target host, and prepare these prerequisites: Node.js and npx are installed; The agent may create planning files in the project directory. Check destination paths and permissions before making changes.

  2. 2
    Apply the documented setup

    Run the documented command: npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g

  3. 3
    Verify with a small task

    Restart or reload the target agent, confirm that Planning with Files appears in its installed extensions or skills, and run the smallest documented example before using it on important work.

How to verify the setup

Restart or reload the target agent, confirm that Planning with Files appears in its installed extensions or skills, and run the smallest documented example before using it on important work.

Before using it
  • Small one-off tasks may not justify the extra files
  • Planning files still need upkeep and do not replace judgment
04

Use cases

SCENARIO 01

Multi-hour coding tasks

Multi-hour coding tasks is a practical fit when the repository's documented prerequisites and permission model match the current environment.

SCENARIO 02

Research tasks requiring multiple searches

Research tasks requiring multiple searches is a practical fit when the repository's documented prerequisites and permission model match the current environment.

SCENARIO 03

Agent work that must resume after interruption

Agent work that must resume after interruption is a practical fit when the repository's documented prerequisites and permission model match the current environment.

05

Assessment

This assessment is based on the repository README, component documentation, license, and maintenance metadata. Moves fragile working context into inspectable files; Installation supports a wide range of agent hosts. The main trade-offs are also clear: Small one-off tasks may not justify the extra files; Planning files still need upkeep and do not replace judgment. No local installation or functional test was claimed during cataloging.

Why it may be useful

  • Moves fragile working context into inspectable files
  • Installation supports a wide range of agent hosts

What to know first

  • Small one-off tasks may not justify the extra files
  • Planning files still need upkeep and do not replace judgment
06

README

Planning with Files


Overview

A skill that keeps plans, progress, and findings in persistent files so agents lose less context during long tasks and can recover after interruptions. A skill that keeps plans, progress, and findings in persistent files so agents lose less context during long tasks and can recover after interruptions.

Getting started

  • Set up Planning with Files from its public GitHub instructions, keep the initial permission scope small, and verify it with a low-risk task before regular use.
  • The repository describes Planning with Files as a skill that keeps plans, progress, and findings in persistent files so agents lose less context during long tasks and can recover after interruptions.
  • Its main capabilities include break down complex tasks, record research findings, recover progress across sessions, preserve decision history. The documented facts include file-backed plans and progress, interruption recovery, compatibility with 18+ agents, skills cli installation.
  • Restart or reload the target agent, confirm that Planning with Files appears in its installed extensions or skills, and run the smallest documented example before using it on important work.

Configuration

npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
Read the complete README on GitHub