Agent skill

Md2pdf

by joshukraine in joshukraine/dotfiles

Convert a Markdown file to PDF with GitHub-style formatting using the md2pdf tool.

MITAuto-check passedDocuments & Office

Install Md2pdf

skills CLI
$ npx skills add joshukraine/dotfiles --skill md2pdf -a claude-code

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

GitHub CLI
$ gh skill install joshukraine/dotfiles md2pdf --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/joshukraine/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude/.claude/skills/md2pdf .claude/skills/md2pdf && 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
md2pdf
GitHub stars
429
Token cost
~299 tokens
SKILL.md length
117 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Convert a Markdown file to PDF with GitHub-style formatting using the md2pdf tool.

  • Works in 3 steps: Determine input files → Run the conversion: Execute md2pdf with… → Report results: Confirm which PDFs were…
  • Tasks that involve PDF
  • SKILL.md covers Command Options, Your task, Tool Details and Example Usage
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Md2pdf is an agent skill from joshukraine/dotfiles. Convert a Markdown file to PDF with GitHub-style formatting using the md2pdf tool.

Its SKILL.md is about 300 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering PDF and Markdown. It works with GitHub. The repository describes itself as: :roundpushpin: My dotfiles for macOS using Neovim, Zsh, and Ghostty + Tmux. The licence is MIT.

When your agent uses it

  • Tasks that involve PDF
  • Tasks that involve Markdown

Example prompts

  • “/md2pdf”

Workflow steps

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

  1. Determine input files
  2. Run the conversion: Execute md2pdf with the specified files
  3. Report results: Confirm which PDFs were generated

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    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

Md2pdf loads about 299 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 117 words of instructions outside code blocks.

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

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

The full file from joshukraine/dotfiles at commit b59ad5b, republished under its MIT licence (© joshukraine). 117 words, ~299 tokens.

Download SKILL.mdSave it as .claude/skills/md2pdf/SKILL.md (or your agent's skills folder).
name
md2pdf
description
Convert a Markdown file to PDF with GitHub-style formatting using the md2pdf tool.
argument-hint
[file.md]

Markdown to PDF

Convert Markdown files to PDF with GitHub-style formatting using the md2pdf tool.

Command Options

  • $ARGUMENTS: File paths or glob patterns to convert (e.g., docs/guide.md, docs/*.md)
  • -o FILE: Custom output path (only valid with a single input file)

Your task

  1. Determine input files:

    • If $ARGUMENTS are provided, use them as the file paths
    • If no arguments are provided, ask the user which files to convert
  2. Run the conversion: Execute md2pdf with the specified files

  3. Report results: Confirm which PDFs were generated

Tool Details

The md2pdf tool uses pandoc + weasyprint with GitHub-style CSS. The CSS and script live in dotfiles (~/dotfiles/bin/.local/bin/). The MD2PDF_CSS environment variable can override the default CSS path.

Example Usage

bash
# Convert a single file
/md2pdf docs/guide.md

# Convert multiple files with a glob
/md2pdf docs/qa-handoffs/qa-guide-*.md

# Convert with a custom output name
/md2pdf -o custom-name.pdf docs/guide.md

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

Files

Just SKILL.md in claude/.claude/skills/md2pdf of joshukraine/dotfiles.

Open the folder on GitHubat commit b59ad5b

Compare with similar skills

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

Md2pdf compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Md2pdf this skilljoshukraine/dotfiles429—~299Automated safety check: PassMIT
Lov Any2pdflovstudio/any2pdf211—~2.4kAutomated safety check: NotesMIT
PullmdAeternaLabsHQ/pullmd486—~2.6kAutomated safety check: PassAGPL-3.0
MarkitdownImCa0/just-laws78214 repos~3.2kAutomated safety check: NotesMIT
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0
Bookforge Korean Ebook PDF Makergongnyang/bookforge3151 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Lov Any2pdf

    lovstudio/any2pdf

    Convert Markdown documents to professionally typeset PDF files with reportlab.

    211 GitHub stars~2.4k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Pullmd

    AeternaLabsHQ/pullmd

    Read any web page, document, or YouTube video as clean Markdown using PullMD.

    486 GitHub stars~2.6k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    782 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Produces book-style Korean ebook PDFs from a topic or finished manuscript, with six design styles, real book parts and quality-check gates before output.

    315 GitHub starsUsed in 1 repo~1.7k tokens
    Documents & OfficeAuto-check passed
  • Huashu Markdown Publishing Pipeline

    alchaincyf/huashu-md-html

    Converts files and web pages into clean Markdown, then turns Markdown into polished HTML, Word, PDF and EPUB using four templates.

    907 GitHub stars~4.8k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from joshukraine/dotfiles

All 24 skills in this repo
  • Todoist CLI

    joshukraine/dotfiles

    Manage Todoist tasks, projects, labels, filters, sections, comments, reminders, and workspaces via the td CLI.

    429 GitHub starsUsed in 1 repo~6.9k tokens
    Auto-check passed
  • Autopilot Triage

    joshukraine/dotfiles

    Vet open issues for autonomous resolution and queue the qualifying ones with the autopilot-queued label — the start-of-day "fill the queue" half of the triage → run split.

    429 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • Checkpoint

    joshukraine/dotfiles

    Quick 2-minute status update on current phase, completed work, blockers, and health check.

    429 GitHub stars~600 tokensUpdated 3 days ago
    Auto-check passed
  • Create PR

    joshukraine/dotfiles

    Create a pull request with auto-generated description, issue linking, ROADMAP updates, and PR-metadata validation.

    429 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Debrief

    joshukraine/dotfiles

    Detailed technical walkthrough covering architecture, test coverage, product tour, and key design decisions.

    429 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check passed
  • Drift Check

    joshukraine/dotfiles

    Pre-PR advisory check for deviations from the project spec. An agent skill from joshukraine/dotfiles.

    429 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed

Works with

Questions about Md2pdf

What does Md2pdf do?

Convert a Markdown file to PDF with GitHub-style formatting using the md2pdf tool. Md2pdf is an agent skill from joshukraine/dotfiles. Convert a Markdown file to PDF with GitHub-style formatting using the md2pdf tool.

When should I use Md2pdf?

Md2pdf fits situations like: tasks that involve PDF; tasks that involve Markdown.

How do I install Md2pdf in Claude Code?

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

How do I install Md2pdf in Codex?

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

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

What does Md2pdf need to run?

SKILL.md names no scripts, command-line tools or credentials: Md2pdf is instructions for the agent only.

Does Md2pdf 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 Md2pdf 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 Md2pdf use?

Md2pdf 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 Md2pdf use?

About 299 tokens (SKILL.md is roughly 1.2k 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 Md2pdf?

Skills that share tags, products or a category with Md2pdf: Lov Any2pdf (lovstudio/any2pdf, 211 stars), Pullmd (AeternaLabsHQ/pullmd, 486 stars), Markitdown (ImCa0/just-laws, 782 stars) and Gzh Design (isjiamu/gzh-design-skill, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Md2pdf?

joshukraine (a GitHub user) maintains it in joshukraine/dotfiles, which has 429 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 6, 2026.

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