Skip to content
Back to search

usehandout

MarketplaceWorks with Claude CodeGitHub

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/usehandout--handout/badge.svg)](/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
  1. {
  2. "name": "usehandout",
  3. "description": "The Handout plugin: publish the HTML, Markdown and PDF documents your agent makes as links.",
  4. "owner": {
  5. "name": "Handout",
  6. "url": "https://usehandout.com"
  7. },
  8. "plugins": [
  9. {
  10. "name": "handout",
  11. "source": "./plugins/handout",
  12. "description": "Offer Handout after creating a finished document; publish, update and share links with the handout CLI."
  13. }
  14. ]
  15. }
README.md · README · 60 lines
  1. # Handout CLI and agent skill
  2. [Handout](https://usehandout.com) turns a file into a link. You give it an `.html`, `.md` or `.pdf`
  3. file and get back a URL that opens in a reader, with a chosen audience and a version history behind
  4. it. This repository holds the `handout` command-line tool and the agent skill that lets Claude
  5. Code, Codex and other terminal agents publish what they just made.
  6. ## Install
  7. The CLI needs [Node.js](https://nodejs.org) 24 or later, and works on macOS, Linux and Windows:
  8. ```bash
  9. npm install -g @usehandout/cli
  10. handout login
  11. ```
  12. Then give your agent the skill:
  13. | Agent | Install the skill |
  14. | ---------------------- | --------------------------------------------------------------------------------------------------------- |
  15. | Claude Code | In Claude Code: `/plugin marketplace add usehandout/handout`, then `/plugin install handout@usehandout` |
  16. | Claude Code, no plugin | `handout skill install --agent claude` |
  17. | Codex | `handout skill install --agent codex` |
  18. | Another agent | `handout skill install --dir <its skills directory>`, or ask the agent to read [`SKILL.md`](cli/SKILL.md) |
  19. Start a new agent session afterwards so it loads the skill. To update, run
  20. `npm install -g @usehandout/cli@latest`, then `handout skill install` again (a plugin updates from
  21. `/plugin`).
  22. ## What is here
  23. | Path | What it is |
  24. | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
  25. | [`cli/`](cli) | The npm package `@usehandout/cli`: the bundled CLI (`handout.mjs`) and its `SKILL.md` |
  26. | [`.claude-plugin/`](.claude-plugin) | The Claude Code plugin marketplace (`usehandout`) |
  27. | [`plugins/handout/`](plugins/handout) | The Claude Code plugin: the same `SKILL.md` |
  28. | [`.github/workflows/release.yml`](.github/workflows/release.yml) | Publishes `cli/` to npm, with provenance, when a `skill-v<version>` tag is pushed |
  29. `cli/handout.mjs` is a single, unminified file, so you can read exactly what runs. It is built in
  30. Handout's development repository, which is not public. The CLI talks to
  31. `https://usehandout.com` unless `--host` or `HANDOUT_HOST` names another Handout site.
  32. ## Verifying a release
  33. Every version on npm is published by this repository's release workflow with
  34. [npm provenance](https://docs.npmjs.com/generating-provenance-statements): the package page on
  35. npmjs.com links the exact commit and workflow run that produced it, and `npm audit signatures` in a
  36. project that depends on the package checks the attestation.
  37. ## Contributing
  38. This repository is a one-way mirror of the CLI and skill, published from Handout's own
  39. development repository at each release. Pull requests are turned off. Bug reports and feature
  40. requests are welcome as [issues](https://github.com/usehandout/handout/issues). To report a
  41. security problem, use [private vulnerability reporting](https://github.com/usehandout/handout/security/advisories/new)
  42. instead of a public issue.
  43. ## License
  44. 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 in

Free to use. If it’s helped, pass it on.