[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MM6C6M41Z1A0CER417QA20":3,"skill-same:01M6MM6C6M41Z1A0CER417QA20":65},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":36,"linkOnly":37,"markdownContent":38,"markdownBody":39,"frontMatter":40,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":47,"ownerHtmlUrl":48,"ownerBlogUrl":49,"ownerDescription":50,"updatedAt":51,"install":52,"resources":64},"01M6MM6C6M41Z1A0CER417QA20","principle-fix-root-causes",null,"Use for any debugging or bug fix. Repair the earliest point where the system decided wrongly, rather than where the bad state showed up. A guard is a real fix only for a state the system is permitted to reach.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Frequie\u002Fendostack\u002Fskills\u002Fprinciple-fix-root-causes\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35],"principle fix root causes","root","fix","only","point","for","true","bad","repair","bug","up","debugging","use","system","bug fix","guard","state","2026-11-10 10:12:30",false,"---\nname: principle-fix-root-causes\ndescription: Use for any debugging or bug fix. Repair the earliest point where the system decided wrongly, rather than where the bad state showed up. A guard is a real fix only for a state the system is permitted to reach.\ndisable-model-invocation: true\n---\n\n# Fix root causes\n\nLocate the earliest wrong decision the system made and repair it there, rather than at the spot where the damage became visible. Adding a guard counts as a fix only if the state it catches is a legitimate one for the system to be in.\n\n## When it applies\n\nAll debugging and bug-fix work. If several fixes resting on one assumption have already failed, combine this with [principle-attack-the-premise](..\u002Fprinciple-attack-the-premise\u002FSKILL.md).\n\n## What to do\n\n1. Reproduce the failure before changing anything.\n2. Keep asking why until you reach a decision in code that was itself wrong, as opposed to one that followed correctly from an earlier mistake.\n3. When you are stuck, instrument. Read the real error and the real state. Do not guess.\n4. Classify the triggering state. If it is legitimate, the code that failed on it is at fault, and handling it in that code is the right fix. If the state should never occur, testing for it where it showed up only conceals the bug, so follow it back to whatever created it. Be suspicious of guards, retries, swallowed exceptions, clamped values, and discarded state.\n5. When a failure shows up just after restarts, look at persisted state before anything else: serialized sessions, caches, lock files, and configuration on disk.\n6. Fix the pattern: search for all other sites that share the fault and repair each one.\n7. A workaround that needs a long comment to justify itself signals broken code, so change the code instead.\n8. If finding the deciding fact took deep digging, propose a cheap always-on signal (a log line, a metric, an assertion) that would have shown it immediately.\n\nA security example. An agent's file tool crashes on a path containing `..\u002F`. Adding `if \"..\" in path: return` at the crash site looks like a fix, but a path that escapes the workspace should never have reached the tool. The root cause is the boundary that accepted it without resolving and checking it against the workspace root. Fix it there, then search for every other tool that takes a path from model output, because each one has the same traversal hole.\n\n## The failure it prevents\n\nSymptom patches hide evidence and let the fault resurface elsewhere. Unnamed workarounds pile up. A single-instance fix leaves sibling defects in place, and for security bugs those siblings are the next finding.\n\n## Done when\n\nYou traced the failure to a decision the code got wrong, repaired it at that spot, and repaired its siblings as well.\n\nThe [comment-auditor](..\u002F..\u002Fagents\u002Fcomment-auditor.md) agent flags justification comments as evidence of this failure. The [how](..\u002Fhow\u002FSKILL.md) and [why](..\u002Fwhy\u002FSKILL.md) skills help trace a symptom back to its origin.\n\nRelated: [principle-attack-the-premise](..\u002Fprinciple-attack-the-premise\u002FSKILL.md), [principle-prove-it-works](..\u002Fprinciple-prove-it-works\u002FSKILL.md), [principle-boundary-discipline](..\u002Fprinciple-boundary-discipline\u002FSKILL.md).\n","# Fix root causes\n\nLocate the earliest wrong decision the system made and repair it there, rather than at the spot where the damage became visible. Adding a guard counts as a fix only if the state it catches is a legitimate one for the system to be in.\n\n## When it applies\n\nAll debugging and bug-fix work. If several fixes resting on one assumption have already failed, combine this with [principle-attack-the-premise](..\u002Fprinciple-attack-the-premise\u002FSKILL.md).\n\n## What to do\n\n1. Reproduce the failure before changing anything.\n2. Keep asking why until you reach a decision in code that was itself wrong, as opposed to one that followed correctly from an earlier mistake.\n3. When you are stuck, instrument. Read the real error and the real state. Do not guess.\n4. Classify the triggering state. If it is legitimate, the code that failed on it is at fault, and handling it in that code is the right fix. If the state should never occur, testing for it where it showed up only conceals the bug, so follow it back to whatever created it. Be suspicious of guards, retries, swallowed exceptions, clamped values, and discarded state.\n5. When a failure shows up just after restarts, look at persisted state before anything else: serialized sessions, caches, lock files, and configuration on disk.\n6. Fix the pattern: search for all other sites that share the fault and repair each one.\n7. A workaround that needs a long comment to justify itself signals broken code, so change the code instead.\n8. If finding the deciding fact took deep digging, propose a cheap always-on signal (a log line, a metric, an assertion) that would have shown it immediately.\n\nA security example. An agent's file tool crashes on a path containing `..\u002F`. Adding `if \"..\" in path: return` at the crash site looks like a fix, but a path that escapes the workspace should never have reached the tool. The root cause is the boundary that accepted it without resolving and checking it against the workspace root. Fix it there, then search for every other tool that takes a path from model output, because each one has the same traversal hole.\n\n## The failure it prevents\n\nSymptom patches hide evidence and let the fault resurface elsewhere. Unnamed workarounds pile up. A single-instance fix leaves sibling defects in place, and for security bugs those siblings are the next finding.\n\n## Done when\n\nYou traced the failure to a decision the code got wrong, repaired it at that spot, and repaired its siblings as well.\n\nThe [comment-auditor](..\u002F..\u002Fagents\u002Fcomment-auditor.md) agent flags justification comments as evidence of this failure. The [how](..\u002Fhow\u002FSKILL.md) and [why](..\u002Fwhy\u002FSKILL.md) skills help trace a symptom back to its origin.\n\nRelated: [principle-attack-the-premise](..\u002Fprinciple-attack-the-premise\u002FSKILL.md), [principle-prove-it-works](..\u002Fprinciple-prove-it-works\u002FSKILL.md), [principle-boundary-discipline](..\u002Fprinciple-boundary-discipline\u002FSKILL.md).\n",{"name":5,"description":7,"disable-model-invocation":41},true,"main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002Frequie\u002Fendostack\u002Fskills\u002Fprinciple-fix-root-causes",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":41},[54,57,60],{"tool":55,"command":56},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill principle-fix-root-causes",{"tool":58,"command":59},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill principle-fix-root-causes",{"tool":61,"command":62},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill principle-fix-root-causes","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Frequie\u002Fendostack\u002Fskills\u002Fprinciple-fix-root-causes\u002FSKILL.md",[],[66,76,84,92,100,108],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":70,"licenseFileUrl":71,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":75},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":70,"licenseFileUrl":80,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":75},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":70,"licenseFileUrl":88,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":75},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":70,"licenseFileUrl":96,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":75},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":70,"licenseFileUrl":104,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":75},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":70,"licenseFileUrl":112,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":75},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]