Skills

planning-with-files-de

planning-with-files-de is a skill in OthmanAdi/planning-with-files, last changed 24 Oct 2026. It can add hooks, run shell commands, bundle scripts and pre-approve tools — read the findings before installing. Our pattern check found 1 item to review at commit dcdfb27 on 26 Oct 2026.

Pattern check: 1 item to review · commit dcdfb27 · 26 Oct 2026

Install
From the author
Persistente dateibasierte Planung für mehrstufige Arbeit mit KI-Agenten. Hält task_plan.md, findings.md und progress.md auf dem Datenträger; Lebenszyklus-Hooks speisen ausgewählten Planungskontext des Projekts ein. Die automatische Wiederherstellung liest nur die Planungsdateien des Projekts. Nur ein ausdrücklicher Aufruf von session-catchup.py --metadata darf lokale Sitzungsmetadaten desselben Projekts prüfen; --replay darf begrenzte, nonce-gerahmte Auszüge ausgeben. Der optionale Gate-Modus kann nur bei Unterstützung durch den Host eine Fortsetzung anfordern und führt niemals in Markdown angegebene Befehle aus. Der Skill hat keinen Netzwerk-Uploadpfad. Verwenden für Forschung oder Arbeit mit mehr als 5 Tool-Aufrufen.
Licence
MIT
Repo stars
27.7k
Folder last changed
24 Oct 2026 (opens in a new tab)
Publisher
OthmanAdi
Files
26 files
Checked
dcdfb27 (opens in a new tab) · 26 Oct 2026

Install

Each tab says whether it installs commit dcdfb27, the one we checked, or the latest version.

No tab for your agent? Use Any agent for OpenCode, Goose, Windsurf (Devin Desktop), Zed, Roo Code, Factory Droid, Junie, Amp and Antigravity, and Claude Code for Cline. Kiro needs the folder copied by hand.

Pinned to commit dcdfb27, the one we checked.

From your project's root folder:

tmp="$(mktemp -d)" &&
  git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/OthmanAdi/planning-with-files.git "$tmp" &&
  git -C "$tmp" fetch -q --depth 1 origin dcdfb278de53fdb69b2067ea173dbb1de45345a3 &&
  git -C "$tmp" sparse-checkout set -- skills/i18n/planning-with-files-de &&
  git -C "$tmp" checkout -q dcdfb278de53fdb69b2067ea173dbb1de45345a3 &&
  mkdir -p .claude/skills &&
  mkdir .claude/skills/planning-with-files-de &&
  cp -R "$tmp"/skills/i18n/planning-with-files-de/. .claude/skills/planning-with-files-de/ &&
  rm -rf "$tmp"

If Claude Code was already running and this created the skills folder, run /reload-skills.

Claude Code docs (opens in a new tab)

What it can touch

From the files and frontmatter at commit dcdfb27. This is how much a skill can do, not whether it is risky.

What it can touch: Shell, network or credentials

  • Runs shell commands

    Its instructions or files give the agent commands to run on your computer.

  • Bundles scripts

    The folder holds code files the agent may run.

    scripts/ledger-append.ps1 · scripts/ledger-append.sh · scripts/phase-status.ps1 and 1 more

  • Pre-approves tools

    Its allowed-tools field lists tools the agent may use without asking you first, in agents that honour it.

    SKILL.md:5

  • Adds hooks

    Its frontmatter registers commands that run automatically on agent events for the rest of the session.

    SKILL.md:6

Pattern check

Pattern check: 1 item to review · commit dcdfb27 · 26 Oct 2026

We checked every text file in this skill, at commit dcdfb27 on 26 Oct 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.

How the check worksReport an incorrect finding

