---
name: "borb-declarative-pdf-creator"
description: "Create complex PDF documents using pure Python declarative components and layouts."
metadata:
  author: "Joris Schellekens"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "create pdf with borb python"
  - "generate barcode in pdf borb"
  - "use grid layout borb pdf"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# borb Declarative Python PDF Creator

Builds PDF documents with the modern borb library: FlexBox layouts, Grid layout managers, automated Barcode/QR code generation, Markdown rendering, and visual diffing.

## When to Invoke
Invoke this skill whenever you need to:
- create pdf with borb python
- generate barcode in pdf borb
- use grid layout borb pdf

## Execution SOP & Rules
1. Create a Document and add Page objects managed by PageLayout (e.g. SingleColumnLayout).
2. Add structured widgets like Paragraph, Table, and BarCode(value, BarCodeType.QR).
3. Utilize FlexibleGrid layout to arrange cards and widgets with responsive proportions.
4. Write output to disk using PDF.dumps(target_file, document).

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.