[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CC660BGP411G3TY3G498EX":3,"skill-same:01M6CC660BGP411G3TY3G498EX":66},{"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":30,"linkOnly":31,"markdownContent":32,"markdownBody":33,"frontMatter":34,"refName":35,"commitSha":36,"skillDirectory":37,"forksCount":38,"repositoryHtmlUrl":39,"repositoryHomepageUrl":6,"ownerHtmlUrl":40,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":41,"install":42,"resources":55},"01M6CC660BGP411G3TY3G498EX","chezmoi-troubleshooting",null,"This skill should be used when the user encounters chezmoi failures, state issues, or configuration problems, such as when chezmoi doctor shows errors, scripts don't run as expected, chezmoi verify fails, chezmoi diff shows unexpected changes, state needs resetting, or merge conflicts occur in chezmoi source.","ray-manaloto\u002Fmacos-development-environment","ray-manaloto","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F227192835?v=4","01M6CBR7J13ZA01X5YB1A1QRJP","01M6CBR7P0S3NS8ZV81JYNST14",1,"MIT","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-troubleshooting\u002FSKILL.md",[],[18,19,20,21,22,23,24,25,26,27,28,29],"chezmoi","troubleshooting","chezmoi troubleshooting","merge","run","doctor","state","issues","verify","user","diff","merge conflicts","2026-11-10 10:12:30",false,"---\nname: chezmoi-troubleshooting\ndescription: This skill should be used when the user encounters chezmoi failures, state issues, or configuration problems, such as when chezmoi doctor shows errors, scripts don't run as expected, chezmoi verify fails, chezmoi diff shows unexpected changes, state needs resetting, or merge conflicts occur in chezmoi source.\n---\n\n# Chezmoi Troubleshooting\n\nSystematic diagnostic workflows for chezmoi failures, state corruption, drift, and configuration problems.\n\n## Safety Constraints\n\n**SAFE operations only — never modify the system without user approval:**\n- `chezmoi doctor` — Full diagnostic\n- `chezmoi state dump` — View script execution state\n- `chezmoi diff` — Preview what would change\n- `chezmoi verify` — Check files match source\n- `chezmoi execute-template` — Preview template output\n- `chezmoi data` — View template variables\n\n**FORBIDDEN without explicit approval:** `chezmoi apply`, `chezmoi update`\n\n## 1. Doctor Interpretation\n\nRun `chezmoi doctor` and interpret the output:\n\n| Check | Expected | Failure Meaning | Fix |\n|-------|----------|-----------------|-----|\n| version | latest | Outdated chezmoi | `brew upgrade chezmoi` |\n| config-file | found path | Config missing | `chezmoi init` or create manually |\n| source-dir | git working tree (clean) | Source dirty or not git | `chezmoi cd && git status` |\n| git-command | found path | Git not in PATH | Install git via mise\u002Fbrew |\n| edit-command | found path | Editor not configured | Set `$EDITOR` or configure in chezmoi.toml |\n| 1password | found path (optional) | op CLI missing | Only needed if using 1Password templates |\n| age | found path (optional) | age not installed | Only needed if using age encryption |\n| gpg | found path (optional) | gpg not found | Only needed if using GPG encryption |\n\n**Filter for problems only:**\n```bash\nchezmoi doctor | grep -v \"^ok\"\n```\n\n**Color codes:** `ok` = green (pass), `warning` = yellow (optional), `error` = red (must fix)\n\n## 2. State Management\n\nChezmoi tracks script execution in two state buckets:\n\n| Bucket | Controls | When to Reset |\n|--------|----------|---------------|\n| `scriptState` | `run_once_*` scripts | Script was fixed after failed first run |\n| `entryState` | `run_onchange_*` scripts | Script content hash mismatch |\n\n**View current state:**\n```bash\nchezmoi state dump\n```\n\n**Reset run_once state** (scripts will re-run on next apply):\n```bash\nchezmoi state delete-bucket --bucket=scriptState\n```\n\n**Reset run_onchange state** (both run_once and run_onchange are in scriptState):\n```bash\nchezmoi state delete-bucket --bucket=scriptState\n```\nNote: `entryState` tracks managed FILE state, not scripts. Deleting `entryState`\nwould force a full re-apply of all managed files — use with extreme caution.\n\n### Common State Issues\n\n**run_once script doesn't run:**\n1. Check if already executed: `chezmoi state dump | grep script_name`\n2. If state exists but script was fixed: reset scriptState bucket\n3. If template condition blocks it: `chezmoi execute-template \u003C script.sh.tmpl`\n\n**run_onchange runs every time:**\n1. Check for non-deterministic template output (timestamps, random values)\n2. Verify data inputs are stable: `chezmoi data`\n3. Reset entryState and re-apply\n\n## 3. Diff Debugging\n\n**Interpret diff output:**\n```bash\nchezmoi diff                          # All changes\nchezmoi diff ~\u002F.zshrc                 # Single file\nchezmoi diff --exclude=scripts        # Skip scripts\nchezmoi diff --include=files          # Files only\n```\n\n**Unexpected changes — common causes:**\n\n| Symptom | Cause | Debug Command |\n|---------|-------|---------------|\n| Template renders wrong | Syntax error | `chezmoi execute-template \u003C file.tmpl` |\n| Wrong variable value | Data mismatch | `chezmoi data \\| grep variable_name` |\n| File appears modified | Local manual edit (drift) | `chezmoi verify` to confirm |\n| Permission changes | Mode mismatch | Check source file prefix (`executable_`, `private_`) |\n\n**Debug template expansion:**\n```bash\n# Preview what a template would render to\nchezmoi execute-template \u003C \"$(chezmoi source-path)\u002Fdot_zshrc.tmpl\"\n\n# Compare with deployed file\ndiff \u003C(chezmoi execute-template \u003C \"$(chezmoi source-path)\u002Fdot_zshrc.tmpl\") ~\u002F.zshrc\n```\n\n## 4. Merge Conflict Resolution\n\n```bash\nchezmoi cd                            # Enter source directory\ngit status                            # See conflicted files\ngit diff                              # Review conflicts\n# Manually edit conflicted files\ngit add \u003Cresolved-files>\ngit commit -m \"Resolve merge conflict\"\n# Then: chezmoi diff to verify, chezmoi apply to deploy\n```\n\n## 5. Version Compatibility\n\n**Enforce minimum version** with `.chezmoiversion`:\n```\n2.40.0\n```\nPlace in source root. Chezmoi will refuse to operate if version is too old.\n\n## Diagnostic Flowchart\n\n1. Start: `chezmoi doctor` — any errors? Fix those first\n2. Then: `chezmoi verify` — any drift? Review with `chezmoi diff`\n3. Then: `chezmoi state dump` — any stuck scripts? Reset relevant bucket\n4. Then: `chezmoi execute-template` — template rendering correctly?\n5. Still broken? Check `chezmoi data` for variable issues\n\n## Related Skills\n\n- **chezmoi-config** — Template syntax and configuration reference\n- **chezmoi-workflows** — Daily operations (prerequisite understanding)\n- **chezmoi-migration** — Setup issues on new machines\n- **chezmoi-advanced-config** — Encryption, git automation issues\n","# Chezmoi Troubleshooting\n\nSystematic diagnostic workflows for chezmoi failures, state corruption, drift, and configuration problems.\n\n## Safety Constraints\n\n**SAFE operations only — never modify the system without user approval:**\n- `chezmoi doctor` — Full diagnostic\n- `chezmoi state dump` — View script execution state\n- `chezmoi diff` — Preview what would change\n- `chezmoi verify` — Check files match source\n- `chezmoi execute-template` — Preview template output\n- `chezmoi data` — View template variables\n\n**FORBIDDEN without explicit approval:** `chezmoi apply`, `chezmoi update`\n\n## 1. Doctor Interpretation\n\nRun `chezmoi doctor` and interpret the output:\n\n| Check | Expected | Failure Meaning | Fix |\n|-------|----------|-----------------|-----|\n| version | latest | Outdated chezmoi | `brew upgrade chezmoi` |\n| config-file | found path | Config missing | `chezmoi init` or create manually |\n| source-dir | git working tree (clean) | Source dirty or not git | `chezmoi cd && git status` |\n| git-command | found path | Git not in PATH | Install git via mise\u002Fbrew |\n| edit-command | found path | Editor not configured | Set `$EDITOR` or configure in chezmoi.toml |\n| 1password | found path (optional) | op CLI missing | Only needed if using 1Password templates |\n| age | found path (optional) | age not installed | Only needed if using age encryption |\n| gpg | found path (optional) | gpg not found | Only needed if using GPG encryption |\n\n**Filter for problems only:**\n```bash\nchezmoi doctor | grep -v \"^ok\"\n```\n\n**Color codes:** `ok` = green (pass), `warning` = yellow (optional), `error` = red (must fix)\n\n## 2. State Management\n\nChezmoi tracks script execution in two state buckets:\n\n| Bucket | Controls | When to Reset |\n|--------|----------|---------------|\n| `scriptState` | `run_once_*` scripts | Script was fixed after failed first run |\n| `entryState` | `run_onchange_*` scripts | Script content hash mismatch |\n\n**View current state:**\n```bash\nchezmoi state dump\n```\n\n**Reset run_once state** (scripts will re-run on next apply):\n```bash\nchezmoi state delete-bucket --bucket=scriptState\n```\n\n**Reset run_onchange state** (both run_once and run_onchange are in scriptState):\n```bash\nchezmoi state delete-bucket --bucket=scriptState\n```\nNote: `entryState` tracks managed FILE state, not scripts. Deleting `entryState`\nwould force a full re-apply of all managed files — use with extreme caution.\n\n### Common State Issues\n\n**run_once script doesn't run:**\n1. Check if already executed: `chezmoi state dump | grep script_name`\n2. If state exists but script was fixed: reset scriptState bucket\n3. If template condition blocks it: `chezmoi execute-template \u003C script.sh.tmpl`\n\n**run_onchange runs every time:**\n1. Check for non-deterministic template output (timestamps, random values)\n2. Verify data inputs are stable: `chezmoi data`\n3. Reset entryState and re-apply\n\n## 3. Diff Debugging\n\n**Interpret diff output:**\n```bash\nchezmoi diff                          # All changes\nchezmoi diff ~\u002F.zshrc                 # Single file\nchezmoi diff --exclude=scripts        # Skip scripts\nchezmoi diff --include=files          # Files only\n```\n\n**Unexpected changes — common causes:**\n\n| Symptom | Cause | Debug Command |\n|---------|-------|---------------|\n| Template renders wrong | Syntax error | `chezmoi execute-template \u003C file.tmpl` |\n| Wrong variable value | Data mismatch | `chezmoi data \\| grep variable_name` |\n| File appears modified | Local manual edit (drift) | `chezmoi verify` to confirm |\n| Permission changes | Mode mismatch | Check source file prefix (`executable_`, `private_`) |\n\n**Debug template expansion:**\n```bash\n# Preview what a template would render to\nchezmoi execute-template \u003C \"$(chezmoi source-path)\u002Fdot_zshrc.tmpl\"\n\n# Compare with deployed file\ndiff \u003C(chezmoi execute-template \u003C \"$(chezmoi source-path)\u002Fdot_zshrc.tmpl\") ~\u002F.zshrc\n```\n\n## 4. Merge Conflict Resolution\n\n```bash\nchezmoi cd                            # Enter source directory\ngit status                            # See conflicted files\ngit diff                              # Review conflicts\n# Manually edit conflicted files\ngit add \u003Cresolved-files>\ngit commit -m \"Resolve merge conflict\"\n# Then: chezmoi diff to verify, chezmoi apply to deploy\n```\n\n## 5. Version Compatibility\n\n**Enforce minimum version** with `.chezmoiversion`:\n```\n2.40.0\n```\nPlace in source root. Chezmoi will refuse to operate if version is too old.\n\n## Diagnostic Flowchart\n\n1. Start: `chezmoi doctor` — any errors? Fix those first\n2. Then: `chezmoi verify` — any drift? Review with `chezmoi diff`\n3. Then: `chezmoi state dump` — any stuck scripts? Reset relevant bucket\n4. Then: `chezmoi execute-template` — template rendering correctly?\n5. Still broken? Check `chezmoi data` for variable issues\n\n## Related Skills\n\n- **chezmoi-config** — Template syntax and configuration reference\n- **chezmoi-workflows** — Daily operations (prerequisite understanding)\n- **chezmoi-migration** — Setup issues on new machines\n- **chezmoi-advanced-config** — Encryption, git automation issues\n",{"name":5,"description":7},"main","716b17df3ef6719d88aeac180015008b7ddfff6f","rsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-troubleshooting",0,"https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment","https:\u002F\u002Fgithub.com\u002Fray-manaloto","2026-08-03 16:55:50",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add ray-manaloto\u002Fmacos-development-environment --skill chezmoi-troubleshooting",{"tool":48,"command":49},"bunx","bunx skills add ray-manaloto\u002Fmacos-development-environment --skill chezmoi-troubleshooting",{"tool":51,"command":52},"pnpm","pnpm dlx skills add ray-manaloto\u002Fmacos-development-environment --skill chezmoi-troubleshooting","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-troubleshooting\u002FSKILL.md",true,[56,62],{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"SOURCE.md","REFERENCE","参考文档",191,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Fmev-guard\u002FSOURCE.md",{"path":63,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":64,"sourceHtmlUrl":65},"TRUST.auto.yaml",2217,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Fmev-guard\u002FTRUST.auto.yaml",[67,89,107,125,145,159],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":78,"publishedAt":30},"01M6CC8DXNJ39YWERYTWCGGCGG","next-workflow-step","Use this skill when the user wants to transition to the next workflow step, wrap up a session cleanly, prepare a handoff, or says things like \"next step\", \"continue the workflow\", \"wrap up\", \"hand off\", \"move to the next phase\", \"what's next in embrace\", or \"prepare for \u002Fclear\". Also triggers when the current octo:embrace phase appears complete and no explicit next action is set.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fworkflow-toolkit\u002Fskills\u002Fnext-workflow-step\u002FSKILL.md",[73],{"categoryNo":74,"categoryName":75,"taxonomyType":76,"taxonomyTypeDesc":77},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[79,80,81,82,83,27,84,85,86,87,88],"next workflow step","workflow","up","use","session","wrap up","continue","handoff","prepare","SET",{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":30},"01M6CC8BRZBQHEBXGMKPDM422P","source-discovery","This skill should be used when the user asks to \"find sources\", \"discover URLs\", \"catalog a source\", \"classify a URL\", \"search for libraries\", \"check what exists\", or mentions source discovery, URL cataloging, source classification, or research source management.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fresearch-review-toolkit\u002Fskills\u002Fsource-discovery\u002FSKILL.md",[],[96,97,98,99,100,101,102,103,104,27,105,106],"discovery","source discovery","research","libraries","search","classification","find","check","management","catalog","find sources",{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":30},"01M6CC89CGJP69A0PS22G2H1FV","review-synthesis","This skill should be used when the user asks to \"summarize review findings\", \"prioritize fixes\", \"rank review issues\", \"combine reviewer feedback\", \"create action items from review\", or mentions review synthesis, finding prioritization, severity ranking, or review result summarization.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fresearch-review-toolkit\u002Fskills\u002Freview-synthesis\u002FSKILL.md",[],[114,115,116,117,118,119,120,27,121,122,123,25,124],"review","review synthesis","Synthesis","prioritize","create action","feedback","reviewer","summarize","prioritization","create","severity",{"skillNo":126,"name":127,"nameZh":6,"description":128,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":129,"categories":130,"keywords":134,"publishedAt":30},"01M6CC872EZ9GRJY0HRCG0RT2M","research-scoring","This skill should be used when the user asks to \"score research\", \"check research quality\", \"evaluate coverage\", \"measure improvement\", \"assess research completeness\", or mentions research scoring, quality metrics, coverage gaps, improvement baseline, or research pipeline status.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fresearch-review-toolkit\u002Fskills\u002Fresearch-scoring\u002FSKILL.md",[131],{"categoryNo":132,"categoryName":133,"taxonomyType":76,"taxonomyTypeDesc":77},"01JBSEEDCAT000000000000021","资料检索与研究",[135,98,136,137,138,139,140,141,103,27,142,143,144],"research scoring","status","coverage gaps","metrics","pipeline","baseline","quality","coverage","pipeline status","research quality",{"skillNo":146,"name":147,"nameZh":6,"description":148,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":149,"categories":150,"keywords":151,"publishedAt":30},"01M6CC852HSDS1FE4EJAT0RHGR","notebooklm-integration","This skill should be used when the user asks to \"ingest into NotebookLM\", \"query NotebookLM\", \"add sources to notebook\", \"cross-source synthesis\", \"check stale sources\", or mentions NotebookLM, notebook integration, source ingestion, or knowledge consolidation.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fresearch-review-toolkit\u002Fskills\u002Fnotebooklm-integration\u002FSKILL.md",[],[152,153,154,155,103,27,156,157,158,116],"notebooklm integration","notebooklm","integration","knowledge","ingestion","ingest","stale",{"skillNo":160,"name":161,"nameZh":6,"description":162,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":163,"categories":164,"keywords":166,"publishedAt":30},"01M6CC82Z4V3205KCJWQZPS2VG","evidence-synthesis","This skill should be used when the user asks to \"synthesize findings\", \"combine research\", \"cross-reference sources\", \"summarize evidence\", \"write a deep review\", or mentions evidence synthesis, finding consolidation, cross-source analysis, or research summarization.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fresearch-review-toolkit\u002Fskills\u002Fevidence-synthesis\u002FSKILL.md",[165],{"categoryNo":132,"categoryName":133,"taxonomyType":76,"taxonomyTypeDesc":77},[167,116,168,121,98,169,170,171,27,172,114],"evidence synthesis","evidence","deep review","analysis","write","reference"]