Agent skill

Handouts

by nateberkopec in nateberkopec/dotfiles

Compose and typeset polished PDFs for personal reading on paper.

No licenceAuto-check passedDocuments & Office

Install Handouts

skills CLI
$ npx skills add nateberkopec/dotfiles --skill handouts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nateberkopec/dotfiles handouts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nateberkopec/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/files/home/.agents/skills/handouts .claude/skills/handouts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
handouts
GitHub stars
151
Token cost
~1.8k tokens
SKILL.md length
999 words
Files
14
Skills in repo
5
Repo updated
First seen
Licence
None found

At a glance

Compose and typeset polished PDFs for personal reading on paper.

  • Asked for a handout
  • SKILL.md covers Writing, Composition, Page layout and Typography, plus 1 more section
  • Calls pdftotext
  • Printable report

What it does

Handouts is an agent skill from nateberkopec/dotfiles. Compose and typeset polished PDFs for personal reading on paper. Use when asked for a handout, reading packet, printable report, comparison brief, or one-page guide, including research reports and existing text needing layout. Existing PDFs that only need printing belong to the printing skill instead.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files (for example `evals/README.md`, `evals/evals.json` and `evals/files/family-flight-options/flight-options-2026-10-01.json`).

It sits in Documents & Office, covering Deep research. The repository describes itself as: yup we're doin the thing.

When your agent uses it

  • Asked for a handout
  • Printable report
  • Comparison brief
  • Including research reports and existing text needing layout

Example prompts

  • “/handouts”

What it can do on your machine

Read from SKILL.md and the folder at commit c60133f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pdftotext

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Handouts loads about 1.8k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 999 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 999 words (~1,821 tokens).

“Make a document the reader can comfortably read, compare, annotate, or use beside the task. Own composition, typography, graphics placement, PDF production, and validation; choose any available production toolchain.”

— opening of SKILL.md by nateberkopec
name
handouts

Read the full SKILL.md on GitHub

Files

SKILL.md and 13 other files in files/home/.agents/skills/handouts of nateberkopec/dotfiles.

  • SKILL.md
  • evals/README.md
  • evals/evals.json
  • evals/files/family-flight-options/flight-options-2026-10-01.json
  • evals/files/family-flight-options/trip-rules.md
  • evals/files/race-pack/course-map.pdf
  • evals/files/race-pack/parking-map.pdf
  • evals/files/race-pack/pit-pass.pdf
  • evals/files/race-pack/schedule.pdf
  • evals/files/race-pack/technical-guide.pdf
  • evals/files/tart-cherry-research/cycling-performance.md
  • evals/files/tart-cherry-research/practical-safety.md
  • evals/files/tart-cherry-research/recovery-evidence.md
  • evals/files/tart-cherry-research/sleep-overtraining.md

Open the folder on GitHubat commit c60133f

Compare with similar skills

Handouts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Handouts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Handouts this skillnateberkopec/dotfiles151—~1.8kAutomated safety check: PassNone
Openkb Deck EditorialVectifyAI/OpenKB4.8k1 repos~2.1kAutomated safety check: PassApache-2.0
Openkb Deck NeonVectifyAI/OpenKB4.8k1 repos~4.3kAutomated safety check: PassApache-2.0
Suikonwiizo/suiko114—~1.8kAutomated safety check: PassMIT
Quant Paper ExtractorCamusGIT/EvoQuant151—~2.4kAutomated safety check: PassApache-2.0
Policy Keyword Trackerzhaohui-yang/official-document-drafting140—~555Automated safety check: PassCustom licence

