usehandout
The Handout plugin: publish the HTML, Markdown and PDF documents your agent makes as links.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 19 Nov 2026. Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/usehandout/handout with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/usehandout/handout'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/usehandout--handout)HTML
<a href="/listings/usehandout--handout"><img src="/api/listings/usehandout--handout/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
The CLI needs [Node.js](https://nodejs.org) 24 or later, and works on macOS, Linux and Windows:
npm install -g @usehandout/cli handout login
Then give your agent the skill:
| Agent | Install the skill | | ---------------------- | --------------------------------------------------------------------------------------------------------- | | Claude Code | In Claude Code: `/plugin marketplace add usehandout/handout`, then `/plugin install handout@usehandout` | | Claude Code, no plugin | `handout skill install --agent claude` | | Codex | `handout skill install --agent codex` | | Another agent | `handout skill install --dir <its skills directory>`, or ask the agent to read [`SKILL.md`](cli/SKILL.md) |
Start a new agent session afterwards so it loads the skill. To update, run `npm install -g @usehandout/cli@latest`, then `handout skill install` again (a plugin updates from `/plugin`).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 15 lines
- {
- "name": "usehandout",
- "description": "The Handout plugin: publish the HTML, Markdown and PDF documents your agent makes as links.",
- "owner": {
- "name": "Handout",
- "url": "https://usehandout.com"
- },
- "plugins": [
- {
- "name": "handout",
- "source": "./plugins/handout",
- "description": "Offer Handout after creating a finished document; publish, update and share links with the handout CLI."
- }
- ]
- }
README.md · README · 60 lines
- # Handout CLI and agent skill
- [Handout](https://usehandout.com) turns a file into a link. You give it an `.html`, `.md` or `.pdf`
- file and get back a URL that opens in a reader, with a chosen audience and a version history behind
- it. This repository holds the `handout` command-line tool and the agent skill that lets Claude
- Code, Codex and other terminal agents publish what they just made.
- ## Install
- The CLI needs [Node.js](https://nodejs.org) 24 or later, and works on macOS, Linux and Windows:
- ```bash
- npm install -g @usehandout/cli
- handout login
- ```
- Then give your agent the skill:
- | Agent | Install the skill |
- | ---------------------- | --------------------------------------------------------------------------------------------------------- |
- | Claude Code | In Claude Code: `/plugin marketplace add usehandout/handout`, then `/plugin install handout@usehandout` |
- | Claude Code, no plugin | `handout skill install --agent claude` |
- | Codex | `handout skill install --agent codex` |
- | Another agent | `handout skill install --dir <its skills directory>`, or ask the agent to read [`SKILL.md`](cli/SKILL.md) |
- Start a new agent session afterwards so it loads the skill. To update, run
- `npm install -g @usehandout/cli@latest`, then `handout skill install` again (a plugin updates from
- `/plugin`).
- ## What is here
- | Path | What it is |
- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
- | [`cli/`](cli) | The npm package `@usehandout/cli`: the bundled CLI (`handout.mjs`) and its `SKILL.md` |
- | [`.claude-plugin/`](.claude-plugin) | The Claude Code plugin marketplace (`usehandout`) |
- | [`plugins/handout/`](plugins/handout) | The Claude Code plugin: the same `SKILL.md` |
- | [`.github/workflows/release.yml`](.github/workflows/release.yml) | Publishes `cli/` to npm, with provenance, when a `skill-v<version>` tag is pushed |
- `cli/handout.mjs` is a single, unminified file, so you can read exactly what runs. It is built in
- Handout's development repository, which is not public. The CLI talks to
- `https://usehandout.com` unless `--host` or `HANDOUT_HOST` names another Handout site.
- ## Verifying a release
- Every version on npm is published by this repository's release workflow with
- [npm provenance](https://docs.npmjs.com/generating-provenance-statements): the package page on
- npmjs.com links the exact commit and workflow run that produced it, and `npm audit signatures` in a
- project that depends on the package checks the attestation.
- ## Contributing
- This repository is a one-way mirror of the CLI and skill, published from Handout's own
- development repository at each release. Pull requests are turned off. Bug reports and feature
- requests are welcome as [issues](https://github.com/usehandout/handout/issues). To report a
- security problem, use [private vulnerability reporting](https://github.com/usehandout/handout/security/advisories/new)
- instead of a public issue.
- ## License
- Copyright 2026 Nate Pierce. Licensed under the [Apache License 2.0](LICENSE); see [NOTICE](NOTICE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.