[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6KG2VZ8WE8PYJYV4FP88EGQ":3,"skill-same:01M6KG2VZ8WE8PYJYV4FP88EGQ":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":28,"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},"01M6KG2VZ8WE8PYJYV4FP88EGQ","shell-error-debug-workflow",null,"Systematic workflow for diagnosing and resolving unknown errors from run_shell commands","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\u002Fshell-error-debug-workflow\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[29,30,31,32,33,34,35,36,37,38,39],"workflow","debug","shell","error","shell error debug workflow","run","commands","systematic","errors","for","unknown","2026-11-10 10:12:30",false,"---\nname: shell-error-debug-workflow\ndescription: Systematic workflow for diagnosing and resolving unknown errors from run_shell commands\n---\n\n# Shell Error Debug Workflow\n\nWhen `run_shell` returns an 'unknown error' or ambiguous failure, apply this systematic troubleshooting workflow to diagnose and resolve the issue.\n\n## When to Use This Skill\n\n- `run_shell` returns an 'unknown error' message\n- Shell command fails without clear error output\n- Command works locally but fails in the agent environment\n- Intermittent or unexplained shell failures\n\n## Step-by-Step Troubleshooting Workflow\n\n### Step 1: Capture Explicit Stderr\n\nRedirect stderr to stdout to capture all error output:\n\n```bash\n# Instead of:\nrun_shell command=\"some-command\"\n\n# Use:\nrun_shell command=\"some-command 2>&1\"\n```\n\nThis ensures error messages are captured in the output rather than being lost.\n\n### Step 2: Verify Working Directory\n\nConfirm the current working directory and its contents:\n\n```bash\nrun_shell command=\"pwd && ls -la\"\n```\n\nCheck that:\n- You're in the expected directory\n- Required files\u002Fdirectories exist\n- Permissions are correct\n\n### Step 3: Check Tool\u002FCommand Availability\n\nVerify the required command or tool exists and is accessible:\n\n```bash\nrun_shell command=\"which some-command || command -v some-command || type some-command\"\n```\n\nIf the tool is not found, check PATH or install the required package.\n\n### Step 4: Use Absolute Paths\n\nReplace relative paths with absolute paths to avoid directory-related issues:\n\n```bash\n# Instead of:\nrun_shell command=\"python script.py\"\n\n# Use:\nrun_shell command=\"$(pwd)\u002Fscript.py\"\n# or\nrun_shell command=\"\u002Fabsolute\u002Fpath\u002Fto\u002Fscript.py\"\n```\n\n### Step 5: Test with Minimal Command\n\nIsolate the issue by running a minimal version of the command:\n\n```bash\n# Test basic functionality first\nrun_shell command=\"echo 'test'\"\n\n# Then gradually add complexity\nrun_shell command=\"some-command --version\"\nrun_shell command=\"some-command --help\"\n```\n\n### Step 6: Check Environment Variables\n\nSome commands depend on specific environment variables:\n\n```bash\nrun_shell command=\"env | grep -i relevant_var\"\n```\n\n## Complete Diagnostic Sequence\n\nFor persistent unknown errors, run this complete diagnostic:\n\n```bash\n# 1. Capture full environment\nrun_shell command=\"pwd && echo '---' && ls -la && echo '---' && env\"\n\n# 2. Test command with full error capture\nrun_shell command=\"your-command 2>&1 | head -50\"\n\n# 3. Check command availability\nrun_shell command=\"which your-command || echo 'Command not found in PATH'\"\n\n# 4. Try with absolute path\nrun_shell command=\"\u002Ffull\u002Fpath\u002Fto\u002Fyour-command 2>&1\"\n```\n\n## Common Causes and Solutions\n\n| Symptom | Likely Cause | Solution |\n|---------|-------------|----------|\n| No output, unknown error | stderr not captured | Add `2>&1` to command |\n| File not found | Wrong working directory | Use `pwd` to verify, use absolute paths |\n| Permission denied | File\u002Fdirectory permissions | Check with `ls -la`, adjust permissions |\n| Command not found | Tool not installed or not in PATH | Use `which` to check, install or specify full path |\n| Intermittent failures | Race conditions or timing | Add delays, check for file locks |\n\n## Example: Troubleshooting a Python Script Failure\n\n```bash\n# Initial failing command\nrun_shell command=\"python process.py\"\n# Returns: unknown error\n\n# Apply diagnostic workflow:\n# Step 1: Capture stderr\nrun_shell command=\"python process.py 2>&1\"\n\n# Step 2: Verify directory\nrun_shell command=\"pwd && ls -la\"\n\n# Step 3: Check Python availability\nrun_shell command=\"which python && python --version\"\n\n# Step 4: Use absolute path\nrun_shell command=\"$(pwd)\u002Fprocess.py 2>&1\"\n# or\nrun_shell command=\"\u002Fusr\u002Fbin\u002Fpython3 $(pwd)\u002Fprocess.py 2>&1\"\n```\n\n## Best Practices\n\n1. **Always capture stderr** when debugging: `2>&1`\n2. **Verify assumptions** about working directory and file locations\n3. **Start simple** before running complex commands\n4. **Use absolute paths** in production\u002Frepeatable scripts\n5. **Check tool versions** when behavior seems inconsistent\n6. **Document environment** when errors are hard to reproduce\n\n## When to Escalate\n\nIf this workflow does not resolve the issue:\n- The error may be environmental (container\u002Fruntime specific)\n- Consider using `shell_agent` for complex shell tasks that require autonomous error handling\n- Check for resource constraints (disk space, memory, timeouts)","# Shell Error Debug Workflow\n\nWhen `run_shell` returns an 'unknown error' or ambiguous failure, apply this systematic troubleshooting workflow to diagnose and resolve the issue.\n\n## When to Use This Skill\n\n- `run_shell` returns an 'unknown error' message\n- Shell command fails without clear error output\n- Command works locally but fails in the agent environment\n- Intermittent or unexplained shell failures\n\n## Step-by-Step Troubleshooting Workflow\n\n### Step 1: Capture Explicit Stderr\n\nRedirect stderr to stdout to capture all error output:\n\n```bash\n# Instead of:\nrun_shell command=\"some-command\"\n\n# Use:\nrun_shell command=\"some-command 2>&1\"\n```\n\nThis ensures error messages are captured in the output rather than being lost.\n\n### Step 2: Verify Working Directory\n\nConfirm the current working directory and its contents:\n\n```bash\nrun_shell command=\"pwd && ls -la\"\n```\n\nCheck that:\n- You're in the expected directory\n- Required files\u002Fdirectories exist\n- Permissions are correct\n\n### Step 3: Check Tool\u002FCommand Availability\n\nVerify the required command or tool exists and is accessible:\n\n```bash\nrun_shell command=\"which some-command || command -v some-command || type some-command\"\n```\n\nIf the tool is not found, check PATH or install the required package.\n\n### Step 4: Use Absolute Paths\n\nReplace relative paths with absolute paths to avoid directory-related issues:\n\n```bash\n# Instead of:\nrun_shell command=\"python script.py\"\n\n# Use:\nrun_shell command=\"$(pwd)\u002Fscript.py\"\n# or\nrun_shell command=\"\u002Fabsolute\u002Fpath\u002Fto\u002Fscript.py\"\n```\n\n### Step 5: Test with Minimal Command\n\nIsolate the issue by running a minimal version of the command:\n\n```bash\n# Test basic functionality first\nrun_shell command=\"echo 'test'\"\n\n# Then gradually add complexity\nrun_shell command=\"some-command --version\"\nrun_shell command=\"some-command --help\"\n```\n\n### Step 6: Check Environment Variables\n\nSome commands depend on specific environment variables:\n\n```bash\nrun_shell command=\"env | grep -i relevant_var\"\n```\n\n## Complete Diagnostic Sequence\n\nFor persistent unknown errors, run this complete diagnostic:\n\n```bash\n# 1. Capture full environment\nrun_shell command=\"pwd && echo '---' && ls -la && echo '---' && env\"\n\n# 2. Test command with full error capture\nrun_shell command=\"your-command 2>&1 | head -50\"\n\n# 3. Check command availability\nrun_shell command=\"which your-command || echo 'Command not found in PATH'\"\n\n# 4. Try with absolute path\nrun_shell command=\"\u002Ffull\u002Fpath\u002Fto\u002Fyour-command 2>&1\"\n```\n\n## Common Causes and Solutions\n\n| Symptom | Likely Cause | Solution |\n|---------|-------------|----------|\n| No output, unknown error | stderr not captured | Add `2>&1` to command |\n| File not found | Wrong working directory | Use `pwd` to verify, use absolute paths |\n| Permission denied | File\u002Fdirectory permissions | Check with `ls -la`, adjust permissions |\n| Command not found | Tool not installed or not in PATH | Use `which` to check, install or specify full path |\n| Intermittent failures | Race conditions or timing | Add delays, check for file locks |\n\n## Example: Troubleshooting a Python Script Failure\n\n```bash\n# Initial failing command\nrun_shell command=\"python process.py\"\n# Returns: unknown error\n\n# Apply diagnostic workflow:\n# Step 1: Capture stderr\nrun_shell command=\"python process.py 2>&1\"\n\n# Step 2: Verify directory\nrun_shell command=\"pwd && ls -la\"\n\n# Step 3: Check Python availability\nrun_shell command=\"which python && python --version\"\n\n# Step 4: Use absolute path\nrun_shell command=\"$(pwd)\u002Fprocess.py 2>&1\"\n# or\nrun_shell command=\"\u002Fusr\u002Fbin\u002Fpython3 $(pwd)\u002Fprocess.py 2>&1\"\n```\n\n## Best Practices\n\n1. **Always capture stderr** when debugging: `2>&1`\n2. **Verify assumptions** about working directory and file locations\n3. **Start simple** before running complex commands\n4. **Use absolute paths** in production\u002Frepeatable scripts\n5. **Check tool versions** when behavior seems inconsistent\n6. **Document environment** when errors are hard to reproduce\n\n## When to Escalate\n\nIf this workflow does not resolve the issue:\n- The error may be environmental (container\u002Fruntime specific)\n- Consider using `shell_agent` for complex shell tasks that require autonomous error handling\n- Check for resource constraints (disk space, memory, timeouts)",{"name":5,"description":7},"main","af1b40a42167d09c30b3a63000aa14ace4c1e229","gdpval_bench\u002Fskills\u002Fshell-error-debug-workflow","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 shell-error-debug-workflow",{"tool":59,"command":60},"bunx","bunx skills add xyliu-cs\u002FOpenSpace-GDPval --skill shell-error-debug-workflow",{"tool":62,"command":63},"pnpm","pnpm dlx skills add xyliu-cs\u002FOpenSpace-GDPval --skill shell-error-debug-workflow","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fshell-error-debug-workflow\u002FSKILL.md",true,[67],{"path":68,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":71,"sourceHtmlUrl":72},".skill_id","OTHER","其他",40,"https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fshell-error-debug-workflow\u002F.skill_id",[74,87,95,111,135,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":120,"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":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000034","行政与办公人员",[121,122,123,124,125,126,127,128,129,130,131,132,133,134],"fallback","write","file","report","write file fallback report","domain","professional","sources","retrieval","generate","embedded","documents","data","knowledge",{"skillNo":136,"name":137,"nameZh":6,"description":138,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":139,"categories":140,"keywords":142,"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",[141],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[143,107,121,144,145,31,132,130,123,146,147,148,122,149,127,150,38],"fallback doc with delegation","doc","delegation","markdown","tool","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":26,"taxonomyTypeDesc":27},[121,124,159,160,130,123,161,162,122,163,164,129,107,165,132],"context","context anchored fallback report","Guardrails","Tools","task","drift","context drift"]