Format check

Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.

  • Agent Skills specPasses with warnings

    The open format from agentskills.io, held to what the strictest agents enforce, so one folder loads everywhere.

    • Warning

      Fields outside the spec: user-invocable (read by Claude Code and VS Code) and hooks (read by Claude Code). Uploads to the Claude apps and API, and the spec's validator, reject the file; most agents ignore these fields. O1

      Fix: Delete them for a portable skill, or keep them if you only target the agents that read them.

    • Note

      The description doesn't say when to use the skill. D6

      Fix: Add a sentence such as "Use when …" naming the requests or files that should trigger it.

    • Note

      There is no license field, so readers can't tell whether they may reuse the skill. O2

      Fix: Add license: with an SPDX name such as MIT or Apache-2.0, or the name of a bundled licence file.

  • Claude CodePasses
  • Claude apps & API uploadFails

    Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.

    • Error

      Upload and packaging fail on fields outside the spec: user-invocable and hooks. O1

      Fix: Delete them, and keep your own data under metadata as text values.

    • Note

      The description is 728 characters. The claude.ai Help Center says 200 at most, though Anthropic's API docs and validator allow 1,024. D4

      Fix: If the claude.ai upload refuses it, trim the description to 200 characters.

  • OpenAI (Codex & API)Passes with warnings

    Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.

    • Warning

      Fields outside the spec: user-invocable and hooks. Codex ignores them; OpenAI doesn't say whether its upload accepts them. O1

      Fix: Delete them, or move your own data under metadata as text values.

  • VS Code & CopilotPasses

    VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.

    • Note

      VS Code ignores fields it doesn't support: hooks. O1

      Fix: Delete them unless another agent you target reads them.

SKILL.md

Files

26 files

PathSize
SKILL.md (opens in a new tab)15.5 KB
scripts/attest-plan.ps1 (opens in a new tab)21.1 KB
scripts/attest-plan.sh (opens in a new tab)13.3 KB
scripts/check-complete.ps1 (opens in a new tab)3.6 KB
scripts/check-complete.sh (opens in a new tab)4 KB
scripts/gate-stop.sh (opens in a new tab)1.4 KB
scripts/init-session.ps1 (opens in a new tab)3.4 KB
scripts/init-session.sh (opens in a new tab)3.2 KB
scripts/inject-plan.py (opens in a new tab)65.1 KB
scripts/inject-plan.sh (opens in a new tab)61.6 KB
scripts/ledger-append.ps1 (opens in a new tab)6.7 KB
scripts/ledger-append.sh (opens in a new tab)11.9 KB
scripts/ledger-summary.ps1 (opens in a new tab)5.2 KB
scripts/ledger-summary.sh (opens in a new tab)6.5 KB
scripts/phase-status.ps1 (opens in a new tab)10.2 KB
scripts/phase-status.sh (opens in a new tab)7.4 KB
scripts/plan-doctor.sh (opens in a new tab)9 KB
scripts/resolve-plan-dir.ps1 (opens in a new tab)10.8 KB
scripts/resolve-plan-dir.sh (opens in a new tab)15.3 KB
scripts/session-catchup.py (opens in a new tab)26.1 KB
Show 6 more
PathSize
scripts/set-active-plan.ps1 (opens in a new tab)17.9 KB
scripts/set-active-plan.sh (opens in a new tab)15.5 KB
scripts/skill-hook.sh (opens in a new tab)18.6 KB
templates/findings.md (opens in a new tab)1.5 KB
templates/progress.md (opens in a new tab)2.1 KB
templates/task_plan.md (opens in a new tab)2.7 KB

