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.