unix-cli

UNIX command-line interface guidelines for building tools that follow POSIX conventions, proper exit codes, stream handling, and the UNIX philosophy. This skill should be used when writing, reviewing, or designing CLI tools to ensure they integrate properly with the UNIX tool chain. Triggers on tasks involving CLI tools, command-line arguments, exit codes, stdout/stderr, signals, or shell scripts.

インストールへ移動ファイルを確認

リポジトリ: pproenca/dot-skills
ソースの最終更新活動: 2026年5月27日 09:50
検出された SKILL.md の言語: 英語
スター: 220
フォーク: 19

インストール方法

デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。

AI アシスタントでインストール

このプロンプトをコピーして、使用中の AI アシスタントに送ってください。

Follow https://skillsmp.com/skill-install/prompt.md to install only the Agent Skill at https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/unix-cli.

直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。

npx skills add https://github.com/pproenca/dot-skills --skill unix-cli

コマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。

ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。

ソースファイルを確認

インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。

ファイルエクスプローラー

48 ファイル

SKILL.md

ソースの指示 · 読み取り専用プレビュー

name: unix-cli
description: UNIX command-line interface guidelines for building tools that follow POSIX conventions, proper exit codes, stream handling, and the UNIX philosophy. This skill should be used when writing, reviewing, or designing CLI tools to ensure they integrate properly with the UNIX tool chain. Triggers on tasks involving CLI tools, command-line arguments, exit codes, stdout/stderr, signals, or shell scripts.

# UNIX/POSIX Standards CLI Best Practices Comprehensive 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). ## When to Apply Reference these guidelines when: - Writing new CLI tools in any language - Parsing command-line arguments and flags - Deciding what goes to stdout vs stderr - Choosing appropriate exit codes - Handling signals like SIGINT and SIGTERM ## Rule Categories by Priority | Priority | Category | Impact | Prefix | |----------|----------|--------|--------| | 1 | Argument & Flag Design | CRITICAL | `args-` | | 2 | Exit Codes | CRITICAL | `exit-` | | 3 | Output Streams | CRITICAL | `output-` | | 4 | Error Handling | HIGH | `error-` | | 5 | I/O & Composition | HIGH | `io-` | | 6 | Help & Documentation | MEDIUM-HIGH | `help-` | | 7 | Signals & Robustness | MEDIUM | `signal-` | | 8 | Configuration & Environment | MEDIUM | `config-` | ## Quick Reference ### 1. Argument & Flag Design (CRITICAL) - [`args-use-getopt`](references/args-use-getopt.md) - Use standard argument parsing libraries - [`args-provide-long-options`](references/args-provide-long-options.md) - Provide long options for all short options - [`args-support-double-dash`](references/args-support-double-dash.md) - Support double-dash to terminate options - [`args-require-help-version`](references/args-require-help-version.md) - Implement --help and --version options - [`args-prefer-flags-over-positional`](references/args-prefer-flags-over-positional.md) - Prefer flags over positional arguments - [`args-use-standard-flag-names`](references/args-use-standard-flag-names.md) - Use standard flag names - [`args-never-read-secrets-from-flags`](references/args-never-read-secrets-from-flags.md) - Never read secrets from command-line flags - [`args-support-option-bundling`](references/args-support-option-bundling.md) - Support option bundling ### 2. Exit Codes (CRITICAL) - [`exit-zero-for-success`](references/exit-zero-for-success.md) - Return zero for success only - [`exit-use-standard-codes`](references/exit-use-standard-codes.md) - Use standard exit codes - [`exit-signal-codes`](references/exit-signal-codes.md) - Use 128+N for signal termination - [`exit-partial-success`](references/exit-partial-success.md) - Handle partial success consistently - [`exit-distinguish-error-types`](references/exit-distinguish-error-types.md) - Distinguish error types with different exit codes ### 3. Output Streams (CRITICAL) - [`output-stdout-for-data`](references/output-stdout-for-data.md) - Write data to stdout only - [`output-stderr-for-errors`](references/output-stderr-for-errors.md) - Write errors and diagnostics to stderr - [`output-detect-tty`](references/output-detect-tty.md) - Detect TTY for human-oriented output - [`output-provide-machine-format`](references/output-provide-machine-format.md) - Provide machine-readable output format - [`output-line-based-text`](references/output-line-based-text.md) - Use line-based output for text streams - [`output-respect-no-color`](references/output-respect-no-color.md) - Respect NO_COLOR environment variable ### 4. Error Handling (HIGH) - [`error-include-program-name`](references/error-include-program-name.md) - Include program name in error messages - [`error-actionable-messages`](references/error-actionable-messages.md) - Make error messages actionable - [`error-use-strerror`](references/error-use-strerror.md) - Use strerror for system errors - [`error-avoid-stack-traces`](references/error-avoid-stack-traces.md) - Avoid stack traces in user-facing errors - [`error-validate-early`](references/error-validate-early.md) - Validate input early and fail fast ### 5. I/O & Composition (HIGH) - [`io-support-stdin`](references/io-support-stdin.md) - Support reading from stdin - [`io-write-to-stdout`](references/io-write-to-stdout.md) - Write output to stdout by default - [`io-be-stateless`](references/io-be-stateless.md) - Design stateless operations - [`io-handle-binary-safely`](references/io-handle-binary-safely.md) - Handle binary data safely - [`io-atomic-writes`](references/io-atomic-writes.md) - Use atomic file writes - [`io-handle-multiple-files`](references/io-handle-multiple-files.md) - Handle multiple input files consistently ### 6. Help & Documentation (MEDIUM-HIGH) - [`help-show-usage-on-error`](references/help-show-usage-on-error.md) - Show brief usage on argument errors - [`help-structure-help-output`](references/help-structure-help-output.md) - Structure help output consistently - [`help-show-defaults`](references/help-show-defaults.md) - Show default values in help - [`help-include-examples`](references/help-include-examples.md) - Include practical examples in help - [`help-version-format`](references/help-version-format.md) - Format version output correctly ### 7. Signals & Robustness (MEDIUM) - [`signal-handle-sigint`](references/signal-handle-sigint.md) - Handle SIGINT gracefully - [`signal-handle-sigterm`](references/signal-handle-sigterm.md) - Handle SIGTERM for clean shutdown - [`signal-handle-sigpipe`](references/signal-handle-sigpipe.md) - Handle SIGPIPE for broken pipes - [`signal-cleanup-on-second-interrupt`](references/signal-cleanup-on-second-interrupt.md) - Skip cleanup on second interrupt ### 8. Configuration & Environment (MEDIUM) - [`config-follow-xdg`](references/config-follow-xdg.md) - Follow XDG Base Directory Specification - [`config-precedence-order`](references/config-precedence-order.md) - Apply configuration in correct precedence order - [`config-env-naming`](references/config-env-naming.md) - Use consistent environment variable naming - [`config-never-store-secrets`](references/config-never-store-secrets.md) - Never store secrets in config files or environment - [`config-respect-standard-vars`](references/config-respect-standard-vars.md) - Respect standard environment variables ## How to Use Read individual reference files for detailed explanations and code examples: - [Section definitions](references/_sections.md) - Category structure and impact levels - [Rule template](assets/templates/_template.md) - Template for adding new rules ## Reference Files | File | Description | |------|-------------| | [references/_sections.md](references/_sections.md) | Category definitions and ordering | | [assets/templates/_template.md](assets/templates/_template.md) | Template for new rules | | [metadata.json](metadata.json) | Version and reference information |

