GitHub - cfitzgerald-pd/1pager: AI is too verbose. 1pager condenses any convo/thought/workspace into a single 1-pager optimized for human review. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
cfitzgerald-pd
1pager
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>1 Commit<br>1 Commit
references
references
scripts
scripts
README.md
README.md
SKILL.md
SKILL.md
View all files
Repository files navigation
1pager
A skill that condenses any long document, directory, or chat into a strict<br>one-page summary — bullet-first, least verbosity possible — humanizes it, and<br>exports a .md plus a .docx (opens in Word and Google Docs).
The problem
LLMs are verbose by default. Left unedited, their output is long, padded, and<br>full of tells (rule-of-three, "delve", em-dash sprees, generic upbeat closers).
The cost lands on the reader. As Camille Fournier argues in<br>Guidelines for respectful use of AI,<br>shipping unreviewed, bloated AI output creates a validation tax : colleagues<br>have to read and verify text the author never bothered to trim. Long PRs, wall-<br>of-text messages, and bloated docs are, in her words, "frankly, just rude."<br>Brevity is a form of respect — shorter is better because it protects the<br>reader's time.
This skill exists to do the trimming the author should have done: cut the output<br>down to only what the reader needs to understand or decide, on a single page.
What it does
Strips to essentials — keeps the point, the decision/ask, the few<br>supporting facts, real risks, and concrete next steps. Drops everything else.
Drafts a strict 1-pager — bottom line first, then bullets. One page, hard<br>ceiling (~350 words).
Humanizes — removes AI-writing tells. Invokes the installed humanizer<br>skill if present; otherwise falls back to the bundled references/humanizer.md.
Exports two files — -1pager.md and -1pager.docx.
Files
1pager/<br>├── SKILL.md # the skill: condense → humanize → export<br>├── README.md # this file<br>├── scripts/<br>│ └── md_to_docx.py # pure-stdlib Markdown → .docx (no dependencies)<br>└── references/<br>└── humanizer.md # bundled humanizer rules (fallback)
Usage
In Claude Code, the skill triggers when you ask to condense, shorten, or make a<br>1-pager out of something:
"Condense this design doc into a one-pager."<br>"This thread is way too long — give me a tl;dr I can share."<br>"Boil the docs/ folder down to a single page."
Point it at a directory and it combines the relevant files into one page by<br>default (one page per file if you ask for that instead).
You can also run the converter directly:
python3 scripts/md_to_docx.py my-1pager.md my-1pager.docx
Converter scope
md_to_docx.py supports the small Markdown subset a 1-pager needs: #–####<br>headings, -/* bullets (two-space indent = sub-bullet), **bold**, and<br>`code` (rendered monospace). It has no external dependencies — a .docx is<br>just a zip of XML, built with the Python standard library.
About
AI is too verbose. 1pager condenses any convo/thought/workspace into a single 1-pager optimized for human review.
Resources
Readme
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
stars
Watchers
watching
Forks
forks
Report repository
Releases
No releases published
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Python<br>100.0%
You can’t perform that action at this time.