Fullbleed skill
Skill and MCP for building PDFs from HTML and CSS: the agent renders invoices and reports, previews pages and verifies the result.
- 170 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The engine reads and writes project files; the MCP adapter is confined to the `--root` folder.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/fullbleedDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The engine reads and writes project files; the MCP adapter is confined to the `--root` folder.
This is third-party code. Review the repository files before installing.
What it does
Fullbleed is a deterministic Rust engine that turns HTML and CSS into PDF for invoices, reports, statements and variable-data print jobs. The `skills/fullbleed/SKILL.md` skill tells an agent when to pick this engine and drives a render, preview, diagnose and verify loop. `fullbleed agent-manifest --json` prints the contract of the installed version: capabilities, CLI schema, PDF profiles, examples and limits. The separate `fullbleed-mcp` package exposes the same operations as MCP tools confined to the chosen project folder.
Who it is for. Developers and analysts who ask an agent to generate a print document from data: an invoice from JSON, a multi-page report, a batch of letters from one template.
Good fit when
- An invoice from JSON must come out identical on every run.
- A report spans many pages and the agent checks page breaks in previews.
- Hundreds of documents are produced from one template with data merged in.
- A Next.js or Node service needs a PDF download without an external PDF service.
- A document must meet a PDF/A, PDF/UA or PDF/X profile.
Not a fit when
- You need a screenshot or interactive state of a live site; use a browser for that.
- You must edit an existing PDF rather than build a new one from HTML.
- The layout relies on CSS features the engine does not support yet.
Example request
Build an invoice PDF from data.json using the HTML template, show a preview of page one and verify the result with diagnostics.Limitations
The release described in the README is `2.6.0a14`, and part of the component API is an opt-in alpha. Python, Node and .NET packages release independently, so check versions against the quickstarts. The engine implements a subset of CSS: diagnostics report differences rather than skipping silently. The MCP adapter is a separate package. For rarer CSS features, consult the project documentation.
How to disable. Delete the skill folder (for example `.agents/skills/fullbleed`) and the `fullbleed` and `fullbleed-mcp` packages. If you registered MCP, remove the server entry from client settings.
FAQ
How do I put the skill into a project?
Export it with `fullbleed agent export-skill .agents/skills/fullbleed --json` into an empty skills folder. `fullbleed agent skill-path --json` shows the bundle path inside the wheel.
Do I need MCP if the CLI exists?
No. An agent with shell access can call `fullbleed` directly. Install the separate `fullbleed-mcp` package for clients without a shell.
Where does the MCP server write files?
Only inside the folder given by `--root`. Each operation is delegated to the installed Fullbleed engine.
Are third-party PDF libraries required?
No. The Python wheel bundles the engine, fonts and CLI with no required dependencies or system PDF stack.
Is it a paid service?
No, the project is MIT licensed. Rendering runs locally and documents are not uploaded anywhere.
Discussion
No questions or reviews yet.
Related
SkillsThe agent turns rich answers, files, folders and service exports into an HTML page in a ready style, checked in a browser
A CLI and skill for an agent to publish reports and specs as HTML documents that a team comments on, with every version kept
A skill that typesets resumes, one-pagers, letters, reports and slides from templates into PDF, PNG and PPTX and checks the result before delivery
A skill, an MCP server and a CLI turn Markdown from an agent into a short link to a web page that opens without signing in.
office-oxide-mcp: Office and PDF for AI agents
office-oxide-mcp
A Rust MCP server that reads and creates Excel, Word, PowerPoint and PDF locally and fills PDF forms after your approval
A zero-key, zero-dependency skill and CLI that turns PDF, Office and image files into Markdown via MinerU's cloud.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Fullbleed (this card) | no | not required | 170 | |
| pdfcpu | no | 8,906 | pdfcpu validates, merges and splits existing PDFs; Fullbleed creates a new document from HTML and CSS | |
| pdf-mcp | no | not required | 171 | pdf-mcp reads large existing PDFs; Fullbleed builds documents from a template and data |
README in short
The engine builds PDFs from HTML and CSS with no browser and no system PDF stack. For agents it ships a skill, a machine contract per version and an MCP adapter.