[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6AD5HFXS8GCHFXSEN89KZT5":3,"skill-same:01M6AD5HFXS8GCHFXSEN89KZT5":78},{"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":23,"publishedAt":35,"linkOnly":36,"markdownContent":37,"markdownBody":38,"frontMatter":39,"refName":40,"commitSha":41,"skillDirectory":42,"forksCount":43,"repositoryHtmlUrl":44,"repositoryHomepageUrl":45,"ownerHtmlUrl":46,"ownerBlogUrl":47,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M6AD5HFXS8GCHFXSEN89KZT5","error-recovery-patterns",null,"Design gh-aw error handling, retry, recovery, and debugging flows.","github\u002Fgh-aw","github","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9919?v=4","01M6AC83DS133TPXFSP1DHNCC6","GitHub","01M6AD3VCZ4WKQSFSRTPN7N9DN",5636,"MIT","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Ferror-recovery-patterns\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[24,25,26,27,28,29,30,31,32,33,34],"error recovery","error recovery patterns","recovery","patterns","error","design","debugging","error handling","gh","flows","retry","2026-11-10 10:12:30",false,"---\nname: error-recovery-patterns\ndescription: Design gh-aw error handling, retry, recovery, and debugging flows.\n---\n\n# Error Recovery Patterns Skill\n\nUse this skill for error handling, recovery strategies, and debugging in gh-aw.\n\n## Purpose\n\nImplement robust recovery patterns to:\n- Reduce retry loops in agent sessions (target: \u003C10% vs current 23%)\n- Implement circuit breakers to prevent infinite retry loops\n- Add proactive recovery for installation, dependency, and API failures\n- Improve debug logging for recovery attempts\n\n## When to Use This Skill\n\nUse this skill when:\n- Implementing retry logic for network operations, installations, or API calls\n- Debugging retry loop issues in workflows or agent sessions\n- Adding error recovery patterns to new or existing code\n- Understanding transient vs non-transient error classification\n- Implementing circuit breakers or exponential backoff\n- Adding debug logging for recovery attempts\n\n## Key Concepts Covered\n\n### 1. Circuit Breaker Pattern\n- Maximum retry limits (standard: 3 attempts)\n- Exponential backoff strategies\n- Fail-fast on non-transient errors\n- Implementation in JavaScript, Shell, and Go\n\n### 2. Installation Failure Recovery\n- NPM installation with cache clearing and registry fallbacks\n- Python pip installation with mirror alternatives\n- Docker image pull with retry and rate limit handling\n- Copilot CLI installation with network retry\n\n### 3. API Timeout and Rate Limit Handling\n- GitHub API rate limit detection and backoff\n- Transient error detection patterns\n- Custom retry configuration for different APIs\n- Rate limit-specific retry strategies\n\n### 4. Debug Logging for Recovery\n- Logger package usage for retry attempts\n- Category naming conventions (pkg:filename)\n- DEBUG environment variable patterns\n- Zero-overhead logging when disabled\n\n### 5. Error Categorization\n- Transient vs non-transient errors\n- Network errors, timeout patterns\n- HTTP error codes (502, 503, 504)\n- GitHub-specific errors (rate limits, abuse detection)\n\n## Anti-Patterns to Avoid\n\nThis skill explicitly covers anti-patterns to avoid:\n- ❌ Infinite retry loops without maximum limits\n- ❌ Retrying validation errors that won't self-correct\n- ❌ No backoff delay between attempts\n- ❌ Silent retries without logging\n- ❌ Retrying non-transient errors\n\n## Code Examples Provided\n\nThe skill includes production-ready examples for:\n- JavaScript retry with `withRetry()` function\n- Shell script retry loops with exponential backoff\n- Go retry patterns with context and timeouts\n- NPM\u002Fpip\u002Fdocker installation recovery\n- GitHub API rate limit handling\n- Debug logging for all recovery attempts\n\n## Related Skills\n\n- **error-messages** - Error message formatting and style guide\n- **error-pattern-safety** - Safety guidelines for error pattern regex\n- **developer** - General development guidelines and conventions\n\n## Full Documentation\n\nComplete documentation available at: `..\u002F..\u002Fscratchpad\u002Ferror-recovery-patterns.md`\n\nThis skill references the comprehensive error recovery patterns document which includes:\n- Console formatting requirements\n- Error wrapping patterns\n- Common error scenarios with step-by-step resolution\n- Error message templates\n- Debugging runbook\n- Error categorization decision trees\n- Metrics and monitoring strategies\n","# Error Recovery Patterns Skill\n\nUse this skill for error handling, recovery strategies, and debugging in gh-aw.\n\n## Purpose\n\nImplement robust recovery patterns to:\n- Reduce retry loops in agent sessions (target: \u003C10% vs current 23%)\n- Implement circuit breakers to prevent infinite retry loops\n- Add proactive recovery for installation, dependency, and API failures\n- Improve debug logging for recovery attempts\n\n## When to Use This Skill\n\nUse this skill when:\n- Implementing retry logic for network operations, installations, or API calls\n- Debugging retry loop issues in workflows or agent sessions\n- Adding error recovery patterns to new or existing code\n- Understanding transient vs non-transient error classification\n- Implementing circuit breakers or exponential backoff\n- Adding debug logging for recovery attempts\n\n## Key Concepts Covered\n\n### 1. Circuit Breaker Pattern\n- Maximum retry limits (standard: 3 attempts)\n- Exponential backoff strategies\n- Fail-fast on non-transient errors\n- Implementation in JavaScript, Shell, and Go\n\n### 2. Installation Failure Recovery\n- NPM installation with cache clearing and registry fallbacks\n- Python pip installation with mirror alternatives\n- Docker image pull with retry and rate limit handling\n- Copilot CLI installation with network retry\n\n### 3. API Timeout and Rate Limit Handling\n- GitHub API rate limit detection and backoff\n- Transient error detection patterns\n- Custom retry configuration for different APIs\n- Rate limit-specific retry strategies\n\n### 4. Debug Logging for Recovery\n- Logger package usage for retry attempts\n- Category naming conventions (pkg:filename)\n- DEBUG environment variable patterns\n- Zero-overhead logging when disabled\n\n### 5. Error Categorization\n- Transient vs non-transient errors\n- Network errors, timeout patterns\n- HTTP error codes (502, 503, 504)\n- GitHub-specific errors (rate limits, abuse detection)\n\n## Anti-Patterns to Avoid\n\nThis skill explicitly covers anti-patterns to avoid:\n- ❌ Infinite retry loops without maximum limits\n- ❌ Retrying validation errors that won't self-correct\n- ❌ No backoff delay between attempts\n- ❌ Silent retries without logging\n- ❌ Retrying non-transient errors\n\n## Code Examples Provided\n\nThe skill includes production-ready examples for:\n- JavaScript retry with `withRetry()` function\n- Shell script retry loops with exponential backoff\n- Go retry patterns with context and timeouts\n- NPM\u002Fpip\u002Fdocker installation recovery\n- GitHub API rate limit handling\n- Debug logging for all recovery attempts\n\n## Related Skills\n\n- **error-messages** - Error message formatting and style guide\n- **error-pattern-safety** - Safety guidelines for error pattern regex\n- **developer** - General development guidelines and conventions\n\n## Full Documentation\n\nComplete documentation available at: `..\u002F..\u002Fscratchpad\u002Ferror-recovery-patterns.md`\n\nThis skill references the comprehensive error recovery patterns document which includes:\n- Console formatting requirements\n- Error wrapping patterns\n- Common error scenarios with step-by-step resolution\n- Error message templates\n- Debugging runbook\n- Error categorization decision trees\n- Metrics and monitoring strategies\n",{"name":5,"description":7},"main","8541229759617347888641eba917d3b0ad66a984",".github\u002Fskills\u002Ferror-recovery-patterns",626,"https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw","https:\u002F\u002Fgh.io\u002Fgh-aw","https:\u002F\u002Fgithub.com\u002Fgithub","https:\u002F\u002Fgithub.com\u002Fabout","How people build software.","2026-11-15 06:45:15",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add github\u002Fgh-aw --skill error-recovery-patterns",{"tool":56,"command":57},"bunx","bunx skills add github\u002Fgh-aw --skill error-recovery-patterns",{"tool":59,"command":60},"pnpm","pnpm dlx skills add github\u002Fgh-aw --skill error-recovery-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Ferror-recovery-patterns\u002FSKILL.md",true,[64,70,74],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"scripts\u002Fduo-checker-prompt.md","SCRIPT","脚本",4562,"https:\u002F\u002Fgithub.com\u002Fviktomas\u002Fdotfiles\u002Fblob\u002Fmaster\u002Fpi\u002F.pi\u002Fagent\u002Fskills\u002Fsubagent\u002Fscripts\u002Fduo-checker-prompt.md",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"scripts\u002Fduo-subagent.sh",23311,"https:\u002F\u002Fgithub.com\u002Fviktomas\u002Fdotfiles\u002Fblob\u002Fmaster\u002Fpi\u002F.pi\u002Fagent\u002Fskills\u002Fsubagent\u002Fscripts\u002Fduo-subagent.sh",{"path":75,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":76,"sourceHtmlUrl":77},"scripts\u002Fsubagent.sh",11784,"https:\u002F\u002Fgithub.com\u002Fviktomas\u002Fdotfiles\u002Fblob\u002Fmaster\u002Fpi\u002F.pi\u002Fagent\u002Fskills\u002Fsubagent\u002Fscripts\u002Fsubagent.sh",[79,87,95,123,140,165],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":86},"01M7DQYVZ9W9DDXKQ9452SNP8J","cracktro","Edit, preview, and verify the standalone interactive talk deck in docs\u002Fpublic\u002Fcracktro (slides, SVG diagrams, transitions, WebAudio sound).","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fcracktro\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":94},"01M7612HQ4378TK8QZ5HPAF4KR","create-connector","Create or extend a declaration-only third-party connector, with narrow reads, separate safe outputs, optional protected triggers, and offline conformance evidence.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fcreate-connector\u002FSKILL.md",[],[],"2026-11-12 13:55:43",{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":109,"publishedAt":35},"01M6ADC942STTXHFV410J4DH0X","GitHub Agentic Workflows","GitHub Agentic Workflows (`gh-aw`) is a GitHub CLI extension for writing Agentic Workflows in markdown and compiling them to GitHub Actions.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002FSKILL.md",[101,106],{"categoryNo":102,"categoryName":103,"taxonomyType":104,"taxonomyTypeDesc":105},"01JBSEEDCAT000000000000011","运维与部署","SCENARIO","使用场景",{"categoryNo":107,"categoryName":108,"taxonomyType":104,"taxonomyTypeDesc":105},"01JBSEEDCAT000000000000023","Skill与智能体开发",[9,110,111,112,113,114,115,116,117,32,118,119,120,121,122],"github agentic workflows","agentic workflows","workflows","agentic","extension","markdown","github cli","cli","for","compiling","writing","github actions","actions",{"skillNo":124,"name":125,"nameZh":6,"description":126,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":127,"categories":128,"keywords":129,"publishedAt":35},"01M6ADC6ZXSA46N9XD6VNAP1MS","windows-compatibility","Cross-platform path handling and command patterns","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fwindows-compatibility\u002FSKILL.md",[],[130,131,132,133,134,135,136,137,27,138,139],"windows","windows compatibility","compatibility","command","git","bugs","platform","high","cross-platform","path",{"skillNo":141,"name":142,"nameZh":6,"description":143,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":144,"categories":145,"keywords":146,"publishedAt":35},"01M6ADC44957SVQF96R5YY247P","versioning-policy","Semver versioning rules for Squad SDK and CLI — prevents prerelease version incidents","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fversioning-policy\u002FSKILL.md",[],[147,148,149,150,151,117,152,153,154,155,156,157,158,159,118,160,161,162,163,164],"versioning","policy","versioning policy","gate","implementation","workspace","pr","sdk","release","ci","npm","semver","squad","incident","incidents","Rules","version","resolution",{"skillNo":166,"name":167,"nameZh":6,"description":168,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":169,"categories":170,"keywords":175,"publishedAt":35},"01M6ADC1PHMEAEVR87F8PDR89X","tiered-memory","Three-tier agent memory model (hot\u002Fcold\u002Fwiki) for context reduction per spawn","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Ftiered-memory\u002FSKILL.md",[171,174],{"categoryNo":172,"categoryName":173,"taxonomyType":104,"taxonomyTypeDesc":105},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":107,"categoryName":108,"taxonomyType":104,"taxonomyTypeDesc":105},[176,177,178,29,179,180,181,182,183,184,185,186,187,118,188,189],"tiered memory","memory","performance","agent memory","proposal","cold","model","wiki","spawn","memory-management","context","three","runtime","management"]