メニュー
Token-efficient man page reading. Load when looking up CLI tool docs, flags, options, usage examples, config formats. Do NOT use bash to run `man` directly without loading this skill first.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Load when user asks to create, update, edit, or refactor any OpenCode (OC) artefact: skills, agents, commands, tools, plugins, or snippets — including modifying an existing one. Triggers examples: "create skill to …", "draft a command to …", "add Y to OC cmd Z", "edit the W agent", "write a plugin to …", "create a tool for …", "update crafter skill". Guides user through discovery, drafting, and iterative refinement.
Methodology for drafting technical design specs. Load when asked to write, draft, or refine a spec, design doc, architecture note, RFC, or similar document for a system, API, protocol, or subsystem.
Load ONLY when user explicitly invokes /reflect-friction or directly asks to review session friction (e.g. "review friction", "what went wrong", "where did you push back"). Do NOT auto-load speculatively.
General script writing guidelines: structure, naming, error handling, and organization. Language-agnostic. Auto-load when writing or reviewing any script. Language-specific skills (write-script-bash, write-script-bats) build on top of this.
Load whenever new files or directories are created in a git repo — via write, bash, or any other tool. Ensures `git_track_new_file` is called so new files are git-tracked for the user.
Bash script writing guidelines: shebang, strict mode, bash idioms, and full boilerplate. Auto-load when writing or reviewing bash scripts. Loads write-script-generic for language-agnostic rules.
| name | read-man-page |
| description | Token-efficient man page reading. Load when looking up CLI tool docs, flags, options, usage examples, config formats. Do NOT use bash to run `man` directly without loading this skill first. |
GOAL: Read man pages in targeted chunks via manq (man query) script.
--help vs man| Situation | Action |
|---|---|
| Quick flag syntax, well-known tool | <cmd> --help |
| Tool has no man page | <cmd> --help |
Man page not found by manq | <cmd> --help; or man -k <cmd> to find correct name |
| Full option semantics, exit codes, edge cases | man via this skill |
| EXAMPLES, FILES, ENVIRONMENT sections | man via this skill |
--help terse or missing detail | man via this skill |
man -k <keyword> # search by name/description (apropos)
man -K <string> # full-text search across all man pages
manq accepts <name> or <name>:N where N is a standard man category number:
1 — User commands 2 — System calls 3 — Library functions 4 — Device files 5 — File formats & config 6 — Games 7 — Misc (protocols, conventions) 8 — Admin commands
Omit :N to use first match.
Use <name>:N to disambiguate (e.g. printf:1 vs printf:3, githooks:5).
Resolve ./scripts/manq to absolute path before invoking.
<skill-dir>/scripts/manq <subcommand> <name[:N]> [options]
(NOTE: examples below use grep)
toc — section list with line count, subsection count, condensed synopsis.
./scripts/manq toc grep
./scripts/manq toc grep -S OPTIONS # TOC scoped to one section
./scripts/manq toc tree -L 2 # limit depth level (default: all)
./scripts/manq toc rg -O # include condensed options list
Common section names usable directly with section without running toc first:
SYNOPSIS, DESCRIPTION, OPTIONS, FLAGS, EXAMPLES, FILES, ENVIRONMENT, EXIT STATUS, SEE ALSO
section — extract one or more sections.
Use --lines to read incrementally.
--lines ranges are rendered-output line numbers (as printed), not source offsets.
./scripts/manq section grep EXAMPLES
./scripts/manq section grep OPTIONS EXAMPLES # multiple in one call
./scripts/manq section grep OPTIONS --lines 1-50
./scripts/manq section grep OPTIONS --lines 51-100
flag — show description block for specific flags.
./scripts/manq flag grep -v
./scripts/manq flag grep -v --include # multiple flags in one call
toc if section names unknown; use -O for options summary.section; multiple per call allowed.--lines.flag instead of reading all of OPTIONS.man <cmd> — outputs full page.toc synopsis may be truncated for complex tools (ip, ffmpeg) — use section SYNOPSIS for full form.-O output heuristic for non-standard man pages; cross-check with section OPTIONS if incomplete.flag matching exact (short + long form tried automatically); fuzzy matching not supported.