Agent skill

PDF

by madhvantyagi in madhvantyagi/Gnos

Turn lesson content into a PDF handout; render and check it before delivery.

MITAuto-check passedDocuments & Office

Install PDF

skills CLI
$ npx skills add madhvantyagi/Gnos --skill pdf -a claude-code

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

GitHub CLI
$ gh skill install madhvantyagi/Gnos pdf --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/madhvantyagi/Gnos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pdf .claude/skills/pdf && 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
pdf
GitHub stars
337
Token cost
~881 tokens
SKILL.md length
411 words
Files
8 (incl. scripts, references)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Turn lesson content into a PDF handout; render and check it before delivery.

  • Works in 5 steps: Select the lesson's outcome and… → Write the lesson as Markdown or use an… → Convert with python3… → …
  • Tasks that involve PDF
  • SKILL.md covers Register the artifact and Typography and figures
  • Runs Python scripts from its folder; calls python3 and pdftoppm

What it does

PDF is an agent skill from madhvantyagi/Gnos. Turn lesson content into a PDF handout; render and check it before delivery.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `references/lesson-format.md`, `references/visual-review.md` and `scripts/build_pdf.py`).

It sits in Documents & Office, covering PDF. It works with Python. The repository describes itself as: Teaching harness , help you to learn anything , It teaches like real teacher , design curriculum , generate videos , simulations , images , pdfs , tracks your learning style etc. The licence is MIT.

When your agent uses it

  • Tasks that involve PDF

Example prompts

  • “/pdf”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Select the lesson's outcome and audience. Read only the necessary teacher and
  2. Write the lesson as Markdown or use an existing README. Place diagrams and
  3. Convert with python3 skills/pdf/scripts/markdown_to_pdf.py lesson.md -o output/lesson.pdf.
  4. Render pages with pdftoppm -scale-to 1400 -png output/lesson.pdf output/lesson.
  5. Extract text with pdftotext or pypdf and check for omissions or missing

What it can do on your machine

Read from SKILL.md and the folder at commit be0e47c. 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

    Ships 4 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • pdftoppm

    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

PDF loads about 881 tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 20 tokens; SKILL.md has 411 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~20
When it runs · the whole SKILL.md, loaded when a task matches
~881
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.5k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from madhvantyagi/Gnos at commit be0e47c, republished under its MIT licence (© madhvantyagi). 411 words, ~881 tokens.

Download SKILL.mdSave it as .claude/skills/pdf/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
pdf
description
Turn lesson content into a PDF handout; render and check it before delivery.

Lesson PDFs

Build a document the learner can return to without the conversation. Keep the teaching sequence visible: question, explanation, worked example, changed case. Use headings to mark conceptual changes rather than decorating every paragraph.

Run the commands below with the project's .venv/bin/python when that environment is present. Check that interpreter before treating a missing package in the system Python as a missing PDF capability. For a fresh environment, install skills/pdf/requirements.txt there.

  1. Select the lesson's outcome and audience. Read only the necessary teacher and subject context. Do not print internal learner records or hidden assessment criteria in a handout unless requested.
  2. Write the lesson as Markdown or use an existing README. Place diagrams and image-model outputs beside it and reference them with ![caption](image.png). HTML <img src="..." alt="..."> works too. Keep captions and source credits.
  3. Convert with python3 skills/pdf/scripts/markdown_to_pdf.py lesson.md -o output/lesson.pdf. This also writes editable lesson JSON. Dependencies: ReportLab, Pillow, markdown-it-py; Matplotlib supplies fonts and equation rendering. Fenced math blocks render as equations. Remote images become explicit source links; save a permitted local image first when the figure must appear in the PDF. For precise block control, use build_pdf.py lesson.json -o output/lesson.pdf; see references/lesson-format.md.
  4. Render pages with pdftoppm -scale-to 1400 -png output/lesson.pdf output/lesson. Inspect every page. Check equations, captions, page breaks, text size, and source links; extraction alone cannot establish visual quality.
  5. Extract text with pdftotext or pypdf and check for omissions or missing glyphs. Deliver the PDF with its editable source. State any unverified layout.
Show full SKILL.md (160 more words)Show less

Register the artifact

The viewer page shows the topic's pdf chip as ready only after the PDF is registered. Copy it into the course workspace, then register:

bash
cp output/lesson.pdf learners/<learner>/courses/<course-id>/artifacts/documents/<slug>.pdf
python3 skills/course-design/scripts/manage_artifact.py --learners-root learners \
  register <learner-id> <course-id> --file artifact.json

Use type: document, mime_type: application/pdf, the topic's lesson_id, and status: ready. Then re-render the page:

bash
python3 skills/course-viewer/scripts/render_viewer.py learners/<learner>/courses/<course-id>

Typography and figures

Use a calm hierarchy: serif body, sans heading, mono code; 11–12 pt body with comfortable leading and margins. The builder embeds DejaVu fonts when found; use --font-dir for another installation of that family. It fails if the font set is incomplete rather than silently substituting missing glyphs.

Keep diagrams labeled and interpretable without color alone. Preserve image aspect ratio; avoid enlarging a tiny raster into a blurry page. Keep the caption with the figure. Include source/creator and whether a diagram is schematic. Use actual math rendering for equations; do not send raw LaTeX to paragraph text.

