[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72TYEC2RDKYAGAF9BV8C7HH":3,"skill-same:01M72TYEC2RDKYAGAF9BV8C7HH":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M72TYEC2RDKYAGAF9BV8C7HH","refresh-catalog",null,"Manually regenerate the dispatch catalog from skill sidecars and agent frontmatter. Trigger this skill whenever the user types \u002Frefresh-catalog, says \"regenerate catalog\", \"refresh dispatch catalog\", \"rebuild catalog\", \"update the catalog\", or any similar request to force a fresh dispatch catalog build outside of the automatic SessionStart or mtime-check paths.","glitchwerks\u002Fclaude-wayfinder","glitchwerks","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F280158622?v=4","01M72TXS0Q6NRNKZYFQ4KFG1VJ","01M72TXS18Q7XJ6RNHV7K0D9XF",4,"MIT","https:\u002F\u002Fgithub.com\u002Fglitchwerks\u002Fclaude-wayfinder\u002Fblob\u002Fmain\u002Fskills\u002Frefresh-catalog\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: refresh-catalog\ndescription: >\n  Manually regenerate the dispatch catalog from skill sidecars and agent\n  frontmatter. Trigger this skill whenever the user types \u002Frefresh-catalog,\n  says \"regenerate catalog\", \"refresh dispatch catalog\", \"rebuild catalog\",\n  \"update the catalog\", or any similar request to force a fresh dispatch\n  catalog build outside of the automatic SessionStart or mtime-check paths.\n---\n\n# \u002Frefresh-catalog\n\nForce a fresh regeneration of the dispatch catalog and report the results.\n\n## When to use this skill\n\nThe bundled `refresh-catalog-on-stale.js` hook (see [Bundled hooks](..\u002F..\u002Fdocs\u002Fintegration.md#bundled-hooks)) automatically rebuilds the catalog when a source file (skill sidecar or agent frontmatter) is newer than the catalog itself. This skill exists for cases the mtime heuristic misses or when you want to force a rebuild for debugging:\n\n- A sidecar edit did not bump a watched path's mtime.\n- You edited the catalog directly and want to overwrite with a clean rebuild.\n- You are diagnosing a `[CATALOG ERROR]` or `[CATALOG STALE]` banner.\n\n## Step 1: Record the catalog mtime before regeneration\n\nRead the mtime of the catalog before running the generator. The catalog path is resolved from `$DISPATCH_CATALOG_PATH` if set, otherwise the documented default `~\u002F.claude\u002Fdispatch-catalog.json`. If the file does not exist, note \"catalog absent before run\".\n\n```bash\npython -c \"\nimport os, datetime\np = os.environ.get('DISPATCH_CATALOG_PATH') or os.path.expanduser('~\u002F.claude\u002Fdispatch-catalog.json')\nif os.path.exists(p):\n    t = os.path.getmtime(p)\n    print(datetime.datetime.fromtimestamp(t).isoformat(timespec='seconds'))\nelse:\n    print('absent')\n\"\n```\n\n## Step 2: Run the catalog generator\n\nInvoke `claude-wayfinder catalog build` with the consumer's source directories. The default layout follows Claude Code's standard `~\u002F.claude\u002F` tree; adjust the flags if your project uses non-standard paths.\n\n```bash\nclaude-wayfinder catalog build \\\n  --skills-dir ~\u002F.claude\u002Fskills \\\n  --agents-dir ~\u002F.claude\u002Fagents \\\n  --plugin-overrides-dir ~\u002F.claude\u002Ftriggers \\\n  --plugins-dir ~\u002F.claude\u002Fplugins \\\n  --builtin-agents-dir ~\u002F.claude\u002Ftriggers\u002Fbuiltin \\\n  --out \"${DISPATCH_CATALOG_PATH:-$HOME\u002F.claude\u002Fdispatch-catalog.json}\" \\\n  --log ~\u002F.claude\u002Fdispatch-catalog-build.log\n```\n\nCapture both stdout and stderr. Record the exit code.\n\n- **Exit 0** — clean generation.\n- **Exit 1** — fatal error; the catalog may not have been written.\n- **Exit 2** — degraded catalog; a partial file was written but one or more entries were excluded due to validation issues.\n\nIf the generator exits non-zero, surface the error visibly:\n\n> **Catalog generation FAILED (exit {N})**\n>\n> ```\n> {captured stderr}\n> ```\n>\n> Check `~\u002F.claude\u002Fdispatch-catalog-build.log` for per-entry details.\n\n## Step 3: Record the catalog mtime after regeneration\n\nRead the mtime again using the same command as Step 1.\n\n## Step 4: Parse the new catalog\n\nRead the catalog file. The top-level structure is:\n\n```json\n{ \"entries\": [ { \"kind\": \"skill\" | \"agent\", ... }, ... ] }\n```\n\nCount entries by `kind`:\n\n- **skills** — entries where `kind == \"skill\"`\n- **agents** — entries where `kind == \"agent\"`\n\n## Step 5: Check the generation log for warnings\n\nRead `~\u002F.claude\u002Fdispatch-catalog-build.log` and extract any lines containing `warning` or `fatal` (case-insensitive). Show only the lines from the most recent run (lines after the last generator-invocation timestamp that precedes the run).\n\nIf there are no warning\u002Ffatal lines, report \"No warnings or fatal issues.\"\n\n## Step 6: Report\n\nPrint a structured summary:\n\n```\nCatalog regenerated successfully.   ← or \"DEGRADED (exit 2)\" \u002F \"FAILED (exit 1)\"\n\n  Skills:  \u003CN>\n  Agents:  \u003CM>\n  Total:   \u003CN+M>\n\n  Catalog mtime before: \u003CISO timestamp or \"absent\">\n  Catalog mtime after:  \u003CISO timestamp>\n\n  Exclusion warnings (from dispatch-catalog-build.log):\n  \u003Cwarning\u002Ffatal lines, or \"None\">\n```\n\nIf exit code was 2, prepend the summary with a visible banner:\n\n> **WARNING: Catalog is degraded — some entries were excluded due to validation\n> errors. Review the warnings above and fix the affected `triggers.yml` or\n> agent frontmatter files.**\n","# \u002Frefresh-catalog\n\nForce a fresh regeneration of the dispatch catalog and report the results.\n\n## When to use this skill\n\nThe bundled `refresh-catalog-on-stale.js` hook (see [Bundled hooks](..\u002F..\u002Fdocs\u002Fintegration.md#bundled-hooks)) automatically rebuilds the catalog when a source file (skill sidecar or agent frontmatter) is newer than the catalog itself. This skill exists for cases the mtime heuristic misses or when you want to force a rebuild for debugging:\n\n- A sidecar edit did not bump a watched path's mtime.\n- You edited the catalog directly and want to overwrite with a clean rebuild.\n- You are diagnosing a `[CATALOG ERROR]` or `[CATALOG STALE]` banner.\n\n## Step 1: Record the catalog mtime before regeneration\n\nRead the mtime of the catalog before running the generator. The catalog path is resolved from `$DISPATCH_CATALOG_PATH` if set, otherwise the documented default `~\u002F.claude\u002Fdispatch-catalog.json`. If the file does not exist, note \"catalog absent before run\".\n\n```bash\npython -c \"\nimport os, datetime\np = os.environ.get('DISPATCH_CATALOG_PATH') or os.path.expanduser('~\u002F.claude\u002Fdispatch-catalog.json')\nif os.path.exists(p):\n    t = os.path.getmtime(p)\n    print(datetime.datetime.fromtimestamp(t).isoformat(timespec='seconds'))\nelse:\n    print('absent')\n\"\n```\n\n## Step 2: Run the catalog generator\n\nInvoke `claude-wayfinder catalog build` with the consumer's source directories. The default layout follows Claude Code's standard `~\u002F.claude\u002F` tree; adjust the flags if your project uses non-standard paths.\n\n```bash\nclaude-wayfinder catalog build \\\n  --skills-dir ~\u002F.claude\u002Fskills \\\n  --agents-dir ~\u002F.claude\u002Fagents \\\n  --plugin-overrides-dir ~\u002F.claude\u002Ftriggers \\\n  --plugins-dir ~\u002F.claude\u002Fplugins \\\n  --builtin-agents-dir ~\u002F.claude\u002Ftriggers\u002Fbuiltin \\\n  --out \"${DISPATCH_CATALOG_PATH:-$HOME\u002F.claude\u002Fdispatch-catalog.json}\" \\\n  --log ~\u002F.claude\u002Fdispatch-catalog-build.log\n```\n\nCapture both stdout and stderr. Record the exit code.\n\n- **Exit 0** — clean generation.\n- **Exit 1** — fatal error; the catalog may not have been written.\n- **Exit 2** — degraded catalog; a partial file was written but one or more entries were excluded due to validation issues.\n\nIf the generator exits non-zero, surface the error visibly:\n\n> **Catalog generation FAILED (exit {N})**\n>\n> ```\n> {captured stderr}\n> ```\n>\n> Check `~\u002F.claude\u002Fdispatch-catalog-build.log` for per-entry details.\n\n## Step 3: Record the catalog mtime after regeneration\n\nRead the mtime again using the same command as Step 1.\n\n## Step 4: Parse the new catalog\n\nRead the catalog file. The top-level structure is:\n\n```json\n{ \"entries\": [ { \"kind\": \"skill\" | \"agent\", ... }, ... ] }\n```\n\nCount entries by `kind`:\n\n- **skills** — entries where `kind == \"skill\"`\n- **agents** — entries where `kind == \"agent\"`\n\n## Step 5: Check the generation log for warnings\n\nRead `~\u002F.claude\u002Fdispatch-catalog-build.log` and extract any lines containing `warning` or `fatal` (case-insensitive). Show only the lines from the most recent run (lines after the last generator-invocation timestamp that precedes the run).\n\nIf there are no warning\u002Ffatal lines, report \"No warnings or fatal issues.\"\n\n## Step 6: Report\n\nPrint a structured summary:\n\n```\nCatalog regenerated successfully.   ← or \"DEGRADED (exit 2)\" \u002F \"FAILED (exit 1)\"\n\n  Skills:  \u003CN>\n  Agents:  \u003CM>\n  Total:   \u003CN+M>\n\n  Catalog mtime before: \u003CISO timestamp or \"absent\">\n  Catalog mtime after:  \u003CISO timestamp>\n\n  Exclusion warnings (from dispatch-catalog-build.log):\n  \u003Cwarning\u002Ffatal lines, or \"None\">\n```\n\nIf exit code was 2, prepend the summary with a visible banner:\n\n> **WARNING: Catalog is degraded — some entries were excluded due to validation\n> errors. Review the warnings above and fix the affected `triggers.yml` or\n> agent frontmatter files.**\n",{"name":5,"description":7},"main","e906955a5bf962247a87d755ae63495538ce36b5","skills\u002Frefresh-catalog",1,"https:\u002F\u002Fgithub.com\u002Fglitchwerks\u002Fclaude-wayfinder","https:\u002F\u002Fpypi.org\u002Fproject\u002Fclaude-wayfinder\u002F","https:\u002F\u002Fgithub.com\u002Fglitchwerks","2026-11-14 06:56:04",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add glitchwerks\u002Fclaude-wayfinder --skill refresh-catalog",{"tool":37,"command":38},"bunx","bunx skills add glitchwerks\u002Fclaude-wayfinder --skill refresh-catalog",{"tool":40,"command":41},"pnpm","pnpm dlx skills add glitchwerks\u002Fclaude-wayfinder --skill refresh-catalog","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fglitchwerks\u002Fclaude-wayfinder\u002Fblob\u002Fmain\u002Fskills\u002Frefresh-catalog\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"triggers.yml","REFERENCE","参考文档",354,"https:\u002F\u002Fgithub.com\u002Fglitchwerks\u002Fclaude-wayfinder\u002Fblob\u002Fmain\u002Fskills\u002Frefresh-catalog\u002Ftriggers.yml",[52,59,66,73,79,86],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":18},"01M72V35HRZHT8N6NZWAGY4CDS","refactoring-discipline","Behavior-preserving refactoring discipline. Activates when the task involves restructuring, extracting, or renaming existing code without adding new behavior.","https:\u002F\u002Fgithub.com\u002Fglitchwerks\u002Fclaude-wayfinder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Frefactoring-discipline\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":18},"01M72V33XS39XGHFYH5RM0HSW3","legacy","Pre-migration skill.","https:\u002F\u002Fgithub.com\u002Fglitchwerks\u002Fclaude-wayfinder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Flegacy\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":18},"01M72V289JXSDJBQK1GW5RCJAP","csv-utils","Helpers for reading and writing CSV files in Python.","https:\u002F\u002Fgithub.com\u002Fglitchwerks\u002Fclaude-wayfinder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fcsv-utils\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":18},"01M72V1GJFXNZ8CVZZG8T66E3G","broken","https:\u002F\u002Fgithub.com\u002Fglitchwerks\u002Fclaude-wayfinder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fbroken\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M72V0SWXW4XJE2EWCZWM5EDP","agent-authoring","Expert guidance for writing, editing, and debugging agent and skill frontmatter, CLAUDE.md harness rules, and SKILL.md files.","https:\u002F\u002Fgithub.com\u002Fglitchwerks\u002Fclaude-wayfinder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fagent-authoring\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":18},"01M72V00NQ401XMPQZV0PH01J3","setup-wayfinder","Materialize the claude-wayfinder Python venv at ${CLAUDE_PLUGIN_DATA}\u002Fvenv\u002F\nand write the setup-state flag. Use when:\n- User types \u002Fsetup-wayfinder\n- User says \"set up claude-wayfinder\", \"install wayfinder dependencies\"\n- User says \"wayfinder isn't working\", \"fix wayfinder\", \"repair wayfinder\"\n- SessionStart banner indicates setup is required and the user wants to proceed\n- Plugin version bumped and re-setup needed\nDo NOT trigger on casual mentions of \"wayfinder\" without setup\u002Finstall\u002Ffix intent.","https:\u002F\u002Fgithub.com\u002Fglitchwerks\u002Fclaude-wayfinder\u002Fblob\u002Fmain\u002Fskills\u002Fsetup-wayfinder\u002FSKILL.md",[],[]]