More from OthmanAdi/planning-with-files

  • planning-with-files

    OthmanAdi/planning-with-files

    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 declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls.

    Pattern check: Items to reviewWhat it can touch: Adds hooks · Runs shell commands +3

    MIT · 27.7k repo stars · Updated 24 Oct 2026

  • planning-with-files-ar

    OthmanAdi/planning-with-files

    تخطيط مستمر قائم على الملفات لعمل وكلاء الذكاء الاصطناعي متعدد الخطوات. يحتفظ بملفات task_plan.md و findings.md و progress.md على القرص، وتحقن خطافات دورة الحياة سياق التخطيط المحدد للمشروع. تقرأ الاستعادة التلقائية ملفات تخطيط المشروع فقط. يمكن للأمر الصريح session-catchup.py --metadata فحص بيانات وصفية لجلسات الوكيل المحلية التابعة للمشروع نفسه، بينما قد يصدر --replay مقتطفات محدودة مؤطرة بقيمة nonce. يمكن للوضع المحكوم الاختياري طلب المتابعة فقط عندما يدعمه المضيف، ولا ينفذ أبدًا أوامر معلنة في Markdown. لا تتضمن المهارة مسارًا لرفع البيانات عبر الشبكة. تُستخدم للبحث أو العمل الذي يحتاج إلى 5 استدعاءات أدوات أو أكثر.

    Pattern check: Items to reviewWhat it can touch: Adds hooks · Runs shell commands +2

    MIT · 27.7k repo stars · Updated 24 Oct 2026

  • planning-with-files-es

    OthmanAdi/planning-with-files

    Planificación persistente basada en archivos para tareas multipaso de agentes de IA. Mantiene task_plan.md, findings.md y progress.md en disco; los hooks del ciclo de vida inyectan contexto seleccionado de planificación del proyecto. La recuperación automática solo lee los archivos de planificación del proyecto. session-catchup.py --metadata, solicitado de forma explícita, puede inspeccionar metadatos locales de sesiones del mismo proyecto; --replay puede emitir extractos limitados y enmarcados con nonce. El modo con gate opcional solo puede solicitar que el host continúe si este lo admite y nunca ejecuta comandos declarados en Markdown. El skill no tiene ninguna ruta de carga por red. Úsalo para investigación o trabajo que requiera 5 o más llamadas a herramientas.

    Pattern check: Items to reviewWhat it can touch: Adds hooks · Runs shell commands +2

    MIT · 27.7k repo stars · Updated 24 Oct 2026

  • planning-with-files-zh

    OthmanAdi/planning-with-files

    用于多步骤 AI 代理工作的持久化文件规划系统。将 task_plan.md、findings.md 和 progress.md 保存在磁盘上，生命周期钩子会注入选定的项目规划上下文。自动恢复只读取项目规划文件。只有显式运行 session-catchup.py --metadata 才会检查本机同项目的会话元数据；--replay 可输出有长度限制且由 nonce 框定的同项目摘录。可选门禁仅在宿主支持时请求继续，绝不执行 Markdown 中声明的命令。本技能没有网络上传路径。适用于研究或需要 5 次以上工具调用的工作。触发词：任务规划、项目计划、制定计划、分解任务、多步骤规划、进度跟踪、文件规划、帮我规划、拆解项目

    Pattern check: Items to reviewWhat it can touch: Adds hooks · Runs shell commands +2

    MIT · 27.7k repo stars · Updated 24 Oct 2026

  • planning-with-files-zht

    OthmanAdi/planning-with-files

    用於多步驟 AI 代理工作的持久化檔案規劃。將 task_plan.md、findings.md 與 progress.md 保存在磁碟上，生命週期鉤子會注入選定的專案規劃內容。自動恢復只讀取專案規劃檔案；只有明確執行 session-catchup.py --metadata 才會檢查本機同一專案的代理工作階段中繼資料，--replay 則會輸出有界且以 nonce 框定的摘錄。選用的閘門模式只會在主機支援時要求繼續，而且絕不執行 Markdown 中宣告的命令。此技能沒有網路上傳路徑。適用於研究或需要超過 5 次工具呼叫的工作。觸發詞：任務規劃、專案計畫、制定計畫、分解任務、多步驟規劃、進度追蹤、檔案規劃、幫我規劃、拆解專案

    Pattern check: Items to reviewWhat it can touch: Adds hooks · Runs shell commands +2

    MIT · 27.7k repo stars · Updated 24 Oct 2026