dsh-swiss-grid

dsh-swiss-grid

A [DeepSeek Harness](https://github.com/deepseek-ai) plugin that adds the **Swiss grid design

system** to your agent: compute a page grid (版心, columns, baseline, type scale), then build

print-ready SVG → PDF posters, book spreads, magazine pages and exhibition graphics, plus

the grid-overlay proof that shows the layout really snaps to the grid.

The skill is a distilled, executable summary of Josef Müller-Brockmann's *Grid systems in

graphic design* (1961/1981) — not a scan, not a reprint: a method reference, parameter tables

and a small rendering toolchain.

What you get

• Skill swiss-grid-design — rules, workflow, geometry/type cheat sheet, QA gate.
• References — the method, formats & scaling tables (A4–A0, 8/20/32-cell systems),

the SVG→PDF output pipeline with pitfalls, the delivery checklist, layout recipes.

• Zero-dependency tools
• poster_builder.py — parametric A-series poster builder (bleed, crop marks, grid proof,

PDF via Edge/Chromium, metadata/TrimBox finalisation);

• grid_calculator.py — geometry and type-scale calculator, JSON output;
• verify_print_pdf.py — page size, TrimBox/BleedBox, Type0 fonts, crop marks.
• Example output — preview and spec included; PDFs are generated locally.

Install

As a DSH plugin (recommended)

From GitHub (pnpm accepts github: sources):

dsh plugin --profile desktop add github:summersummer-liu/dsh-swiss-grid

From npm, once published:

dsh plugin add dsh-swiss-grid

Then restart dsh web (or the desktop app) once so the profile composes the new bundle. The

skill appears in the catalog as swiss-grid-design; invoke it with /swiss-grid-design or

just ask for a poster / grid layout.

> Replace OWNER with the GitHub account that hosts the repo. The plugin is a standard DSH

> bundle: package.json → dsh.bundle.patch → cordis.patch.yml → index.js registers the

> bundled skills/*/SKILL.md on ctx.skills.

As a plain skill

If you only want the skill (no plugin system), copy the folder:

# Windows
Copy-Item -Recurse skills\swiss-grid-design "$HOME\.dsh\skills\"
# macOS / Linux
cp -R skills/swiss-grid-design "$HOME/.dsh/skills/"

Quick start

Requirements: Python 3.10+, and for PDF output Microsoft Edge or Chromium in a standard

location (the scripts also accept msedge/chrome on PATH). pymupdf/Pillow are optional

(for previews and the PDF verifier).

$py = "python"          # or your DSH Python runtime

# 1. compute the grid
python skills/swiss-grid-design/assets/grid_calculator.py --preset a2-32

# 2. build a poster (copy the builder into your project first, then edit TEXTS/ART/colours)
python poster_builder.py --preset a2-32 --outdir out --grid --pdf --preview

# 3. verify the print PDF
python skills/swiss-grid-design/assets/verify_print_pdf.py \
  --pdf out/poster_a2-32.pdf --trim 420x594 --bleed 3

The builder writes the artwork PDF, the grid-overlay PDF, SVG/HTML sources, spec.md and a

preview JPG. The verifier checks page size = trim + 2 × bleed, a proper TrimBox/BleedBox,

real text, Type0 (not Type3) glyphs, and crop marks.

The rules in one breath

Every element snaps to a column line, row line or baseline multiple. A unit cell is an integer