✍️ Writing
man Page (Section 1) from a CLI Help Dump (No Invented Flags)
Write a groff/mandoc section-1 man page from pasted --help. Only flags present in the dump. Not a README, not Sphinx, not a changelog.
0Reviews
Prompt
Act as a section-1 man page author who only uses a pasted CLI --help dump. You write groff/mandoc markup for NAME, SYNOPSIS, DESCRIPTION, and OPTIONS. You do not invent flags, subcommands, exit codes, or files not in the dump. This is not a full README, not Sphinx docs, and not a changelog. You work only from Inputs. Do not invent stats, citations, quotes, URLs, names, IDs, or records that are not in Inputs. Inputs: - Pasted --help or usage dump: [Help] - Command name I lock: [Name] - Section I lock: 1 - Exit codes I may document (or NONE): [Exits] - Words I must not use: [Banned] - What I must never invent: [Never] - Output format: [Format] - Language: [Lang] - See-also pages I may list (or NONE): [SeeAlso] - Version string I may print (or UNKNOWN): [Version] Generate: 1. Honesty ledger: Name, flags from Help only, Exits, SeeAlso, Version, Lang. Forbidden: inventing flags, inventing config paths. 2. NAME and SYNOPSIS lines from Help only. 3. DESCRIPTION paragraph from Help nouns only. 4. OPTIONS: one .TP block per flag in Help. If a flag lacks text, write DESCRIPTION NOT IN INPUTS. 5. EXIT STATUS: only Exits; if NONE, write EXIT CODES NOT IN INPUTS. 6. SEE ALSO: only SeeAlso; if NONE, omit inventing nearby pages. 7. Refuse: inventing --verbose if absent, inventing man section 5, inventing files in FILES. 8. Compliance pass: quote Banned and Never. Print flag count. Gaps list of five. Format as Format. Constraints: - Section-1 man page from Help only. Not README and not Sphinx. - Never invent flags or exit codes when NONE/UNKNOWN. - Only document what Help shows. - No emojis.
Instructions
Replace every [bracket] with your details before running. Works on ChatGPT, Claude, and Gemini.
Examples
Example Input
Help: usage: tidewatch check --path PATH [--json]
tidewatch list [--limit N]
check: verify a path; --path required; --json print JSON
list: list recent checks; --limit default 20
Name: tidewatch
Exits: NONE (do not invent exit code table)
Banned: see github.com invent, perfect POSIX, guaranteed stable ABI
Never: invent flags, invent config file path, invent exit codes, invent FILES section paths
Format: ledger + man markup + refuse + gaps
Lang: English
SeeAlso: NONE
Version: UNKNOWNExample Output
1. Ledger. Name tidewatch. Flags from Help: check --path, check --json, list --limit (default 20). Exits NONE. SeeAlso NONE. Version UNKNOWN. Lang English. Forbidden: invent --verbose, invent config path, invent exit codes, invent FILES paths, invent github URL, perfect POSIX, guaranteed stable ABI. 2. NAME / SYNOPSIS. .TH TIDEWATCH 1 "UNKNOWN" "tidewatch" "User Commands" .SH NAME tidewatch \- check and list path verification jobs .SH SYNOPSIS .B tidewatch check .I --path PATH .RB [ --json ] .br .B tidewatch list .RB [ --limit N ] 3. DESCRIPTION. .SH DESCRIPTION tidewatch runs a check subcommand that verifies a path and optionally prints JSON, and a list subcommand that lists recent checks with an optional limit (default 20). Behavior beyond the Help dump is NOT IN INPUTS. 4. OPTIONS. .SH OPTIONS .TP .B check --path PATH Required path to verify. .TP .B check --json Print JSON. .TP .B list --limit N Limit recent checks; default 20. Flag count: 3 documented from Help. 5. EXIT STATUS. EXIT CODES NOT IN INPUTS. 6. SEE ALSO. NONE. Do not invent tidewatch(5) or crontab(5). 7. Refuse. --verbose absent from Help: refused. FILES section paths: NOT IN INPUTS. Version string: UNKNOWN. github.com URL: refused. 8. Compliance. Banned cut. Format ledger+man markup+refuse+gaps. Gaps: exit code table, version string, author line, config file path if any, examples section text from maintainer. Missing-data policy: if a field was blank, write NOT IN INPUTS rather than guessing. Lock any tool version named in Inputs; if unnamed, write unknown. No invented testimonials, star ratings, or press logos. If legal, clinical, insurance, HR, education-plan, or veterinary content appears, add a one-line not-advice and de-identify banner. Quote banned-word hits and cut them. End with a gaps list of five bullets the user still owes you. Character and byte caps in the job are hard; print counts when relevant. Refuse to backfill DOIs, exam dumps, PHI, PII, or compensation promises not in Inputs.