GitHubで見る

検索に戻るインストールに戻る

ray-llm

LLM workloads on open-source Ray (pinned to 2.57) — OpenAI-compatible serving with ray.serve.llm (vLLM-backed LLMConfig + build_openai_app) and batch inference with ray.data.llm (build_processor). Corrects the stale defaults a model produces — the archived ray-llm repo and its YAML configs, hand-rolled vLLM engines inside plain Serve deployments, the removed build_llm_processor name, deprecated boolean stage flags, top-level LLMServer/LLMRouter imports, free-form accelerator strings, one-deployment-per-LoRA-adapter designs — with the 2.57 idioms (stage configs, placement_group_config over hand-rolled PGs, deployment_config autoscaling, dynamic LoRA multiplexing, prefix-cache-affinity routing, the full OpenAI endpoint surface). Use when writing, reviewing, or productionizing LLM serving or batch inference on Ray. Classic-ML Ray (Train/Tune/Data/Serve/clusters) lives in the sibling ray skill.

2026-08-15

ray

Production Ray (open-source, pinned to 2.57) for classic-ML workloads from training to serving — Ray Train, Tune, Data, Serve, Core, and cluster deployment on KubeRay. Corrects the older-corpus defaults a model reaches for (ray.air session reporting, Trainer-inside-Tuner, tune.run, map_batches concurrency=, DatasetPipeline/to_torch, max_concurrent_queries, RayServeHandle + ray.get, Deployment.deploy, ray.state, ray.get-in-a-loop) with the 2.57 idioms that replaced them (Train V2 defaults, driver-function tuning, compute strategies, streaming datasets, DeploymentHandle/DeploymentResponse, serve build/deploy, ray.util.state, KubeRay CRDs and Jobs API). Use when writing, reviewing, or productionizing Python code that touches Ray distributed training, data pipelines, hyperparameter tuning, model serving, or Ray cluster operations. LLM serving/batch-inference on Ray lives in the sibling ray-llm skill.

2026-08-15

mlflow-3

MLflow 3 (open-source, pinned to 3.15) for classic-ML MLOps — logging and registering models, promoting versions across dev/staging/prod, standing up a tracking server, evaluating with gates, and serving. Corrects the MLflow 2-era defaults a model reaches for (artifact_path, registry stages and get_latest_versions, top-level mlflow.evaluate with baseline_model, runs-URI registration, pickle serialization, mlruns file stores, MLServer serving) with the MLflow 3 idioms that replaced them (named LoggedModels, aliases and copy_model_version, models.evaluate plus validate_evaluation_results, skops/torch.export defaults, database backends, the FastAPI scoring server). Use when writing, reviewing, or migrating Python code that touches MLflow tracking, the model registry, evaluation, or serving.

2026-08-15

このリポジトリのすべてを見る

unix-cli

ソース情報

インストール方法

AI アシスタントでインストール

ソースファイルを確認

このリポジトリの他の Skills

AI アシスタントでインストール

このリポジトリの他の Skills