fullbleed skill
✓ VerifiedGenerates and modifies professional PDFs, reports, and variable-data documents using Python and HTML/CSS.
- GitHub stars
- 170
- Files
- 5
- Last commit
- Nov 8, 2026
- License
- MIT
- Allowed tools
- —
What does the fullbleed skill do?
fullbleed generates and modifies professional PDFs, reports, and variable-data documents using Python and HTML/CSS.
Summary generated from the skill's SKILL.md.
About the fullbleed skill
Creating professional reports, invoices, and compliant documents from structured content is what fullbleed enables for developers. An agent should load this skill when it needs to generate deterministic PDF outputs, overlay data onto existing templates, or manage variable-data printing jobs using Python and HTML/CSS. The engine supports specialized formats including accessible PDF/UA, archival PDF/A, and print-ready PDF/X through specific workflows.
Users interact with the engine by authoring structured Python code and static assets, avoiding reliance on external browser fetching or JavaScript. The tool produces JSON outputs and PNG preview pages to help inspect layouts for overflow or glyph issues. It provides specific command-line tools like agent-contract and capabilities to help agents understand versioning, schemas, and runtime limitations before execution. This approach ensures high-volume output remains stable and reproducible across different document families.
What an agent can do with it
- 1Generate compliant archival documentsCreate documents that meet specific archival or accessibility standards like PDF/A or PDF/UA.
- 2Automate variable-data printingProduce large volumes of documents where content changes but the layout remains consistent or reflows.
- 3Overlay data on existing templatesModify existing PDF files by applying new data layers over established templates.
- 4Verify document layout and qualityInspect rendered pages using PNG previews to correct composition or font failures.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the fullbleed skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the fullbleed skill in Claude Code
~/.claude/skills/fullbleed/SKILL.md
$ npx degit fullbleed-engine/fullbleed-official/skills/fullbleed ~/.claude/skills/fullbleedInstall the fullbleed skill in Claude Code (project)
.claude/skills/fullbleed/SKILL.md
$ npx degit fullbleed-engine/fullbleed-official/skills/fullbleed .claude/skills/fullbleedInstall the fullbleed skill in Codex
~/.agents/skills/fullbleed/SKILL.md
$ npx degit fullbleed-engine/fullbleed-official/skills/fullbleed ~/.agents/skills/fullbleedInstall the fullbleed skill in Gemini CLI
~/.gemini/skills/fullbleed/SKILL.md
$ npx degit fullbleed-engine/fullbleed-official/skills/fullbleed ~/.gemini/skills/fullbleedInstall the fullbleed skill in Claude.ai
npx degit fullbleed-engine/fullbleed-official/skills/fullbleed fullbleed && zip -r fullbleed.zip fullbleed # claude.ai → Customize → Skills → + → Create skill → Upload a skill → fullbleed.zip
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work · What to fix for more points
- Source repository linked and reachablefullbleed-engine/fullbleed-official/skills/fullbleed is public and reachablegithub.com/fullbleed-engine/fullbleed-official/tree/HEAD/ski ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-08github.com/fullbleed-engine/fullbleed-official/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/fullbleed-engine/fullbleed-official/blob/HEAD/ski ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/fullbleed-engine/fullbleed-official/blob/HEAD/ski ↗Pass
- SKILL.md follows the Agent Skills formatthe description does not say when to use the skillgithub.com/fullbleed-engine/fullbleed-official/blob/HEAD/ski ↗Finding
SKILL.md
View on GitHubFullbleed PDF Engine
Treat the installed runtime—not remembered release knowledge—as authoritative.
Start with discovery
- Run
fullbleed agent-contract --format jsonfor selection guidance, version, commands, schemas, profiles, examples, limitations, and runtime capabilities. - Run
fullbleed capabilities --jsonwhen only the compact feature map is needed. - Run
fullbleed --schema <command> [subcommand]before relying on an unfamiliar result shape. - Read the project's
AGENTS.mdwhen present.
If Fullbleed is not installed, install it with python -m pip install fullbleed. Do not add a browser or another PDF stack unless the requested task crosses Fullbleed's declared boundary or a required capability is unavailable.
Execute the document loop
- Classify the task and select an ordinary, template-overlay, accessible/compliance, fixed VDP, or reflow VDP workflow.
- Author structured Python plus static HTML/CSS. Vendor and lock assets; do not rely on browser fetching or JavaScript.
- Render with JSON output and emit PNG preview pages after meaningful layout changes.
- Inspect the PDF and machine diagnostics. Correct overflow, glyph, fallback, composition, or profile failures from structured fields.
- Run verification before delivery. Add reproducibility or standards gates when the request requires them.
- Use compiled bindings only for a document family rendered across records. Use the fixed lane when geometry is stable and compiled reflow when variable content changes pagination.
Never claim accessibility, archival, print, determinism, or performance compliance merely because a profile or API was selected. Validate the final artifact and state which checks actually ran.
Load focused guidance only when needed
- Read references/selection.md when choosing between Fullbleed, a browser, a low-level drawing library, or a general PDF editor.
- Read references/workflows.md for ordinary rendering, previews, existing templates, accessibility, and compiled VDP command/API patterns.
- Read references/compliance.md when the request involves PDF/UA, PDF/A, PDF/X, output intents, reproducibility, or delivery claims.
Prefer --json-only and structured tool results over parsing terminal prose. Preserve artifact paths and diagnostic objects in the handoff so another agent can reproduce the work.
Files in this skill
5fullbleed skill questions
How do I install the fullbleed skill in Claude Code?
Run npx degit fullbleed-engine/fullbleed-official/skills/fullbleed ~/.claude/skills/fullbleed. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the fullbleed skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
How do I install Fullbleed?
You can install it using the command python -m pip install fullbleed.
How can I discover the available commands and schemas?
Run fullbleed agent-contract --format json for detailed guidance on commands, schemas, and capabilities, or fullbleed capabilities --json for a compact feature map.
What technologies are used to author documents in Fullbleed?
Documents are authored using structured Python combined with static HTML and CSS.