Agent skill

Planning With Files

by jarrodwatts in jarrodwatts/claude-code-config

Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage.

No licenceAuto-check passedAI & LLM Engineering

Install Planning With Files

skills CLI
$ npx skills add jarrodwatts/claude-code-config --skill planning-with-files -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jarrodwatts/claude-code-config planning-with-files --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jarrodwatts/claude-code-config.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/planning-with-files .claude/skills/planning-with-files && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
planning-with-files
GitHub stars
1.1k
Used in
5 other repos
Token cost
~967 tokens
SKILL.md length
322 words
Files
3
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage.

  • Works in 5 steps: ALWAYS Create Plan First → Read Before Decide → Update After Act → …
  • Starting complex tasks
  • SKILL.md covers Quick Start, The 3-File Pattern, Core Workflow and task_plan.md Template, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Planning With Files is an agent skill from jarrodwatts/claude-code-config. Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Use when starting complex tasks, multi-step projects, research tasks, or when the user mentions planning, organizing work, tracking progress, or wants structured output.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `examples.md` and `reference.md`).

It sits in AI & LLM Engineering, covering Planning and Structured output and tool calling. The repository describes itself as: My personal Claude Code configuration - rules, hooks, agents, skills, and commands.

When your agent uses it

  • Starting complex tasks
  • Multi-step projects
  • The user mentions planning
  • Organizing work

Example prompts

  • “Use the planning-with-files skill to transform workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge…”
  • “/planning-with-files”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. ALWAYS Create Plan First
  2. Read Before Decide
  3. Update After Act
  4. Store, Don't Stuff
  5. Log All Errors

What it can do on your machine

Read from SKILL.md and the folder at commit bb7e8b0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Planning With Files loads about 967 tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 322 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~967

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 322 words (~967 tokens).

“Work like Manus: Use persistent markdown files as your "working memory on disk."”

— opening of SKILL.md by jarrodwatts
name
planning-with-files

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files in skills/planning-with-files of jarrodwatts/claude-code-config.

  • SKILL.md
  • examples.md
  • reference.md

Open the folder on GitHubat commit bb7e8b0

Used in 5 other repositories

We found 7 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in jarrodwatts/claude-code-config, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Planning With Files next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Planning With Files compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Planning With Files this skilljarrodwatts/claude-code-config1.1k5 repos~967Automated safety check: PassNone
Claude Code Clawdbotwin4r/claude-code-clawdbot-skill123—~2.5kAutomated safety check: WarnNone
Agent Interface DesignNeeeophytee/finding-unknowns-skills344—~650Automated safety check: PassMIT
AI Agents Architectdavila7/claude-code-templates33k3 repos~641Automated safety check: PassMIT
Build Agentsvercel/vercel-plugin301—~1.4kAutomated safety check: PassCustom licence
Context Fundamentalsaiskillstore/marketplace4336 repos~3.1kAutomated safety check: PassNone

Similar skills

  • Claude Code Clawdbot

    win4r/claude-code-clawdbot-skill

    Run Claude Code (Anthropic) from this host via the claude CLI (Agent SDK) in headless mode (-p) for codebase analysis, refactors, test fixing, and structured output.

    123 GitHub stars~2.5k tokensUpdated 8 mo ago
    AI & LLM EngineeringAuto-check: warnings
  • Agent Interface Design

    Neeeophytee/finding-unknowns-skills

    Design tools, scripts, and CLIs that an agent will call, so the interface teaches its own use instead of a wall of prose and examples.

    344 GitHub stars~650 tokensUpdated 13 days ago
    AI & LLM EngineeringAuto-check passed
  • AI Agents Architect

    davila7/claude-code-templates

    Expert in designing and building autonomous AI agents. An agent skill from davila7/claude-code-templates.

    33k GitHub starsUsed in 3 repos~641 tokens
    AI & LLM EngineeringAuto-check passed
  • Build Agents

    vercel/vercel-plugin

    Official

    Default guidance for building AI agents. An agent skill from vercel/vercel-plugin.

    301 GitHub stars~1.4k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Context Fundamentals

    aiskillstore/marketplace

    Context is the complete state available to a language model at inference time.

    433 GitHub starsUsed in 6 repos~3.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Ax Gen

    dosco/aithy

    This skill helps an LLM generate correct AxGen code using @ax-llm/ax.

    107 GitHub stars~5.4k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed

Questions about Planning With Files

What does Planning With Files do?

Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Planning With Files is an agent skill from jarrodwatts/claude-code-config. Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage.

When should I use Planning With Files?

Planning With Files fits situations like: starting complex tasks; multi-step projects; the user mentions planning; organizing work.

How do I install Planning With Files in Claude Code?

Run `npx skills add jarrodwatts/claude-code-config --skill planning-with-files -a claude-code`. Or copy the skill folder (skills/planning-with-files in jarrodwatts/claude-code-config) into .claude/skills/planning-with-files in your project. Claude Code loads it when a task matches its description.

How do I install Planning With Files in Codex?

Run `npx skills add jarrodwatts/claude-code-config --skill planning-with-files -a codex`. Or copy the skill folder (skills/planning-with-files in jarrodwatts/claude-code-config) into .agents/skills/planning-with-files in your project. Codex loads it when a task matches its description.

Can I use Planning With Files in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jarrodwatts/claude-code-config --skill planning-with-files -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/planning-with-files, .gemini/skills/planning-with-files, .github/skills/planning-with-files and .opencode/skills/planning-with-files in your project.

What does Planning With Files need to run?

SKILL.md names no scripts, command-line tools or credentials: Planning With Files is instructions for the agent only.

Does Planning With Files access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Planning With Files safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Planning With Files use?

No licence was found for Planning With Files or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Planning With Files use?

About 967 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Planning With Files?

Skills that share tags, products or a category with Planning With Files: Claude Code Clawdbot (win4r/claude-code-clawdbot-skill, 123 stars), Agent Interface Design (Neeeophytee/finding-unknowns-skills, 344 stars), AI Agents Architect (davila7/claude-code-templates, 33k stars) and Build Agents (vercel/vercel-plugin, 301 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Planning With Files?

jarrodwatts (a GitHub user) maintains it in jarrodwatts/claude-code-config, which has 1,064 GitHub stars. The repository was last updated on January 21, 2026.

Source: jarrodwatts/claude-code-config on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.