Similar skills

  • Openkb Deck Editorial

    VectifyAI/OpenKB

    A skill your agent uses when the user asks the openkb chat to make a deck / slide presentation / PPT / slides / 演示稿 / 幻灯片 from their compiled KB content.

    4.8k GitHub starsUsed in 1 repo~2.1k tokens
    Documents & OfficeAuto-check passed
  • Openkb Deck Neon

    VectifyAI/OpenKB

    A skill your agent uses when the user asks the openkb chat to make a deck / slide presentation / PPT / slides / 演示稿 / 幻灯片 from their compiled KB content AND wants a dark, high-tech, neon / glow /…

    4.8k GitHub starsUsed in 1 repo~4.3k tokens
    Frontend & DesignAuto-check passed
  • Suiko

    nwiizo/suiko

    日本語文書のAI由来の均一さ、翻訳調、不自然さ、論旨、読解負荷を、決定的なRust CLIと目視で診断し、依頼に応じて書く・直す。日本語の学術論文・研究報告では、中心命題、用語、論証、DOCX/PDF納品を監査契約で確認する。Use when the user explicitly mentions suiko, asks whether Japanese text looks…

    114 GitHub stars~1.8k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Quant Paper Extractor

    CamusGIT/EvoQuant

    Convert quantitative research report PDFs to markdown, then extract structured knowledge (paperId, title, year, source, keywords, tldr, abstract, strategy, method, experiment, result) into JSONL…

    151 GitHub stars~2.4k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Policy Keyword Tracker

    zhaohui-yang/official-document-drafting

    Collects policies and developments on one topic from Chinese central ministries and compiles them into a verified situation report, with optional Word export.

    140 GitHub stars~555 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Report Export

    gaotiexinqu/OneResearchClaw

    Export a final reviewed research report into one or more requested output formats.

    450 GitHub stars~2.5k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check: notes

More from nateberkopec/dotfiles

  • Dev Env Setup

    nateberkopec/dotfiles

    Set up or audit Nate's standard dev environment in a project directory.

    151 GitHub stars~671 tokensUpdated today
    Auto-check: notes
  • Deep Research

    nateberkopec/dotfiles

    Produce an in-depth, source-grounded research report. An agent skill from nateberkopec/dotfiles.

    151 GitHub stars~738 tokensUpdated today
    Auto-check passed
  • Fix Upstream

    nateberkopec/dotfiles

    Reproduce, report, and work around bugs in upstream software managed by these dotfiles.

    151 GitHub stars~998 tokensUpdated today
    Auto-check passed
  • Printing

    nateberkopec/dotfiles

    Print files or selected pages, check printer status, or troubleshoot printing problems.

    151 GitHub stars~434 tokensUpdated today
    Auto-check passed

Questions about Handouts

What does Handouts do?

Compose and typeset polished PDFs for personal reading on paper. Handouts is an agent skill from nateberkopec/dotfiles. Compose and typeset polished PDFs for personal reading on paper.

When should I use Handouts?

Handouts fits situations like: asked for a handout; printable report; comparison brief; including research reports and existing text needing layout.

How do I install Handouts in Claude Code?

Run `npx skills add nateberkopec/dotfiles --skill handouts -a claude-code`. Or copy the skill folder (files/home/.agents/skills/handouts in nateberkopec/dotfiles) into .claude/skills/handouts in your project. Claude Code loads it when a task matches its description.

How do I install Handouts in Codex?

Run `npx skills add nateberkopec/dotfiles --skill handouts -a codex`. Or copy the skill folder (files/home/.agents/skills/handouts in nateberkopec/dotfiles) into .agents/skills/handouts in your project. Codex loads it when a task matches its description.

Can I use Handouts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nateberkopec/dotfiles --skill handouts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/handouts, .gemini/skills/handouts, .github/skills/handouts and .opencode/skills/handouts in your project.

What does Handouts need to run?

Going by SKILL.md and its folder, Handouts needs the command-line tools its instructions call (pdftotext).

Does Handouts access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Handouts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Handouts use?

No licence was found for Handouts or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Handouts use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Handouts?

Skills that share tags, products or a category with Handouts: Openkb Deck Editorial (VectifyAI/OpenKB, 4.8k stars), Openkb Deck Neon (VectifyAI/OpenKB, 4.8k stars), Suiko (nwiizo/suiko, 114 stars) and Quant Paper Extractor (CamusGIT/EvoQuant, 151 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Handouts?

nateberkopec (a GitHub user) maintains it in nateberkopec/dotfiles, which has 151 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 10, 2026.

Source: nateberkopec/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.