[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6KFZR93M2MK7XEPJDN7P7NC":3,"skill-same:01M6KFZR93M2MK7XEPJDN7P7NC":73},{"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":40,"linkOnly":41,"markdownContent":42,"markdownBody":43,"frontMatter":44,"refName":45,"commitSha":46,"skillDirectory":47,"forksCount":14,"repositoryHtmlUrl":48,"repositoryHomepageUrl":6,"ownerHtmlUrl":49,"ownerBlogUrl":50,"ownerDescription":51,"updatedAt":52,"install":53,"resources":66},"01M6KFZR93M2MK7XEPJDN7P7NC","route-failed-searches-to-shell-agent",null,"Delegate web search tasks to shell_agent when direct search_web tool fails, using its retry mechanism and multi-step capabilities for resilient data gathering","xyliu-cs\u002FOpenSpace-GDPval","xyliu-cs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F89236536?v=4","01M6KF8Z1V4TXS86CKSH48BY8T","xy","01M6KF8Z67443W0SHXM85JEF0B",0,"MIT","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Froute-failed-searches-to-shell-agent\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39],"shell","route","route failed searches to shell agent","web","tasks","capabilities","search","data","web search","tool","direct","delegate","multi","retry","for","resilient data gathering","2026-11-10 10:12:30",false,"---\nname: route-failed-searches-to-shell-agent\ndescription: Delegate web search tasks to shell_agent when direct search_web tool fails, using its retry mechanism and multi-step capabilities for resilient data gathering\n---\n\n# Route Failed Web Searches to Shell Agent\n\n## When to Use This Skill\n\nUse this workflow when:\n- Direct `search_web` tool calls consistently fail with 'unknown error' or similar failures\n- You need to gather web-based information but the standard search tool is unreliable\n- The task requires multi-step data collection that benefits from autonomous retry logic\n- You need resilient data gathering that can adapt when initial approaches fail\n\n## Core Pattern\n\nInstead of repeatedly calling `search_web` when it fails, delegate the entire search task to `shell_agent`. The shell_agent's internal capabilities provide:\n- **Automatic retry logic** with error detection and recovery\n- **Multi-step approach** - can try different methods (APIs, scraping, alternative sources)\n- **Code-based solutions** - can write Python scripts, use curl, or other tools\n- **Autonomous adaptation** - figures out the best approach without manual intervention\n\n## Step-by-Step Instructions\n\n### Step 1: Detect Search Tool Failure\n\nWhen `search_web` returns errors like:\n- \"unknown error\"\n- Empty or incomplete results\n- Consistent failures across multiple queries\n\nRecognize this as a signal to switch strategies rather than retrying the same failing tool.\n\n### Step 2: Delegate to Shell Agent\n\nCreate a task for shell_agent with clear objectives:\n\n```python\nshell_agent(\n    task=\"Gather current energy market data including oil prices, gas prices, and bond market information. Search multiple sources and compile findings into a structured summary.\",\n    timeout=300\n)\n```\n\n**Key task formulation principles:**\n- Specify the **what** (data needed) not the **how** (specific tools to use)\n- Include success criteria and output format expectations\n- Allow sufficient timeout for multi-step execution (300+ seconds)\n- Let shell_agent decide whether to use Python, curl, or other approaches\n\n### Step 3: Verify Results\n\nCheck shell_agent output for:\n- Complete data collection (not partial results)\n- Multiple sources cited (indicates thorough searching)\n- Structured, usable output format\n- Evidence of error handling (mentions of retry attempts, alternative approaches tried)\n\n### Step 4: Extract and Use Data\n\nProcess the shell_agent results for your downstream task:\n- Parse collected data into required format\n- Cross-reference with any partial results from failed search_web calls\n- Document sources for verification if needed\n\n## Code Example\n\n**Scenario**: Gathering market data for a financial report when search_web fails.\n\n```python\n# Failed approach - don't keep retrying this:\ntry:\n    results = search_web(query=\"current oil gas bond market prices 2025\")\n    # This fails with unknown error\nexcept:\n    pass  # Don't just catch and retry the same failing tool\n\n# Correct approach - delegate to shell_agent:\nfrom tools import shell_agent\n\nmarket_data = shell_agent(\n    task=\"\"\"\n    Gather comprehensive energy market data for a trading strategy report.\n    Required information:\n    1. Current crude oil prices (WTI, Brent)\n    2. Natural gas prices\n    3. Relevant bond issuer analysis and yields\n    4. Recent market trends and forecasts\n    \n    Use multiple sources, handle any errors by trying alternative approaches,\n    and provide structured output with source citations.\n    \"\"\",\n    timeout=300\n)\n\n# Now use market_data for your report\n```\n\n## Why This Works\n\n| Aspect | search_web (failing) | shell_agent (working) |\n|--------|---------------------|----------------------|\n| Retry logic | None or limited | Built-in multi-round retry |\n| Error handling | Returns error | Attempts to fix and continue |\n| Approach flexibility | Single method | Can use Python, bash, APIs, scraping |\n| Adaptation | Fails completely | Tries alternative strategies |\n| Output reliability | Inconsistent | Structured, verified results |\n\n## Best Practices\n\n1. **Don't chain failed tools**: Once search_web fails twice, switch to shell_agent immediately rather than accumulating more failures.\n\n2. **Set appropriate timeouts**: Shell_agent needs time to iterate (200-300 seconds typical for complex searches).\n\n3. **Be specific about data needs**: Shell_agent performs better with clear requirements than broad queries.\n\n4. **Trust the autonomy**: Don't micromanage which tools shell_agent should use - let it decide the best approach.\n\n5. **Validate outputs**: Always verify shell_agent results meet your needs before proceeding to downstream tasks.\n\n## Troubleshooting\n\n**Shell_agent also fails?**\n- Increase timeout (try 400-500 seconds)\n- Break the task into smaller sub-tasks\n- Specify more concrete data sources or APIs to try\n\n**Results are incomplete?**\n- Add explicit output format requirements\n- Request source citations to verify coverage\n- Consider running multiple targeted shell_agent calls for different data categories\n\n**Task takes too long?**\n- Set clear timeout boundaries\n- Prioritize most critical data in the task description\n- Consider running parallel shell_agent calls for independent data categories\n\n## Related Patterns\n\n- Combine with `execute_code_sandbox` for custom data processing after shell_agent gathers raw data\n- Use alongside `create_file` to persist collected data for downstream tasks\n- Pair with `read_webpage` for targeted extraction when shell_agent identifies specific URLs","# Route Failed Web Searches to Shell Agent\n\n## When to Use This Skill\n\nUse this workflow when:\n- Direct `search_web` tool calls consistently fail with 'unknown error' or similar failures\n- You need to gather web-based information but the standard search tool is unreliable\n- The task requires multi-step data collection that benefits from autonomous retry logic\n- You need resilient data gathering that can adapt when initial approaches fail\n\n## Core Pattern\n\nInstead of repeatedly calling `search_web` when it fails, delegate the entire search task to `shell_agent`. The shell_agent's internal capabilities provide:\n- **Automatic retry logic** with error detection and recovery\n- **Multi-step approach** - can try different methods (APIs, scraping, alternative sources)\n- **Code-based solutions** - can write Python scripts, use curl, or other tools\n- **Autonomous adaptation** - figures out the best approach without manual intervention\n\n## Step-by-Step Instructions\n\n### Step 1: Detect Search Tool Failure\n\nWhen `search_web` returns errors like:\n- \"unknown error\"\n- Empty or incomplete results\n- Consistent failures across multiple queries\n\nRecognize this as a signal to switch strategies rather than retrying the same failing tool.\n\n### Step 2: Delegate to Shell Agent\n\nCreate a task for shell_agent with clear objectives:\n\n```python\nshell_agent(\n    task=\"Gather current energy market data including oil prices, gas prices, and bond market information. Search multiple sources and compile findings into a structured summary.\",\n    timeout=300\n)\n```\n\n**Key task formulation principles:**\n- Specify the **what** (data needed) not the **how** (specific tools to use)\n- Include success criteria and output format expectations\n- Allow sufficient timeout for multi-step execution (300+ seconds)\n- Let shell_agent decide whether to use Python, curl, or other approaches\n\n### Step 3: Verify Results\n\nCheck shell_agent output for:\n- Complete data collection (not partial results)\n- Multiple sources cited (indicates thorough searching)\n- Structured, usable output format\n- Evidence of error handling (mentions of retry attempts, alternative approaches tried)\n\n### Step 4: Extract and Use Data\n\nProcess the shell_agent results for your downstream task:\n- Parse collected data into required format\n- Cross-reference with any partial results from failed search_web calls\n- Document sources for verification if needed\n\n## Code Example\n\n**Scenario**: Gathering market data for a financial report when search_web fails.\n\n```python\n# Failed approach - don't keep retrying this:\ntry:\n    results = search_web(query=\"current oil gas bond market prices 2025\")\n    # This fails with unknown error\nexcept:\n    pass  # Don't just catch and retry the same failing tool\n\n# Correct approach - delegate to shell_agent:\nfrom tools import shell_agent\n\nmarket_data = shell_agent(\n    task=\"\"\"\n    Gather comprehensive energy market data for a trading strategy report.\n    Required information:\n    1. Current crude oil prices (WTI, Brent)\n    2. Natural gas prices\n    3. Relevant bond issuer analysis and yields\n    4. Recent market trends and forecasts\n    \n    Use multiple sources, handle any errors by trying alternative approaches,\n    and provide structured output with source citations.\n    \"\"\",\n    timeout=300\n)\n\n# Now use market_data for your report\n```\n\n## Why This Works\n\n| Aspect | search_web (failing) | shell_agent (working) |\n|--------|---------------------|----------------------|\n| Retry logic | None or limited | Built-in multi-round retry |\n| Error handling | Returns error | Attempts to fix and continue |\n| Approach flexibility | Single method | Can use Python, bash, APIs, scraping |\n| Adaptation | Fails completely | Tries alternative strategies |\n| Output reliability | Inconsistent | Structured, verified results |\n\n## Best Practices\n\n1. **Don't chain failed tools**: Once search_web fails twice, switch to shell_agent immediately rather than accumulating more failures.\n\n2. **Set appropriate timeouts**: Shell_agent needs time to iterate (200-300 seconds typical for complex searches).\n\n3. **Be specific about data needs**: Shell_agent performs better with clear requirements than broad queries.\n\n4. **Trust the autonomy**: Don't micromanage which tools shell_agent should use - let it decide the best approach.\n\n5. **Validate outputs**: Always verify shell_agent results meet your needs before proceeding to downstream tasks.\n\n## Troubleshooting\n\n**Shell_agent also fails?**\n- Increase timeout (try 400-500 seconds)\n- Break the task into smaller sub-tasks\n- Specify more concrete data sources or APIs to try\n\n**Results are incomplete?**\n- Add explicit output format requirements\n- Request source citations to verify coverage\n- Consider running multiple targeted shell_agent calls for different data categories\n\n**Task takes too long?**\n- Set clear timeout boundaries\n- Prioritize most critical data in the task description\n- Consider running parallel shell_agent calls for independent data categories\n\n## Related Patterns\n\n- Combine with `execute_code_sandbox` for custom data processing after shell_agent gathers raw data\n- Use alongside `create_file` to persist collected data for downstream tasks\n- Pair with `read_webpage` for targeted extraction when shell_agent identifies specific URLs",{"name":5,"description":7},"main","af1b40a42167d09c30b3a63000aa14ace4c1e229","gdpval_bench\u002Fskills\u002Froute-failed-searches-to-shell-agent","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval","https:\u002F\u002Fgithub.com\u002Fxyliu-cs","https:\u002F\u002Fxyliu-cs.github.io","PhD Student in CS, CUHK-Shenzhen.","2026-04-06 20:32:15",{"source":8,"skillName":5,"commands":54,"prompt":64,"zipAvailable":65},[55,58,61],{"tool":56,"command":57},"npx","npx skills add xyliu-cs\u002FOpenSpace-GDPval --skill route-failed-searches-to-shell-agent",{"tool":59,"command":60},"bunx","bunx skills add xyliu-cs\u002FOpenSpace-GDPval --skill route-failed-searches-to-shell-agent",{"tool":62,"command":63},"pnpm","pnpm dlx skills add xyliu-cs\u002FOpenSpace-GDPval --skill route-failed-searches-to-shell-agent","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Froute-failed-searches-to-shell-agent\u002FSKILL.md",true,[67],{"path":68,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":71,"sourceHtmlUrl":72},".skill_id","OTHER","其他",50,"https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Froute-failed-searches-to-shell-agent\u002F.skill_id",[74,87,95,111,136,151],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":40},"01M6KG8MF1S664SWBDENYRSCK8","zip-export-deliverable","Ensures codebase deliverables are properly exported as ZIP archives through a dedicated finalization step","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fzip-export-deliverable\u002FSKILL.md",[],[81,82,83,84,85,86],"zip export deliverable","zip","export","deliverables","codebase","as",{"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":40},"01M6KG8GAZWHHEK7VNJDW0ME21","zip-deliverable-finalization","Ensure codebase deliverables are properly packaged as ZIP exports in a dedicated final step","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fzip-deliverable-finalization\u002FSKILL.md",[],[94,82,84,85,86],"zip deliverable finalization",{"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":101,"publishedAt":40},"01M6KG8CMQQ1PYMNTSRZ9VS1MD","zero-iteration-failure-analysis","Identify and handle agent failures with 0 iterations as pre-execution system issues","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fzero-iteration-failure-analysis\u002FSKILL.md",[],[102,103,104,105,106,107,108,109,86,110],"failure analysis","ZeRO","analysis","iteration","zero iteration failure analysis","with","issues","execution","system",{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":122,"publishedAt":40},"01M6KG86W3PA07FT9W58YHHERM","write-file-fallback-report","Generate professional documents using write_file when primary data sources fail, leveraging embedded domain knowledge instead of external retrieval","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fwrite-file-fallback-report\u002FSKILL.md",[117],{"categoryNo":118,"categoryName":119,"taxonomyType":120,"taxonomyTypeDesc":121},"01JBSEEDCAT000000000000034","行政与办公人员","PROFESSION","适用职业",[123,124,125,126,127,128,129,130,131,132,133,134,31,135],"fallback","write","file","report","write file fallback report","domain","professional","sources","retrieval","generate","embedded","documents","knowledge",{"skillNo":137,"name":138,"nameZh":6,"description":139,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":140,"categories":141,"keywords":143,"publishedAt":40},"01M6KG82GAEY3GG77CMGCK1C2T","fallback-doc-with-delegation","Generate professional documents after tool failures using shell_agent for complex formats or write_file for simple text\u002Fmarkdown","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fwrite-file-fallback-report-enhanced\u002FSKILL.md",[142],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[144,107,123,145,146,24,134,132,125,147,33,148,124,149,129,150,38],"fallback doc with delegation","doc","delegation","markdown","text","simple","formats",{"skillNo":152,"name":153,"nameZh":6,"description":154,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":155,"categories":156,"keywords":158,"publishedAt":40},"01M6KG7WT7GX5NYCGEFHW22NV7","context-anchored-fallback-report","Generate documents with write_file when retrieval tools fail, with explicit guardrails against task context drift","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fwrite-file-fallback-report-enhanced-4bc5c2\u002FSKILL.md",[157],{"categoryNo":118,"categoryName":119,"taxonomyType":120,"taxonomyTypeDesc":121},[123,126,159,160,132,125,161,162,124,163,164,131,107,165,134],"context","context anchored fallback report","Guardrails","Tools","task","drift","context drift"]