{
  "skill": {
    "schema": "skillflux-skill/v1",
    "id": "othmanadi-planning-with-files",
    "name": "planning-with-files",
    "displayName": {
      "en": "Planning with files",
      "zh": "文件化规划"
    },
    "summary": {
      "en": "Keeps task_plan.md, findings.md and progress.md on disk so a long agent task can survive context loss, with hooks that re-inject the plan.",
      "zh": "在磁盘上维护 task_plan.md、findings.md 和 progress.md，让长任务在上下文丢失后仍能继续，并通过钩子重新注入计划。"
    },
    "upstreamDescription": "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.",
    "source": {
      "repo": "https://github.com/OthmanAdi/planning-with-files",
      "path": ".agents/skills/planning-with-files",
      "commitSha": "5d29800bf8b919ca9a88ee7885b90050b5cb64ed",
      "pinnedAt": "2026-10-29"
    },
    "author": {
      "name": "OthmanAdi",
      "url": "https://github.com/OthmanAdi"
    },
    "license": {
      "spdx": "MIT",
      "raw": null,
      "file": "LICENSE"
    },
    "sourceSiteSlug": "github-com-othmanadi-planning-with-files",
    "category": "productivity",
    "tags": [
      "planning",
      "context",
      "hooks"
    ],
    "status": "listed",
    "addedAt": "2026-10-29",
    "updatedAt": "2026-10-29"
  },
  "health": {
    "schema": "skillflux-health/v1",
    "skillId": "othmanadi-planning-with-files",
    "commitSha": "5d29800bf8b919ca9a88ee7885b90050b5cb64ed",
    "checkerVersion": "1.0.0",
    "changedAt": "2026-10-29",
    "resultHash": "b482dc45813e5179e490d96f0ed6e55a17a30025525cd20ff930a6aca2d50734",
    "checks": [
      {
        "id": "skillmd.present",
        "status": "pass",
        "value": true,
        "detail": "SKILL.md found"
      },
      {
        "id": "frontmatter.parse",
        "status": "pass",
        "value": true,
        "detail": "frontmatter parsed"
      },
      {
        "id": "frontmatter.name",
        "status": "pass",
        "value": "planning-with-files",
        "detail": "valid name"
      },
      {
        "id": "frontmatter.nameMatchesDir",
        "status": "pass",
        "value": true,
        "detail": "name matches its directory"
      },
      {
        "id": "frontmatter.description",
        "status": "pass",
        "value": 606,
        "detail": "606 characters"
      },
      {
        "id": "frontmatter.descriptionTrigger",
        "status": "pass",
        "value": true,
        "detail": "states when to use the skill"
      },
      {
        "id": "frontmatter.descriptionVoice",
        "status": "pass",
        "value": true,
        "detail": "third person, no XML"
      },
      {
        "id": "frontmatter.unknownKeys",
        "status": "info",
        "value": null,
        "detail": "none"
      },
      {
        "id": "body.tokensApprox",
        "status": "warn",
        "value": 8756,
        "detail": "large body; consider moving detail into referenced files"
      },
      {
        "id": "body.lines",
        "status": "pass",
        "value": 481,
        "detail": "481 lines"
      },
      {
        "id": "refs.brokenLinks",
        "status": "pass",
        "value": 0,
        "detail": "all relative links resolve"
      },
      {
        "id": "files.inventory",
        "status": "info",
        "value": 32,
        "detail": "32 files, 470223 bytes"
      },
      {
        "id": "files.binary",
        "status": "pass",
        "value": 0,
        "detail": "no executables or archives"
      },
      {
        "id": "scripts.present",
        "status": "info",
        "value": 22,
        "detail": "scripts/attest-plan.ps1, scripts/attest-plan.sh, scripts/check-complete.ps1, scripts/check-complete.sh, scripts/gate-stop.sh"
      },
      {
        "id": "scripts.network",
        "status": "info",
        "value": 0,
        "detail": "no network calls found"
      },
      {
        "id": "scripts.destructive",
        "status": "warn",
        "value": 1,
        "detail": "scripts/inject-plan.sh (rm-rf)"
      },
      {
        "id": "secrets.scan",
        "status": "pass",
        "value": 0,
        "detail": "none found"
      },
      {
        "id": "instructions.risk",
        "status": "pass",
        "value": 0,
        "detail": "none found"
      },
      {
        "id": "license.detected",
        "status": "pass",
        "value": "MIT",
        "detail": "repository license"
      },
      {
        "id": "repo.activity",
        "status": "pass",
        "value": 0,
        "detail": "last changed 0 days before the check"
      },
      {
        "id": "pinned.drift",
        "status": "info",
        "value": 0,
        "detail": "unchanged since the pinned commit"
      }
    ],
    "metrics": {
      "descriptionChars": 606,
      "bodyTokensApprox": 8756,
      "bodyLines": 481,
      "fileCount": 32,
      "totalBytes": 470223,
      "scriptCount": 22,
      "lastCommitAt": "2026-10-28T17:19:23Z",
      "commitsSincePin": 0
    },
    "repo": {
      "stars": 27750,
      "archived": false,
      "checkedAt": "2026-10-29"
    },
    "flags": [
      "destructive-commands",
      "executes-code"
    ]
  },
  "benchmark": null
}
