Skills planning-with-files
๐Ÿ“ฆ

planning-with-files

v2.1.2 Content revision r1 Safe โš™๏ธ External commands๐Ÿ“ Filesystem access

Organize Long AI Tasks with Planning Files

Long AI sessions can lose goals, decisions, and progress. This skill guides Claude, Codex, and Claude Code to store plans, findings, and logs in project files.

Supports: Claude Codex Code(CC)
๐Ÿฅ‡ 83 Gold

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request
Review the Skillstore skill "planning-with-files" from https://skillstore.io/skills/zhanlincui-planning-with-files.md and its manifest at https://skillstore.io/api/skills/zhanlincui-planning-with-files/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Your Agent should still show its plan and request any confirmation required by the security policy.

Test it

Using "planning-with-files". Start a feature build that needs research, implementation, and testing.

Expected outcome:

A task plan with phases, a findings log for research, and a progress log for actions and tests.

Using "planning-with-files". Resume a project after a long session gap.

Expected outcome:

  • Reads existing planning files.
  • Summarizes the current phase and completed work.
  • Continues from the next unfinished step.

Using "planning-with-files". Check whether the task is ready to finish.

Expected outcome:

A completion review that compares completed phases with pending or in-progress sections.

Security Audit

Safe
v4 โ€ข 7/8/2026 Open versioned report

The static findings are benign in context. The shell scripts use fixed local commands for planning setup and status checks. The markdown backtick detections are formatting examples. No prompt injection, data exfiltration intent, destructive behavior, or unauthorized network activity was found.

8
Files scanned
1,144
Lines analyzed
0
Review items
0
False positives ignored
No confirmed security findings were detected by the latest completed static and semantic audit. This does not prove the skill has no side effects.
Audited by: codex View Audit History โ†’
Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report
Security Assessment

Copy report link

https://skillstore.io/skills/zhanlincui-planning-with-files/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/zhanlincui-planning-with-files/security.svg)](https://skillstore.io/skills/zhanlincui-planning-with-files?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/zhanlincui-planning-with-files?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/zhanlincui-planning-with-files/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/zhanlincui-planning-with-files.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
Academic citations (APA ยท BibTeX ยท CFF)

APA citation

ZhanlinCui. (2026). planning-with-files security audit report (audit version 4) [Author version 2.1.2]. Skillstore. https://skillstore.io/skills/zhanlincui-planning-with-files/audits/4

BibTeX citation

@techreport{zhanlincui-zhanlincui-planning-with-files-2026, author = {ZhanlinCui}, title = {planning-with-files security audit report (audit version 4)}, institution = {Skillstore}, year = {2026}, number = {4}, url = {https://skillstore.io/skills/zhanlincui-planning-with-files/audits/4}, note = {Author version 2.1.2} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "planning-with-files security audit report (audit version 4)" version: "2.1.2" type: report authors: - name: "ZhanlinCui" date-released: "2026-07-08" url: "https://skillstore.io/skills/zhanlincui-planning-with-files/audits/4" identifiers: - type: other value: "skillstore:zhanlincui-planning-with-files:audit:4" description: "Skillstore immutable audit report identifier"

Compare variants

4 installable variants

Each author remains a separate installable skill. The recommended variant is ranked by Skillstore evidence.

Why this variant is first

Highest Skillstore Score
ZhanlinCui Recommended Current

zhanlincui-planning-with-files

Skillstore Score 83
Evidence Confidence High
Skillstore usage 263
Updated

2026-08-21

ammarcodes-planning-with-files

Skillstore Score 79
Evidence Confidence High
Skillstore usage 16
Updated

2026-08-21

othmanadi-planning-with-files

Skillstore Score 78
Evidence Confidence High
Skillstore usage 35
Updated

2026-08-21

sickn33-planning-with-files

Skillstore Score 73
Evidence Confidence High
Skillstore usage 17
Updated

2026-08-21

Skillstore Score

Why this score Evidence Confidence: High
59
Architecture
100
Maintainability
85
Content
79
Community
91
Spec Compliance

What You Can Build

Plan Multi-Step Implementation

Break a coding task into phases, decisions, tests, and delivery steps before work begins.

Track Research Sessions

Capture sources, discoveries, and open questions during long investigation tasks.

Resume Long Agent Work

Reload goals, current phase, findings, and prior errors after a context reset or break.

Try These Prompts

Start a Plan
Use planning-with-files for this task. Create task_plan.md, findings.md, and progress.md before beginning.
Maintain Progress
Use planning-with-files. After each phase, update the plan status, findings, errors, and test results.
Resume Existing Work
Use planning-with-files to resume this project. Read the planning files, summarize current status, and continue from the next phase.
Manage a Full Workflow
Use planning-with-files to manage a complex task with research, implementation, verification, and delivery phases. Keep decisions and failed attempts documented.

Best Practices

  • Create the planning files before starting complex work.
  • Update findings after research, browser, or visual inspection steps.
  • Record failed attempts and decisions before changing approach.

Avoid

  • Using this skill for a one-step question.
  • Creating planning files inside the skill installation directory.
  • Retrying the same failing action without updating the plan.

Frequently Asked Questions

When should I use this skill?
Use it for multi-step work, research, feature builds, debugging, or tasks that may span many tool calls.
Which files does it create?
It guides creation of task_plan.md, findings.md, and progress.md in the active project directory.
Does it replace project management software?
No. It creates local planning files for agent context, not shared tickets or team workflows.
Can I use it with Claude Code?
Yes. The skill metadata lists support for Claude, Codex, and Claude Code.
What do the helper scripts do?
They initialize local planning files and check whether task plan phases are marked complete.
Is it useful for quick answers?
Usually no. The planning overhead is best for tasks with several phases or many tool calls.

Developer Details

Author

ZhanlinCui

License

MIT

Author version

v2.1.2

Skillstore revision

r1

Ref

88a205c7f635a966e31156313b590d59007c5caa

Maintenance freshness

7/18/2026

Usage

238 downloads ยท 381 views

File structure

๐Ÿ“ scripts/

๐Ÿ“„ check-complete.sh

๐Ÿ“„ init-session.sh

๐Ÿ“ templates/

๐Ÿ“„ findings.md

๐Ÿ“„ progress.md

๐Ÿ“„ task_plan.md

๐Ÿ“„ examples.md

๐Ÿ“„ reference.md

๐Ÿ“„ SKILL.md

More from ZhanlinCui

View all
View all