[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6HXZ73JE2FW05N2RZ9VBDJD":3,"skill-same:01M6HXZ73JE2FW05N2RZ9VBDJD":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":48,"repositoryHtmlUrl":49,"repositoryHomepageUrl":6,"ownerHtmlUrl":50,"ownerBlogUrl":51,"ownerDescription":6,"updatedAt":52,"install":53,"resources":66},"01M6HXZ73JE2FW05N2RZ9VBDJD","shell-error-debug-workflow",null,"Systematic workflow for diagnosing and resolving unknown errors from run_shell commands","HKUDS\u002FAgentPilot","HKUDS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F118165258?v=4","01M6HW8VRNZP64G0P4MVJW2KKQ","✨Data Intelligence Lab@HKU✨","01M6HW8VWZVHBRHYH3T330PFWV",8029,"MIT","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\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","6b84b0689ca0d9e7b1e4061188ff6b60758e0f8a","openspace\u002Flegacy\u002Fv1\u002Fgdpval_bench\u002Fskills\u002Fshell-error-debug-workflow",944,"https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot","https:\u002F\u002Fgithub.com\u002FHKUDS","https:\u002F\u002Fsites.google.com\u002Fview\u002Fchaoh","2026-11-12 22:26:39",{"source":8,"skillName":5,"commands":54,"prompt":64,"zipAvailable":65},[55,58,61],{"tool":56,"command":57},"npx","npx skills add HKUDS\u002FAgentPilot --skill shell-error-debug-workflow",{"tool":59,"command":60},"bunx","bunx skills add HKUDS\u002FAgentPilot --skill shell-error-debug-workflow",{"tool":62,"command":63},"pnpm","pnpm dlx skills add HKUDS\u002FAgentPilot --skill shell-error-debug-workflow","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\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\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\u002Fgdpval_bench\u002Fskills\u002Fshell-error-debug-workflow\u002F.skill_id",[74,93,112,133,156,178],{"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},"01M6HYB297NDABRERJRVG0K8R0","agentpilot","Set up AgentPilot and use its single entry to prepare missing inputs and run configured RSI experiments. Use when the user requests AgentPilot installation or work with AgentPilot.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fplugins\u002Fagentpilot\u002Fskills\u002Fagentpilot\u002FSKILL.md",[],[76,81,82,83,84,85,86,87,88,89,90,91,34,92],"prepare","requests","with","missing","installation","rsi","up","use","user","work","SET","experiments",{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":40},"01M6HYAYWXTTE1J7DJM0MFNQ4H","remember","Review auto-memory entries and propose promotions to OPENSPACE.md, OPENSPACE.local.md, or retained auto-memory topics; detect duplicates, stale facts, conflicts, and ambiguous entries before making changes.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Fopenspace\u002Fskills\u002Fremember\u002FSKILL.md",[],[95,100,101,102,103,104,105,106,107,108,109,110,111],"memory","review","auto","openspace","changes","facts","detect","entries","local","conflicts","stale","duplicates",{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":116,"categories":117,"keywords":119,"publishedAt":40},"01M6HYAVMPM4SBDV60R2B5HPV8","skill-discovery","Search reusable OpenSpace skills locally, and browse cloud packages step by step when a cloud skill may help. Reusing proven skills saves tokens, improves reliability, and extends your capabilities beyond built-in tools.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Fopenspace\u002Fhost_skills\u002Fskill-discovery\u002FSKILL.md",[118],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[120,121,122,103,123,124,125,126,127,128,129,130,131,132],"skill discovery","discovery","reusable","step by step","tokens","packages","help","cloud","reliability","capabilities","browse","search","Tools",{"skillNo":134,"name":135,"nameZh":6,"description":136,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":137,"categories":138,"keywords":140,"publishedAt":40},"01M6HYAR811B3RB0M50RBEDGN6","delegate-task","Delegate tasks to OpenSpace — a full-stack autonomous worker for coding, DevOps, web research, and desktop automation, backed by an extensive MCP tool and skill library. Skills auto-improve through use, reducing token consumption over time. A cloud community lets agents share and collectively evolve reusable skills.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Fopenspace\u002Fhost_skills\u002Fdelegate-task\u002FSKILL.md",[139],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[141,142,143,103,144,145,146,147,148,122,102,88,149,150,151,38,152,153,154,155],"delegate","task","delegate task","time","improve","desktop automation","worker","community","autonomous","tool","stack","share","tasks","automation","MCP",{"skillNo":157,"name":158,"nameZh":6,"description":159,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":160,"categories":161,"keywords":162,"publishedAt":40},"01M6HYAM9FSGV6E52AYENDQXYH","write-special-chars-ts-check","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, plus a reliable TypeScript type-checking step that filters output to only the newly-written files to avoid being misled by pre-existing errors.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-ts-check\u002FSKILL.md",[],[163,164,165,166,167,168,169,170,171,172,173,174,175,176,38,37,177],"write special chars ts check","write","check","type","files","filters","only","template","file","python","typescript","output","Existing","type-checking","script",{"skillNo":179,"name":180,"nameZh":6,"description":181,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":182,"categories":183,"keywords":184,"publishedAt":40},"01M6HYAH05HGV7SVWSVR8PJRQD","write-special-chars-readback","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, with mandatory post-write verification via read_file and cleanup of \u002Ftmp helper scripts.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-readback\u002FSKILL.md",[],[185,186,164,83,38,177,187,188,189,190,191,170,171,192,193,172],"write special chars readback","readback","helper","post","via","scripts","read","verification","cleanup"]