← All skills

planning-with-files

84 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By mxyhi/ok-skills (GitHub) · coding · 512 stars · scanned at commit 3ae9eb9

Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. Optional gated mode can request continuation only when the host supports it and never runs commands …

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'planning-with-files' ] || [ -L ~/.agents/skills/'planning-with-files' ]; then echo 'A skill folder named planning-with-files already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/mxyhi/ok-skills' "$d" && git -C "$d" checkout --quiet '3ae9eb922f9db7b66a5327529afd550d78d60fb0' -- 'planning-with-files' && mkdir -p ~/.agents/skills && cp -R "$d"/'planning-with-files' ~/.agents/skills/'planning-with-files' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'planning-with-files' ~/.claude/skills/'planning-with-files' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for mxyhi/ok-skills shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/mxyhi/ok-skills.svg)](https://zalavijaysinh.github.io/skilltrust/repos/mxyhi/ok-skills/)

Score history