Agent skill

Markdown To PDF

by staskh in staskh/trading_skills

Convert a markdown file to PDF using mistune + reportlab. An agent skill from staskh/trading_skills.

MITAuto-check passedDocuments & Office

Install Markdown To PDF

skills CLI
$ npx skills add staskh/trading_skills --skill markdown-to-pdf -a claude-code

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

GitHub CLI
$ gh skill install staskh/trading_skills markdown-to-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/staskh/trading_skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/markdown-to-pdf .claude/skills/markdown-to-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
markdown-to-pdf
GitHub stars
374
Token cost
~481 tokens
SKILL.md length
123 words
Files
2 (incl. scripts)
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

Convert a markdown file to PDF using mistune + reportlab. An agent skill from staskh/trading_skills.

  • The user wants to convert a .md file to PDF
  • SKILL.md covers Dependencies, Instructions, Output and Examples, plus 1 more section
  • Runs Python scripts from its folder; calls uv and pip
  • Another skill needs to produce a PDF from markdown output

What it does

Markdown To PDF is an agent skill from staskh/trading_skills. Convert a markdown file to PDF using mistune + reportlab. Use when the user wants to convert a .md file to PDF, or when another skill needs to produce a PDF from markdown output.

Its SKILL.md is about 480 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/markdown_to_pdf.py`).

It sits in Documents & Office, covering PDF and Markdown. It works with pypdf. The repository describes itself as: Claude powered advisor system for option traders. The licence is MIT.

When your agent uses it

  • The user wants to convert a .md file to PDF
  • Another skill needs to produce a PDF from markdown output

Example prompts

  • “/markdown-to-pdf”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit b71a74f. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv
    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use uv and pip, which can reach the network depending on how they are called.

    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

Markdown To PDF loads about 481 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 123 words of instructions outside code blocks.

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

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 staskh/trading_skills at commit b71a74f, republished under its MIT licence (© staskh). 123 words, ~481 tokens.

Download SKILL.mdSave it as .claude/skills/markdown-to-pdf/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
markdown-to-pdf
description
Convert a markdown file to PDF using mistune + reportlab. Use when the user wants to convert a .md file to PDF, or when another skill needs to produce a PDF from markdown output.
user_invocable
true
dependencies
trading-skills

Markdown to PDF Converter

Converts a markdown file to a professionally formatted PDF. Pure Python — no system tools required.

Dependencies

Requires two Python packages (already in pyproject.toml):

mistune>=3.2
reportlab>=4.0

Install with: uv sync (or pip install mistune reportlab)

Instructions

bash
uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py <input.md> [output.pdf]
  • input.md — path to the markdown file (required)
  • output.pdf — output path (optional; defaults to same directory and basename as input)

Output

The script returns JSON with:

  • success — true or false
  • input — resolved absolute path of the input file
  • output — resolved absolute path of the generated PDF
  • error — error message if success is false
  • generated_at — NY timezone timestamp
  • data_delay — always "real-time"

After conversion, tell the user the output PDF path.

Examples

bash
# Convert sandbox/report.md → sandbox/report.pdf (default output)
uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py sandbox/report.md

# Explicit output path
uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py sandbox/report.md sandbox/AAPL_Report_2026-05-20_1430.pdf

Supported Markdown

  • Headings (H1–H3)
  • Paragraphs, bold, italic
  • Tables (pipe syntax)
  • Fenced code blocks
  • Unordered and ordered lists

© staskh, 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 1 other file (scripts) in .claude/skills/markdown-to-pdf of staskh/trading_skills.

  • SKILL.md
  • scripts/markdown_to_pdf.py

Open the folder on GitHubat commit b71a74f

Compare with similar skills

Markdown To 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.

Markdown To PDF compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Markdown To PDF this skillstaskh/trading_skills374—~481Automated safety check: PassMIT
Adu Corrections PDFmikeOnBreeze/cc-crossbeam293—~1.5kAutomated safety check: PassMIT
File Converteraiskillstore/marketplace4301 repos~895Automated safety check: PassNone
Lov Any2pdflovstudio/any2pdf211—~2.4kAutomated safety check: NotesMIT
Any2pdfcosmicstack-labs/mercury-agent-skills476—~3.3kAutomated safety check: NotesMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT

Similar skills

  • Adu Corrections PDF

    mikeOnBreeze/cc-crossbeam

    Formats a draft corrections letter (markdown) into a professional PDF.

    293 GitHub stars~1.5k tokensUpdated 7 mo ago
    Documents & OfficeAuto-check passed
  • File Converter

    aiskillstore/marketplace

    This skill handles file format conversions across documents (PDF, DOCX, Markdown, HTML, TXT), data files (JSON, CSV, YAML, XML, TOML), and images (PNG, JPG, WebP, SVG, GIF).

    430 GitHub starsUsed in 1 repo~895 tokens
    Documents & OfficeAuto-check passed
  • 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
  • Any2pdf

    cosmicstack-labs/mercury-agent-skills

    Convert Markdown to publication-quality PDF with reportlab — CJK/Latin mixed text, themes, cover pages, watermarks, callouts, formulas, and interactive theme selection

    476 GitHub stars~3.3k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Markitdown

    ImCa0/just-laws

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

    781 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

More from staskh/trading_skills

All 28 skills in this repo
  • Fundamentals

    staskh/trading_skills

    Get fundamental financial data including financials, earnings, and key metrics.

    374 GitHub stars~836 tokensUpdated 9 days ago
    Auto-check passed
  • Greeks

    staskh/trading_skills

    Calculate option Greeks (delta, gamma, theta, vega) and implied volatility for specific options.

    374 GitHub stars~539 tokensUpdated 9 days ago
    Auto-check passed
  • Ib Account

    staskh/trading_skills

    Get account summary from Interactive Brokers including cash balance, buying power, and account value.

    374 GitHub stars~535 tokensUpdated 9 days ago
    Auto-check: notes
  • Ib Find Short Roll

    staskh/trading_skills

    Find roll options for existing short positions OR find best covered call/put to open against long stock.

    374 GitHub stars~1.2k tokensUpdated 9 days ago
    Auto-check: notes
  • Ib Option Chain

    staskh/trading_skills

    Get option chain data from Interactive Brokers for equities, ETFs, and futures (FOP), including calls and puts with strikes, bids, asks, volume, implied volatility, and model Greeks.

    374 GitHub stars~873 tokensUpdated 9 days ago
    Auto-check: notes
  • Ib Portfolio

    staskh/trading_skills

    Get portfolio positions from Interactive Brokers. An agent skill from staskh/trading_skills.

    374 GitHub stars~471 tokensUpdated 9 days ago
    Auto-check: notes

Works with

Questions about Markdown To PDF

What does Markdown To PDF do?

Convert a markdown file to PDF using mistune + reportlab. An agent skill from staskh/trading_skills. Markdown To PDF is an agent skill from staskh/trading_skills. Convert a markdown file to PDF using mistune + reportlab.

When should I use Markdown To PDF?

Markdown To PDF fits situations like: the user wants to convert a .md file to PDF; another skill needs to produce a PDF from markdown output.

How do I install Markdown To PDF in Claude Code?

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

How do I install Markdown To PDF in Codex?

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

Can I use Markdown To 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 staskh/trading_skills --skill markdown-to-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/markdown-to-pdf, .gemini/skills/markdown-to-pdf, .github/skills/markdown-to-pdf and .opencode/skills/markdown-to-pdf in your project.

What does Markdown To PDF need to run?

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

Does Markdown To PDF access the network?

SKILL.md contains no URLs. Its commands use uv and pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Markdown To 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 Markdown To PDF use?

Markdown To 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 Markdown To PDF use?

About 481 tokens (SKILL.md is roughly 1.9k 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 Markdown To PDF?

Skills that share tags, products or a category with Markdown To PDF: Adu Corrections PDF (mikeOnBreeze/cc-crossbeam, 293 stars), File Converter (aiskillstore/marketplace, 430 stars), Lov Any2pdf (lovstudio/any2pdf, 211 stars) and Any2pdf (cosmicstack-labs/mercury-agent-skills, 476 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Markdown To PDF?

staskh (a GitHub user) maintains it in staskh/trading_skills, which has 374 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on September 28, 2026.

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