Harness Book Best Practice
wquguru/harness-books
Best practices for working on the Harness books repo. An agent skill from wquguru/harness-books.
A skill your agent uses when rendering a Markdown document (English or Korean) such as a proposal, IRB cover letter, handout or reference table to PDF via pandoc and xelatex, with auto-fitted table…
$ npx skills add Aperivue/medsci-skills --skill render-pdf-doc -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Aperivue/medsci-skills render-pdf-doc --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Aperivue/medsci-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/render-pdf-doc .claude/skills/render-pdf-doc && rm -rf skills-srcUse ~/.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/
Install the "render-pdf-doc" agent skill from https://github.com/Aperivue/medsci-skills/tree/main/skills/render-pdf-doc into .claude/skills/render-pdf-doc/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "render-pdf-doc", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Aperivue/medsci-skills/tree/main/skills/render-pdf-docType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Aperivue/medsci-skills --skill render-pdf-doc -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Aperivue/medsci-skills render-pdf-doc --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Aperivue/medsci-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/render-pdf-doc .agents/skills/render-pdf-doc && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "render-pdf-doc" agent skill from https://github.com/Aperivue/medsci-skills/tree/main/skills/render-pdf-doc into .agents/skills/render-pdf-doc/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "render-pdf-doc", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Aperivue/medsci-skills --skill render-pdf-doc -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Aperivue/medsci-skills render-pdf-doc --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Aperivue/medsci-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/render-pdf-doc .cursor/skills/render-pdf-doc && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "render-pdf-doc" agent skill from https://github.com/Aperivue/medsci-skills/tree/main/skills/render-pdf-doc into .cursor/skills/render-pdf-doc/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "render-pdf-doc", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Aperivue/medsci-skills.git --path skills/render-pdf-doc--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Aperivue/medsci-skills --skill render-pdf-doc -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Aperivue/medsci-skills render-pdf-doc --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Aperivue/medsci-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/render-pdf-doc .gemini/skills/render-pdf-doc && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "render-pdf-doc" agent skill from https://github.com/Aperivue/medsci-skills/tree/main/skills/render-pdf-doc into .gemini/skills/render-pdf-doc/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "render-pdf-doc", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Aperivue/medsci-skills render-pdf-docInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Aperivue/medsci-skills --skill render-pdf-doc -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Aperivue/medsci-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/render-pdf-doc .github/skills/render-pdf-doc && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "render-pdf-doc" agent skill from https://github.com/Aperivue/medsci-skills/tree/main/skills/render-pdf-doc into .github/skills/render-pdf-doc/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "render-pdf-doc", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Aperivue/medsci-skills --skill render-pdf-doc -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Aperivue/medsci-skills render-pdf-doc --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Aperivue/medsci-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/render-pdf-doc .opencode/skills/render-pdf-doc && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "render-pdf-doc" agent skill from https://github.com/Aperivue/medsci-skills/tree/main/skills/render-pdf-doc into .opencode/skills/render-pdf-doc/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "render-pdf-doc", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
render-pdf-docA skill your agent uses when rendering a Markdown document (English or Korean) such as a proposal, IRB cover letter, handout or reference table to PDF via pandoc and xelatex, with auto-fitted table…
Render PDF Doc is an agent skill from Aperivue/medsci-skills. Use when rendering a Markdown document (English or Korean) such as a proposal, IRB cover letter, handout or reference table to PDF via pandoc and xelatex, with auto-fitted table widths and CJK fonts. Not for manuscripts with a bibliography (/manage-refs) or Word forms.
Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 25 other files, including scripts and reference files (for example `references/known_pitfalls.md`, `references/pandoc_korean_cheatsheet.md` and `scripts/check_deps.sh`).
It sits in Documents & Office, covering PDF, Citation management and Resume and CV writing. It works with LaTeX and Pandoc. The repository describes itself as: Agent Skills for medical research — literature search, reporting-guideline & citation checks, statistics, publication figures, submission. Works with Claude Code, Codex, Cursor &… The licence is MIT.
5 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 3b14ae2. It shows what the files ask for, not the result of running them.
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.
Ships 4 files in scripts/ (Shell and Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
python3bashbrewwingetapt-getFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Render PDF Doc loads about 2.1k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 901 words of instructions outside code blocks.
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.
The automated check noted patterns worth knowing about, such as sudo or a known installer.
sudo apt-get install pandoc texlive-xetex texlive-lang-cjk fonts-noto-cjkAutomated 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.
The full file from Aperivue/medsci-skills at commit 3b14ae2, republished under its MIT licence (© Aperivue). 901 words, ~2,062 tokens.
.claude/skills/render-pdf-doc/SKILL.md (or your agent's skills folder). This skill also uses 21 other files; get the full folder from GitHub.This skill handles layout only (CJK fonts, table column widths) with raw pandoc + xelatex — no
Quarto, whose tbl-colwidths has reported PDF regressions (issues 6089/9200). Not for: a
manuscript with a bibliography (/manage-refs scripts/render_pandoc.sh), an institutional .docx
form (/fill-protocol), the ICMJE COI form (/fill-icmje-coi), figures or PPTX (/make-figures,
/present-paper).
Python 3 is required by the wrapper. FontTools is optional for the font-file
coverage check (python3 -m pip install fonttools).
# macOS
brew install pandoc
brew install --cask mactex-no-gui # xelatex + xeCJK (~5 GB)
# Linux
sudo apt-get install pandoc texlive-xetex texlive-lang-cjk fonts-noto-cjk
# Windows (PowerShell) — run in Git Bash afterwards
winget install --id JohnMacFarlane.Pandoc
winget install --id MiKTeX.MiKTeX # xelatex; installs missing LaTeX packages on demand
# No CJK font download needed: Malgun Gothic ships with Windows 7+ and is the default here.Detection:
bash scripts/check_deps.shOn Windows / Git Bash, MiKTeX's bin directory
(%LOCALAPPDATA%\Programs\MiKTeX\miktex\bin\x64) is often not on PATH; both check_deps.sh
and render_pdf.sh probe it. If xelatex still reads [MISS], add that directory to PATH.
---
title: "Paper 2 Calibration Anchor — Q&A Grid"
author: "<Author Group>"
date: "2026-05-01"
mainfont: "Apple SD Gothic Neo" # macOS default
CJKmainfont: "Apple SD Gothic Neo"
geometry: "margin=0.85in"
fontsize: 11pt
linestretch: 1.25
colorlinks: true
---mainfont and CJKmainfont: without CJKmainfont, Hangul falls back to Times New
Roman (broken glyphs or blanks). Use Noto Sans CJK KR on Linux/CI and Malgun Gothic on
Windows; the render script auto-detects the per-OS default when the fields are absent..docx or .eml a co-author sent) unmodified as its own artifact — the
PDF is a derivative, and the next round is diffed against the source. If that source was
AI-drafted by a collaborator, re-derive every number, denominator and author-year in it from
the underlying paper or analysis output before it reaches the PDF.Never split pipe-table columns equally: a column holding only short labels then gets the same width as the data columns, which cramps them. Size from content instead:
python3 scripts/infer_colwidths.py input.md > input.colwidths.mdFor each pipe table it computes per-column display width = max(len(header), max(len(cell)))
(CJK = 2 cells, ASCII = 1) and rewrites the separator row with proportional dash counts. To set
widths by hand, write the separator dashes yourself and render without --infer-colwidths.
bash scripts/render_pdf.sh -i input.colwidths.md -o output.pdfOr one-shot:
bash scripts/render_pdf.sh -i input.md -o output.pdf --infer-colwidthsFrontmatter wins over wrapper defaults, including --font / --cjk-font.
Missing fields use the wrapper or OS defaults. This also applies to geometry,
fontsize, linestretch and colorlinks (including false). Explicit pandoc
-V / -M arguments after -- still override frontmatter; for example,
-- -V fontsize=10pt. The wrapper logs font fallbacks, not the final fonts.
The standard article class honours only 10pt, 11pt and 12pt and silently
ignores any other size. When the effective fontsize is anything else and no
documentclass is set, the wrapper switches to KOMA-Script scrartcl (pandoc's
documented route), adds classoption: fontsize=<size> when you set no
classoption (KOMA reads a fractional size such as 8.5pt only that way), and
logs the switch. Set documentclass yourself to override it.
xelatex can finish successfully with missing glyphs. render_pdf.sh counts the
Missing character warnings pandoc relays: if there are any, it lists each glyph
(code point, count, font) and exits 4 — the PDF is written but incomplete. It reads them from
pandoc's JSON --log (yours if you pass one after --), so a pass-through --quiet does not
hide them.
--allow-missing-glyphs prints the same list and exits 0. Academic markdown
routinely carries glyphs a default Latin font misses: transition arrows (→ ↑ ↓),
math operators (− ≤ ≥ ± √ ∪ × ≈ ≠), stats Greek (κ μ σ β), bullets/marks (• ★ ✓),
and CJK. Scan the source first so a silent drop is caught before it ships:
python3 scripts/scan_glyph_coverage.py input.md --strict
# real cmap check when you have the font file + fonttools:
python3 scripts/scan_glyph_coverage.py input.md --font "/path/to/body.otf" --strict
# TTC/OTC collections require the zero-based face index used by the renderer:
python3 scripts/scan_glyph_coverage.py input.md --font "/path/to/body.ttc" --font-index 0 --strict --json glyphs.jsonWithout --font it groups the risky glyphs by class (advisory); with --font + fonttools it
checks every non-ASCII character of the source that the font is asked to draw — not only the
five classes, so °, µ, ², ‰, ∞ and – are covered too — and reports which are absent
from one face's preferred Unicode cmap (format characters such as a BOM or zero-width joiner, and
the no-break spaces and … that pandoc writes as ASCII TeX, are not looked up), never combining coverage across
collection faces — choose the face (index and PostScript name are in the report) that matches the
rendered font. A missing dependency, unreadable font, missing face selection or invalid index is
reported as font_checked: false with a reason in font_check; an empty missing_in_font list
then means unverified, not full coverage. Default mode exits 0; --strict exits 1 when risky
glyphs are unverified or missing (ASCII-only input still exits 0). The scan does not verify
shaping, fallback fonts, math fonts or final PDF glyphs.
If risky glyphs are present, make sure mainfont/CJKmainfont cover them — a CJK-capable font
such as Apple SD Gothic Neo / Noto Sans CJK usually covers arrows and Hangul but can still
miss the true-minus − U+2212 and ★. The DOCX is authoritative; the PDF is a convenience
copy — never let a PDF render drop a glyph the document needs.
Open the PDF and check:
CJKmainfont was not applied).Read references/known_pitfalls.md when a render still looks wrong (em-dash overflow, smart
quotes under CJKmainfont, | inside a cell), and references/pandoc_korean_cheatsheet.md for
Korean frontmatter and font patterns.
Starter markdown in templates/ (English default; a Korean variant *_ko.md ships alongside
each), with slots marked <!-- TODO: -->:
anchor-doc.md — Q&A gridproposal-cover.md — research-proposal cover pagebriefing-handout.md — meeting brief (1-page)reference-table.md — comparison-table format© Aperivue, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 21 other files (scripts, references) in skills/render-pdf-doc of Aperivue/medsci-skills.
Open the folder on GitHubat commit 3b14ae2
Render PDF Doc 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Render PDF Doc this skillAperivue/medsci-skills | 329 | — | ~2.1k | Automated safety check: Notes | MIT | |
| Harness Book Best Practicewquguru/harness-books | 3.2k | — | ~4.1k | Automated safety check: Pass | None | |
| Pandic OfficeTeam-Commonly/commonly | 1.4k | — | ~642 | Automated safety check: Pass | Apache-2.0 | |
| Pdf2texCalix-L/awesome-latex-skills | 180 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Evidence Ledgerwanshuiyin/Anti-Autoresearch | 161 | — | ~11k | Automated safety check: Notes | MIT | |
| Literature Statisticsaipoch/medical-research-skills | 2k | — | ~1.9k | Automated safety check: Pass | MIT |
wquguru/harness-books
Best practices for working on the Harness books repo. An agent skill from wquguru/harness-books.
Team-Commonly/commonly
Convert Markdown to PDF (or DOCX/EPUB/HTML) using the pandoc CLI.
Calix-L/awesome-latex-skills
Reconstruct editable LaTeX from PDF content using page-aware extraction and visual comparison.
wanshuiyin/Anti-Autoresearch
Build the deterministic evidence ledger (artifactmanifest.json + claims.json) that every other Anti-Autoresearch auditor reads.
aipoch/medical-research-skills
Generate statistics for publication-year and journal distributions from local references or PDFs; use when you need standardized Year/Journal tables and a summary without any network access.
brycewang-stanford/Auto-Empirical-Research-Skills
Cleans a Quarto (.qmd) file by replacing LaTeX holdovers with proper Quarto/Pandoc syntax so the document renders correctly to HTML, PDF (Typst/LaTeX), and Word.
Aperivue/medsci-skills
A skill your agent uses when validating or evaluating a trained medical-imaging model.
Aperivue/medsci-skills
A skill your agent uses when turning a folder of research PDFs into Obsidian notes, even if Obsidian is not named.
Aperivue/medsci-skills
A skill your agent uses when building or auditing a radiomics or tabular clinical-ML prediction model with a classical learner (LASSO, SVM, random forest, XGBoost and similar).
Aperivue/medsci-skills
A skill your agent uses when checking whether a manuscript's references are real.
Aperivue/medsci-skills
A skill your agent uses when a clinical CSV/Excel dataset needs profiling and cleaning before analysis (missing values, outliers, duplicates, type mismatches).
Aperivue/medsci-skills
A skill your agent uses when checking a radiology or medical AI study design before drafting or submission.
Categories
A skill your agent uses when rendering a Markdown document (English or Korean) such as a proposal, IRB cover letter, handout or reference table to PDF via pandoc and xelatex, with auto-fitted table…. Render PDF Doc is an agent skill from Aperivue/medsci-skills. Use when rendering a Markdown document (English or Korean) such as a proposal, IRB cover letter, handout or reference table to PDF via pandoc and xelatex, with auto-fitted table widths and CJK fonts.
Render PDF Doc fits situations like: rendering a Markdown document (English; korean) such as a proposal; IRB cover letter; reference table to PDF via pandoc and xelatex.
Run `npx skills add Aperivue/medsci-skills --skill render-pdf-doc -a claude-code`. Or copy the skill folder (skills/render-pdf-doc in Aperivue/medsci-skills) into .claude/skills/render-pdf-doc in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Aperivue/medsci-skills --skill render-pdf-doc -a codex`. Or copy the skill folder (skills/render-pdf-doc in Aperivue/medsci-skills) into .agents/skills/render-pdf-doc in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Aperivue/medsci-skills --skill render-pdf-doc -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/render-pdf-doc, .gemini/skills/render-pdf-doc, .github/skills/render-pdf-doc and .opencode/skills/render-pdf-doc in your project.
Going by SKILL.md and its folder, Render PDF Doc needs a shell and Python for the scripts in its folder and the command-line tools its instructions call (python3, bash, brew, winget and apt-get). Our summary lists: Python 3; A Bash shell.
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.
Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. 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.
Render PDF Doc is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.1k tokens (SKILL.md is roughly 8.2k 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 1.2k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Render PDF Doc: Harness Book Best Practice (wquguru/harness-books, 3.2k stars), Pandic Office (Team-Commonly/commonly, 1.4k stars), Pdf2tex (Calix-L/awesome-latex-skills, 180 stars) and Evidence Ledger (wanshuiyin/Anti-Autoresearch, 161 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Aperivue (a GitHub organization) maintains it in Aperivue/medsci-skills, which has 329 GitHub stars. The repository holds 54 skills in this directory. The repository was last updated on October 5, 2026.
Source: Aperivue/medsci-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.