New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Document Converter

by BlackBeltTechnology in BlackBeltTechnology/pi-agent-dashboard

Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC…

MITAuto-check passedDocuments & Office

Install Document Converter

skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill document-converter -a claude-code

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

GitHub CLI
$ gh skill install BlackBeltTechnology/pi-agent-dashboard document-converter --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/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/document-converter/.pi/skills/document-converter .claude/skills/document-converter && 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
document-converter
GitHub stars
315
Token cost
~999 tokens
SKILL.md length
234 words
Files
1
Skills in repo
66
Repo updated
First seen
Licence
MIT

At a glance

Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC…

  • Tasks that involve PDF
  • SKILL.md covers Prerequisites, Two directions, Frontmatter tooling (the… and Errors
  • Calls docker and npm; needs GEMINI_API_KEY
  • Tasks that involve Word documents

What it does

Document Converter is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC and round-trip merge. Use on "convert this PDF to markdown", "ingest these docs into kb", "make a DOCX from markdown with our template", "render this spec to PDF", "OCR this scanned PDF".

Its SKILL.md is about 1000 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, Word documents and Document parsing. It works with Microsoft Word, Microsoft Excel, Microsoft PowerPoint and Google Gemini. The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is MIT.

When your agent uses it

  • Tasks that involve PDF
  • Tasks that involve Word documents
  • Tasks that involve Document parsing

Example prompts

  • “convert this PDF to markdown”
  • “ingest these docs into kb”
  • “make a DOCX from markdown with our template”
  • “/document-converter”

Requirements

  • Python 3
  • Docker
  • A credential in GEMINI_API_KEY

What it can do on your machine

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

    • docker
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use docker and npm, 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 these keys or tokens, usually read from environment variables:

    • GEMINI_API_KEY

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

Context cost

Document Converter loads about 999 tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 234 words of instructions outside code blocks.

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

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 BlackBeltTechnology/pi-agent-dashboard at commit 86e8e4d, republished under its MIT licence (© BlackBeltTechnology). 234 words, ~999 tokens.

Download SKILL.mdSave it as .claude/skills/document-converter/SKILL.md (or your agent's skills folder).
name
document-converter
description
Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC and round-trip merge. Use on "convert this PDF to markdown", "ingest these docs into kb", "make a DOCX from markdown with our template", "render this spec to PDF", "OCR this scanned PDF".

Document Converter

TypeScript facade (@blackbelt-technology/pi-dashboard-document-converter) over the Dockerized pi-doc-engine Python engine. Always call the facade — never Python, docling, pandoc, or the nano-banana CLI directly. The engine is quarantined in Docker; the facade is the only call surface.

Internals reference: packages/document-converter/README.md (facade API), packages/document-converter/engine/README.md (JSON docker run contract). Do NOT read the vendored Python under engine/document_converter/.

Prerequisites

  • Docker available; image built: cd packages/document-converter && npm run build:image. The pi.tools manifest (package root) declares pi-doc-engine as a docker-image probe — pi-dashboard-ensure <package-root>/package.json reports image presence and the first-party build hint (confirm-gated) via the registry's Settings → Tools row.
  • Styled diagrams (nano-banana) need GEMINI_API_KEY at run time; absent or on failure, rendering falls back to mmdc (never hard-fails).

Two directions

Ingest — any format → Markdown for kb
ts
import { createDocumentConverter } from "@blackbelt-technology/pi-dashboard-document-converter";
const dc = createDocumentConverter({
  image: "pi-doc-engine:0.1.0",
  stagingDir: "/abs/kb-staging",
  mounts: ["/docs"],   // files outside cwd need a root (mounts or workspaceRoot), else PATH_NOT_ALLOWED
});

await dc.convertToMarkdown("/docs/report.pdf");                       // digital PDF (auto: native-first)
await dc.convertToMarkdown("/docs/scan.pdf", {                        // scanned HU PDF
  ocr: { mode: "force", lang: ["hungarian", "english"], engine: "tesseract" },
});
await dc.convertToMarkdown("/docs/huge.pdf", { tables: "off" });      // escape hatch: skip TableFormer

Output .md lands in stagingDir with provenance frontmatter. Feed kb via its existing filesystem source (kb is NOT modified):

bash
kb index  --source /abs/kb-staging
kb search "<query>" --source /abs/kb-staging

OCR lang takes canonical names ("hungarian"); the facade maps to per-engine codes. A wrong name raises OCR_LANG_UNSUPPORTED — no silent empty OCR. Default mode: auto skips OCR on digital PDFs.

Produce — Markdown → DOCX/PDF
ts
await dc.renderDocx("/spec.md", { output: "/spec.docx", template: "default" });
await dc.renderDocx("/spec.md", { output: "/spec.docx", nanoBanana: { enabled: true, style: "ros-3d" } });
await dc.renderPdf("/spec.docx", { output: "/spec.pdf", pageSize: "a4" });

const { meta } = await dc.extractForEdit("/in.docx", "/edit.md");     // round-trip
await dc.mergeBack("/in.docx", "/edit.md", { output: "/out.docx", meta });

Template vars come from frontmatter. Diagrams render with mmdc by default; opt in to styled images per-doc via nanoBanana (md5-cached .mermaid-cache/<md5>.png, deterministic, mmdc fallback).

Frontmatter tooling (the shared bus)

ts
await dc.fillFrontmatter(["spec/**/*.md"], { language: "hu" });       // defaults + language packs + globs
await dc.profileTables(["spec/**/*.md"]);                             // inject table_profiles width ratios

All stages read/write one unified schema (./schema): template vars · table_profiles · nano_banana · provenance.

Errors

Every method rejects with DocConverterError (.code, .stderr, .exitCode): UNSUPPORTED_FORMAT, PATH_NOT_ALLOWED, OCR_LANG_UNSUPPORTED, INGEST_FAILED, PRODUCE_FAILED, DOCKER_UNAVAILABLE, … Surface .code + .stderr; do not retry blindly.

© BlackBeltTechnology, 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 packages/document-converter/.pi/skills/document-converter of BlackBeltTechnology/pi-agent-dashboard.

Open the folder on GitHubat commit 86e8e4d

Compare with similar skills

Document Converter 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.

Document Converter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Document Converter this skillBlackBeltTechnology/pi-agent-dashboard315—~999Automated safety check: PassMIT
Markdown ConverterTeam-Commonly/commonly1.4k—~557Automated safety check: PassApache-2.0
Markdown Exporterbowenliang123/markdown-exporter2721 repos~5.3kAutomated safety check: PassApache-2.0
MarkitdownImCa0/just-laws78214 repos~3.2kAutomated safety check: NotesMIT
To MarkdownMathews-Tom/armory328—~2kAutomated safety check: PassMIT
MineruNebutra/MinerU-Skill122—~1.4kAutomated safety check: PassMIT

Similar skills

  • Markdown Converter

    Team-Commonly/commonly

    Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's markitdown Python tool.

    1.4k GitHub stars~557 tokensUpdated today
    Documents & OfficeAuto-check passed

  • Markdown Exporter

    bowenliang123/markdown-exporter

    Convert Markdown text to DOCX, PPTX, XLSX, PDF, PNG, SVG, HTML, IPYNB, MD, CSV, JSON, JSONL, XML files, and extract code blocks in Markdown to Python, Bash,JS and etc files.

    272 GitHub starsUsed in 1 repo~5.3k tokens
    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

  • To Markdown

    Mathews-Tom/armory

    Convert any file or URL to clean Markdown: PDF, DOCX, XLSX, PPTX, HTML, images (OCR), audio, CSV, YouTube.

    328 GitHub stars~2k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed

  • Mineru

    Nebutra/MinerU-Skill

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

    122 GitHub stars~1.4k tokensUpdated 15 days ago
    Documents & OfficeAuto-check passed

  • Docling

    zhuzhaoyun/Molio

    PRIMARY skill for converting .pdf, .docx, .pptx, .xlsx, .doc, .ppt, .xls, images, and audio/video files (.mp3, .wav, .m4a, .mp4, .mov, etc.) to Markdown.

    433 GitHub stars~2.6k tokensUpdated today
    Documents & OfficeAuto-check passed

More from BlackBeltTechnology/pi-agent-dashboard

All 66 skills in this repo

  • Browser

    BlackBeltTechnology/pi-agent-dashboard

    Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    315 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • CI Troubleshoot

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…

    315 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

  • Debug Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries.

    315 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Implement

    BlackBeltTechnology/pi-agent-dashboard

    Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.

    315 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • Pi Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Monitor and control the pi-dashboard server. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    315 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

  • Session To Guideline

    BlackBeltTechnology/pi-agent-dashboard

    Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…

    315 GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Document Converter

What does Document Converter do?

Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC…. Document Converter is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC and round-trip merge.

When should I use Document Converter?

Document Converter fits situations like: tasks that involve PDF; tasks that involve Word documents; tasks that involve Document parsing.

How do I install Document Converter in Claude Code?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill document-converter -a claude-code`. Or copy the skill folder (packages/document-converter/.pi/skills/document-converter in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/document-converter in your project. Claude Code loads it when a task matches its description.

How do I install Document Converter in Codex?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill document-converter -a codex`. Or copy the skill folder (packages/document-converter/.pi/skills/document-converter in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/document-converter in your project. Codex loads it when a task matches its description.

Can I use Document Converter 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 BlackBeltTechnology/pi-agent-dashboard --skill document-converter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/document-converter, .gemini/skills/document-converter, .github/skills/document-converter and .opencode/skills/document-converter in your project.

What does Document Converter need to run?

Going by SKILL.md and its folder, Document Converter needs the command-line tools its instructions call (docker and npm) and credentials named GEMINI_API_KEY. Our summary lists: Python 3; Docker; A credential in GEMINI_API_KEY.

Does Document Converter access the network?

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

Is Document Converter 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 Document Converter use?

Document Converter 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 Document Converter use?

About 999 tokens (SKILL.md is roughly 4k 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 Document Converter?

Skills that share tags, products or a category with Document Converter: Markdown Converter (Team-Commonly/commonly, 1.4k stars), Markdown Exporter (bowenliang123/markdown-exporter, 272 stars), Markitdown (ImCa0/just-laws, 782 stars) and To Markdown (Mathews-Tom/armory, 328 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Document Converter?

BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on October 8, 2026.

Source: BlackBeltTechnology/pi-agent-dashboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.