pinit-workflow

Coordinate pinit annotation placement and debugging in Typst documents.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/ArneBroedel/Book-Layouting-Typst --skill pinit-workflow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pinit-workflow
Source: https://github.com/ArneBroedel/Book-Layouting-Typst/tree/main/.github/skills/pinit-workflow
Command: npx skills add https://github.com/ArneBroedel/Book-Layouting-Typst --skill pinit-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Place, debug, and fix pinit annotations in Typst documents with a repeatable, strategy-driven workflow. It guides users through pin placement, highlight and box rendering, and robust positioning when edits cause drift, multi-pin scenarios, or container pagination. It also covers the full debug lifecycle, including coordinate grids, midpoint-based offsets for multiple pins, and safe transitions between placement strategies.

Core Features & Use Cases

  • Systematic placement strategies (Recipes A, B, and C) for robust annotation positioning across changes and layouts.
  • Debug workflows with coordinate grids and debug modules to read exact pin and box coordinates.
  • Handling multi-pin anchors via geometric midpoints and precise offset calculations for stable labeling, margins, or side notes.
  • Safe recovery patterns to switch between pin-relative and absolute-placement approaches to preserve layout integrity.

Quick Start

Start by placing a pin, add a highlight and a box, then use pinit-point-from to position the annotation relative to the pin.

Frequently Asked Questions about pinit-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix misaligned pinit annotations in Typst when document edits cause position drift?▼

To fix misaligned Typst pinit annotations caused by edit drift, use a debug workflow with coordinate grids to read exact pin and box coordinates, then apply strategy-driven placement recipes to stabilize positioning across layout changes.

What is the best way to handle multiple pin anchors in Typst without overlapping labels?▼

Handling multiple pinit anchors in Typst requires calculating geometric midpoints between pins and applying precise offset calculations to ensure stable labeling, margins, or side notes without overlapping annotations.

How do I debug coordinate placement for pinit boxes and highlights in Typst?▼

Debugging coordinate placement for pinit boxes in Typst involves enabling a coordinate grid debug module to read exact pin and box coordinates, allowing you to verify alignment and adjust midpoint-based offsets for accurate annotation rendering.

When should I switch between pin-relative and absolute placement strategies for Typst annotations?▼

Switch between pin-relative and absolute placement strategies for Typst annotations when container pagination or multi-pin scenarios disrupt layout integrity, using safe recovery patterns to preserve precise alignment across document edits.

Can I use pinit annotations across paginated containers in Typst without breaking the layout?▼

Yes, pinit annotations can work across paginated containers in Typst by using systematic placement strategies and safe recovery patterns to switch between pin-relative and absolute approaches, ensuring robust positioning when container pagination occurs.

What are Recipes A, B, and C for positioning pinit annotations in Typst?▼

Recipes A, B, and C are systematic placement strategies for Typst pinit annotations that provide robust positioning across layout changes, covering pin-relative offsets, absolute placement, and multi-pin anchor scenarios to maintain annotation alignment.