Read references/visual-review.md when inspecting. examples/lessons/gradient/README.md exercises the builder with equations, an image, a comparison table, and a worked example.

© madhvantyagi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts, references) in skills/pdf of madhvantyagi/Gnos.

  • SKILL.md
  • references/lesson-format.md
  • references/visual-review.md
  • requirements.txt
  • scripts/build_pdf.py
  • scripts/create_example_figures.py
  • scripts/markdown_to_pdf.py
  • scripts/render_equation.py

Open the folder on GitHubat commit be0e47c

Compare with similar skills

PDF 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.

PDF compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PDF this skillmadhvantyagi/Gnos337—~881Automated safety check: PassMIT
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences2742 repos~2.7kAutomated safety check: PassApache-2.0
Software Certificate SkillIvanCodesDev/software-certificate-skill156—~1.6kAutomated safety check: PassMIT
Doc Cleanernotoriouslab/doc-cleaner309—~712Automated safety check: PassMIT
MineruNebutra/MinerU-Skill122—~504Automated safety check: PassMIT
Office To Mdshuyu-labs/WebCode278—~1kAutomated safety check: NotesCustom licence

Similar skills

  • Instrument Data To Allotrope

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.

    274 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed
  • Software Certificate Skill

    IvanCodesDev/software-certificate-skill

    面向普通用户,从真实软件项目全自动生成中国软件著作权申请资料:一次收集登记事实,自动分析业务、选择可追溯源码、取得真实界面证据,生成申请表信息、规范黑白灰操作手册、代码前后30页或全部材料及真实 DOCX/PDF;内部验证、渲染、哈希与备份只进入系统临时运行区,项目最终仅保留正式资料。适配 Codex、Claude…

    156 GitHub stars~1.6k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Doc Cleaner

    notoriouslab/doc-cleaner

    Convert PDF, DOCX, XLSX, and text files to clean, structured Markdown.

    309 GitHub stars~712 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.

    122 GitHub stars~504 tokensUpdated 15 days ago
    Documents & OfficeAuto-check passed
  • Office To Md

    shuyu-labs/WebCode

    Convert Office documents (Word, Excel, PowerPoint, PDF) to Markdown format.

    278 GitHub stars~1k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check: notes
  • Cc Streaming Export Safety

    doccker/cc-use-exp

    当实现用户驱动的大文件导出或批量序列化(Excel/CSV/JSON/JSONL/PDF,数据量未知或超过 1 万行/10 MB)时触发;普通小文件下载、静态资源下载、非导出 Writer/Report 类不触发。防止 OOM、临时文件残留、同步导出阻塞 HTTP 线程和表格公式注入。

    1.1k GitHub stars~2.2k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from madhvantyagi/Gnos

All 12 skills in this repo
  • Course Design

    madhvantyagi/Gnos

    Design and revise a course's goal, progression, prerequisites, and sources.

    337 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Course Viewer

    madhvantyagi/Gnos

    Show an enrolled course and its lessons. An agent skill from madhvantyagi/Gnos.

    337 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Khan Academy

    madhvantyagi/Gnos

    Find a Khan Academy video fast and add it only on a strong match.

    337 GitHub stars~814 tokensUpdated today
    Auto-check passed
  • Learner Tracking

    madhvantyagi/Gnos

    Record what the learner does and adapt the course to it in real time.

    337 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Lesson Design

    madhvantyagi/Gnos

    Develop the current topic into a connected lesson. An agent skill from madhvantyagi/Gnos.

    337 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Manim Voice Animation

    madhvantyagi/Gnos

    Make Manim teaching animations with narration and subtitles when motion helps a concept.

    337 GitHub stars~1.8k tokensUpdated today
    Auto-check passed

Works with

Questions about PDF

What does PDF do?

Turn lesson content into a PDF handout; render and check it before delivery. PDF is an agent skill from madhvantyagi/Gnos. Turn lesson content into a PDF handout; render and check it before delivery.

When should I use PDF?

PDF fits situations like: tasks that involve PDF.

How do I install PDF in Claude Code?

Run `npx skills add madhvantyagi/Gnos --skill pdf -a claude-code`. Or copy the skill folder (skills/pdf in madhvantyagi/Gnos) into .claude/skills/pdf in your project. Claude Code loads it when a task matches its description.

How do I install PDF in Codex?

Run `npx skills add madhvantyagi/Gnos --skill pdf -a codex`. Or copy the skill folder (skills/pdf in madhvantyagi/Gnos) into .agents/skills/pdf in your project. Codex loads it when a task matches its description.

Can I use PDF 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 madhvantyagi/Gnos --skill pdf -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pdf, .gemini/skills/pdf, .github/skills/pdf and .opencode/skills/pdf in your project.

What does PDF need to run?

Going by SKILL.md and its folder, PDF needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and pdftoppm). Our summary lists: Python 3.

Does PDF 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 PDF 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does PDF use?

PDF is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PDF use?

About 881 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 660 tokens, read only when the agent opens those files.

What are the alternatives to PDF?

Skills that share tags, products or a category with PDF: Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars), Software Certificate Skill (IvanCodesDev/software-certificate-skill, 156 stars), Doc Cleaner (notoriouslab/doc-cleaner, 309 stars) and Mineru (Nebutra/MinerU-Skill, 122 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PDF?

madhvantyagi (a GitHub user) maintains it in madhvantyagi/Gnos, which has 337 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.

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