planning-with-files SKILL.md skillA

planning-with-files from frankxai/agentic-creator-os is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add frankxai/agentic-creator-os/planning-with-files@v2.4.1

Pins v2.4.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
frankxai/agentic-creator-os
Path
.claude/skills/planning-with-files/SKILL.md
Versions recorded
1
Latest version
v2.4.1, committed Jan 24, 2026
Size
7,358 bytes
Repository stars
12
License
Apache-2.0

Implements Manus-style file-based planning for complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when starting complex multi-step tasks, research projects, or any task requiring >5 tool calls. Now with automatic session recovery after /clear.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Planning with Files

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

## FIRST: Check for Previous Session (v2.2.0)

**Before starting work**, check for unsynced context from a previous session:

```bash
# Linux/macOS
$(command -v python3 || command -v python) ${CLAUDE_PLUGIN_ROOT}/scripts/session-catchup.py "$(pwd)"
```

```powershell
# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files\scripts\session-catchup.py" (Get-Location)
```

If catchup report shows unsynced context:
1. Run `git diff --stat` to see actual code changes
2. Read current planning files
3. Update planning files based on catchup + git diff
4. Then proceed with task

## Important: Where Files Go

- **Templates** are in `${CLAUDE_PLUGIN_ROOT}/templates/`
- **Your planning files** go in **your project directory**

| Location | What Goes There |
|----------|-----------------|
| Skill directory (`${CLAUDE_PLUGIN_ROOT}/`) | Templates, scripts, reference docs |
| Your project directory | `task_plan.md`, `findings.md`, `progress.md` |

## Quick Start

Before ANY complex task:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add frankxai/agentic-creator-os/planning-with-files@sha256:6342289ed4e81530

The line at the top of this page pins the label v2.4.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_rfhy2nq7ky3pwsln.svg)](https://markdownregistry.com/a/art_rfhy2nq7ky3pwsln)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jan 24, 2026.

versioncommittedcommitsizeaudit
v2.4.1 latest2026-01-24 0bc6f23 7,358 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7358 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

frankxai/agentic-creator-os · 12 stars · license Apache-2.0 · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rfhy2nq7ky3pwsln
GET https://markdownregistry.com/api/v1/resolve?ref=frankxai/agentic-creator-os/planning-with-files
GET https://markdownregistry.com/api/v1/blob/6342289ed4e8153080465289661b809711d734b9606a36275e1a227d4ee7af8b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from frankxai/agentic-creator-os

CLAUDE.md@.claude/agents CLAUDE.md file
frankxai/agentic-creator-os · .claude/agents/CLAUDE.md
git:20260208.cc717b0 · audit A · 12 stars
CLAUDE.md@.claude/commands CLAUDE.md file
frankxai/agentic-creator-os · .claude/commands/CLAUDE.md
git:20260208.ed60018 · audit A · 12 stars
CLAUDE.md@.claude/skills CLAUDE.md file
frankxai/agentic-creator-os · .claude/skills/CLAUDE.md
git:20260124.0bc6f23 · audit A · 12 stars
acos-meta SKILL.md skill
frankxai/agentic-creator-os · .claude/skills/acos-meta/SKILL.md · ACOS self-description and configuration skill. Documents how ACOS works, how to extend it, how to add new…
git:20260225.6aba189 · audit A · 12 stars
agentic-jujutsu SKILL.md skill
frankxai/agentic-creator-os · .claude/skills/agentic-jujutsu/SKILL.md · Quantum-resistant, self-learning version control for AI agents with ReasoningBank intelligence and multi-agent…
v2.3.2 · audit A · 12 stars
CLAUDE.md@.claude/skills/agentic-orchestration CLAUDE.md file
frankxai/agentic-creator-os · .claude/skills/agentic-orchestration/CLAUDE.md
git:20260208.ed60018 · audit B · 12 stars
agentic-orchestration SKILL.md skill
frankxai/agentic-creator-os · .claude/skills/agentic-orchestration/SKILL.md · Patterns for multi-agent coordination, task decomposition, handoffs, and workflow orchestration. Best practices for…
v1.0.0 · audit A · 12 stars
AI Architect Newsletter SKILL.md skill
frankxai/agentic-creator-os · .claude/skills/ai-architect-newsletter/SKILL.md · Generate high-quality AI Architect newsletters with latest AI news, research integration, and visual design. Use when…
git:20260225.6aba189 · audit A · 12 stars
ai-architecture SKILL.md skill
frankxai/agentic-creator-os · .claude/skills/ai-architecture/SKILL.md · Expert guidance on multi-cloud architecture, cost analysis, and technical decision-making for AI-powered platforms
v1.0.0 · audit A · 12 stars
algorithmic-art SKILL.md skill
frankxai/agentic-creator-os · .claude/skills/algorithmic-art/SKILL.md · Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users…
git:20260124.18c2f0b · audit B · 12 stars
algorithmic-art SKILL.md skill
frankxai/agentic-creator-os · .claude/skills/anthropic/algorithmic-art/SKILL.md · Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users…
git:20260124.0bc6f23 · audit B · 12 stars
artifacts-builder SKILL.md skill
frankxai/agentic-creator-os · .claude/skills/anthropic/artifacts-builder/SKILL.md · Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies…
git:20260124.0bc6f23 · audit A · 12 stars

Every file in frankxai/agentic-creator-os

Other files named planning-with-files

planning-with-files SKILL.md skill
othmanadi/planning-with-files · .codebuddy/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.25.0 · audit A · 27,556 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .mastracode/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.25.0 · audit A · 27,556 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .continue/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v2.43.0 · audit A · 27,556 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .gemini/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v2.43.0 · audit A · 27,556 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .factory/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.25.0 · audit A · 27,556 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .kiro/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.0.1-kiro · audit A · 27,556 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .hermes/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.25.0 · audit A · 27,556 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .opencode/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.25.0 · audit A · 27,556 stars

Browse by kind, by grade A, or by owner.