[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6FEM4WAXRFT6T5N9PEVT41F":3,"skill-same:01M6FEM4WAXRFT6T5N9PEVT41F":48},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":21,"linkOnly":22,"markdownContent":23,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M6FEM4WAXRFT6T5N9PEVT41F","unix-cli",null,"ComeOnOliver\u002Fskillshub","ComeOnOliver","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F43215937?v=4","01M6E5JNFECJAAVFE0W7SMWWD2","Haoran Shu","01M6E5JNNDQS7AJZDYFQ8TPZCK",67,"MIT","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fpproenca\u002Fdot-skills\u002Funix-cli\u002FSKILL.md",[],[18,19,20],"cli","unix","unix cli","2026-11-10 10:12:30",false,"# UNIX\u002FPOSIX Standards CLI Best Practices\n\nComprehensive guidelines for building command-line tools that follow UNIX conventions, designed for AI agents and LLMs. Contains 44 rules across 8 categories, prioritized by impact from critical (argument handling, exit codes, output streams) to incremental (configuration and environment).\n\n## When to Apply\n\nReference these guidelines when:\n- Writing new CLI tools in any language\n- Parsing command-line arguments and flags\n- Deciding what goes to stdout vs stderr\n- Choosing appropriate exit codes\n- Handling signals like SIGINT and SIGTERM\n\n## Rule Categories by Priority\n\n| Priority | Category | Impact | Prefix |\n|----------|----------|--------|--------|\n| 1 | Argument & Flag Design | CRITICAL | `args-` |\n| 2 | Exit Codes | CRITICAL | `exit-` |\n| 3 | Output Streams | CRITICAL | `output-` |\n| 4 | Error Handling | HIGH | `error-` |\n| 5 | I\u002FO & Composition | HIGH | `io-` |\n| 6 | Help & Documentation | MEDIUM-HIGH | `help-` |\n| 7 | Signals & Robustness | MEDIUM | `signal-` |\n| 8 | Configuration & Environment | MEDIUM | `config-` |\n\n## Quick Reference\n\n### 1. Argument & Flag Design (CRITICAL)\n\n- [`args-use-getopt`](references\u002Fargs-use-getopt.md) - Use standard argument parsing libraries\n- [`args-provide-long-options`](references\u002Fargs-provide-long-options.md) - Provide long options for all short options\n- [`args-support-double-dash`](references\u002Fargs-support-double-dash.md) - Support double-dash to terminate options\n- [`args-require-help-version`](references\u002Fargs-require-help-version.md) - Implement --help and --version options\n- [`args-prefer-flags-over-positional`](references\u002Fargs-prefer-flags-over-positional.md) - Prefer flags over positional arguments\n- [`args-use-standard-flag-names`](references\u002Fargs-use-standard-flag-names.md) - Use standard flag names\n- [`args-never-read-secrets-from-flags`](references\u002Fargs-never-read-secrets-from-flags.md) - Never read secrets from command-line flags\n- [`args-support-option-bundling`](references\u002Fargs-support-option-bundling.md) - Support option bundling\n\n### 2. Exit Codes (CRITICAL)\n\n- [`exit-zero-for-success`](references\u002Fexit-zero-for-success.md) - Return zero for success only\n- [`exit-use-standard-codes`](references\u002Fexit-use-standard-codes.md) - Use standard exit codes\n- [`exit-signal-codes`](references\u002Fexit-signal-codes.md) - Use 128+N for signal termination\n- [`exit-partial-success`](references\u002Fexit-partial-success.md) - Handle partial success consistently\n- [`exit-distinguish-error-types`](references\u002Fexit-distinguish-error-types.md) - Distinguish error types with different exit codes\n\n### 3. Output Streams (CRITICAL)\n\n- [`output-stdout-for-data`](references\u002Foutput-stdout-for-data.md) - Write data to stdout only\n- [`output-stderr-for-errors`](references\u002Foutput-stderr-for-errors.md) - Write errors and diagnostics to stderr\n- [`output-detect-tty`](references\u002Foutput-detect-tty.md) - Detect TTY for human-oriented output\n- [`output-provide-machine-format`](references\u002Foutput-provide-machine-format.md) - Provide machine-readable output format\n- [`output-line-based-text`](references\u002Foutput-line-based-text.md) - Use line-based output for text streams\n- [`output-respect-no-color`](references\u002Foutput-respect-no-color.md) - Respect NO_COLOR environment variable\n\n### 4. Error Handling (HIGH)\n\n- [`error-include-program-name`](references\u002Ferror-include-program-name.md) - Include program name in error messages\n- [`error-actionable-messages`](references\u002Ferror-actionable-messages.md) - Make error messages actionable\n- [`error-use-strerror`](references\u002Ferror-use-strerror.md) - Use strerror for system errors\n- [`error-avoid-stack-traces`](references\u002Ferror-avoid-stack-traces.md) - Avoid stack traces in user-facing errors\n- [`error-validate-early`](references\u002Ferror-validate-early.md) - Validate input early and fail fast\n\n### 5. I\u002FO & Composition (HIGH)\n\n- [`io-support-stdin`](references\u002Fio-support-stdin.md) - Support reading from stdin\n- [`io-write-to-stdout`](references\u002Fio-write-to-stdout.md) - Write output to stdout by default\n- [`io-be-stateless`](references\u002Fio-be-stateless.md) - Design stateless operations\n- [`io-handle-binary-safely`](references\u002Fio-handle-binary-safely.md) - Handle binary data safely\n- [`io-atomic-writes`](references\u002Fio-atomic-writes.md) - Use atomic file writes\n- [`io-handle-multiple-files`](references\u002Fio-handle-multiple-files.md) - Handle multiple input files consistently\n\n### 6. Help & Documentation (MEDIUM-HIGH)\n\n- [`help-show-usage-on-error`](references\u002Fhelp-show-usage-on-error.md) - Show brief usage on argument errors\n- [`help-structure-help-output`](references\u002Fhelp-structure-help-output.md) - Structure help output consistently\n- [`help-show-defaults`](references\u002Fhelp-show-defaults.md) - Show default values in help\n- [`help-include-examples`](references\u002Fhelp-include-examples.md) - Include practical examples in help\n- [`help-version-format`](references\u002Fhelp-version-format.md) - Format version output correctly\n\n### 7. Signals & Robustness (MEDIUM)\n\n- [`signal-handle-sigint`](references\u002Fsignal-handle-sigint.md) - Handle SIGINT gracefully\n- [`signal-handle-sigterm`](references\u002Fsignal-handle-sigterm.md) - Handle SIGTERM for clean shutdown\n- [`signal-handle-sigpipe`](references\u002Fsignal-handle-sigpipe.md) - Handle SIGPIPE for broken pipes\n- [`signal-cleanup-on-second-interrupt`](references\u002Fsignal-cleanup-on-second-interrupt.md) - Skip cleanup on second interrupt\n\n### 8. Configuration & Environment (MEDIUM)\n\n- [`config-follow-xdg`](references\u002Fconfig-follow-xdg.md) - Follow XDG Base Directory Specification\n- [`config-precedence-order`](references\u002Fconfig-precedence-order.md) - Apply configuration in correct precedence order\n- [`config-env-naming`](references\u002Fconfig-env-naming.md) - Use consistent environment variable naming\n- [`config-never-store-secrets`](references\u002Fconfig-never-store-secrets.md) - Never store secrets in config files or environment\n- [`config-respect-standard-vars`](references\u002Fconfig-respect-standard-vars.md) - Respect standard environment variables\n\n## How to Use\n\nRead individual reference files for detailed explanations and code examples:\n\n- [Section definitions](references\u002F_sections.md) - Category structure and impact levels\n- [Rule template](assets\u002Ftemplates\u002F_template.md) - Template for adding new rules\n\n## Reference Files\n\n| File | Description |\n|------|-------------|\n| [references\u002F_sections.md](references\u002F_sections.md) | Category definitions and ordering |\n| [assets\u002Ftemplates\u002F_template.md](assets\u002Ftemplates\u002F_template.md) | Template for new rules |\n| [metadata.json](metadata.json) | Version and reference information |\n",{},"main","def8531e65114c0fca8fb8551c1871ee0eed705c","skills\u002Fpproenca\u002Fdot-skills\u002Funix-cli",24,"https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub","https:\u002F\u002Fskillshub.wtf","https:\u002F\u002Fgithub.com\u002FComeOnOliver","AI & Blockchain Engineer\r\n","2026-06-24 22:07:19",{"source":7,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add ComeOnOliver\u002Fskillshub --skill unix-cli",{"tool":40,"command":41},"bunx","bunx skills add ComeOnOliver\u002Fskillshub --skill unix-cli",{"tool":43,"command":44},"pnpm","pnpm dlx skills add ComeOnOliver\u002Fskillshub --skill unix-cli","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fpproenca\u002Fdot-skills\u002Funix-cli\u002FSKILL.md",true,[],[49,63,73,82,88,95],{"skillNo":50,"name":51,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":59,"publishedAt":21},"01M6FKJN13GMG4KY57J3QD8GY5","model-hierarchy-skill","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzscole\u002Fmodel-hierarchy-skill\u002Fmodel-hierarchy-skill\u002FSKILL.md",[54],{"categoryNo":55,"categoryName":56,"taxonomyType":57,"taxonomyTypeDesc":58},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[60,61,62],"model","model hierarchy","model hierarchy skill",{"skillNo":64,"name":65,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":69,"publishedAt":21},"01M6FKJJJ6GCAMR4PPPRD12M5X","zoom-mcp","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fzoom-mcp\u002FSKILL.md",[68],{"categoryNo":55,"categoryName":56,"taxonomyType":57,"taxonomyTypeDesc":58},[70,71,72],"MCP","zoom","zoom mcp",{"skillNo":74,"name":75,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":21},"01M6FKJE3KYT3KPEZMEEHYKA6K","zoom-apps-sdk","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[79,80,81,71],"sdk","zoom apps sdk","apps",{"skillNo":83,"name":84,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":21},"01M6FKJ9EDH9Q5VWDF8HAJRSP0","windows","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwindows\u002FSKILL.md",[],[84],{"skillNo":89,"name":90,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":94,"publishedAt":21},"01M6FKJ666BEEFC3AE9GJ72Q93","whiteboard","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwhiteboard\u002FSKILL.md",[93],{"categoryNo":55,"categoryName":56,"taxonomyType":57,"taxonomyTypeDesc":58},[90],{"skillNo":96,"name":97,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":21},"01M6FKJ21WFCDGTJQ2Q91T9DVW","websockets","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwebsockets\u002FSKILL.md",[],[97]]