SkillAgentSearch skills...

zigzag

Free, open-source embroidery software for Mac and Windows. Turn SVG artwork into machine embroidery, edit stitches visually, and create designs with AI agents via MCP.

Install / Use

claude mcp add simpsoka -- npx -y github:simpsoka/zigzag

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

83/100

Supported Platforms

Claude Code
Claude Desktop

Our assessment of zigzag

zigzag scores 83/100 on our quality scale, 2975th of 4,698 Development & Engineering skills we index.

Its MCP Server is 46 KB long, well organised into 19 sections with 10 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.

It has 858 GitHub stars, a meaningful sign that others use it.

Substance
21/30
Structure
20/20
Description
15/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated yesterday, so zigzag is actively maintained.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-14. Automated pattern scan on 2026-11-14. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

zigzag compared with similar skills

All 4 of these similar skills score higher than zigzag; compare them before choosing.

SkillScoreStarsUpdatedFormat
zigzag (this skill)by simpsoka838581d agoMCP Server
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install zigzag?
Run claude mcp add simpsoka -- npx -y github:simpsoka/zigzag. The install tabs above show the steps for each supported agent.
Which AI agents does zigzag work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is zigzag safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is zigzag still maintained?
The repository was last updated yesterday, so zigzag is actively maintained.
<img src="packaging/macos/AppIcon-dark.png" alt="ZigZag dark mode app icon" width="160" height="160">

ZigZag

Visit zigzag.diy

ZigZag is a visual embroidery editor built in Rust for performance, with built-in MCP (Model Context Protocol) support so AI agents can create and edit designs alongside you. Turn SVG artwork into stitches, fine-tune it in the editor, and export PES, DST, EXP, JEF, or VP3 for broad compatibility with embroidery machines—or send designs directly to a Brother Skitch (PP1) over Bluetooth.

Draw in Illustrator, draw in ZigZag, or let an agent draw. The Rust engine and zigzag command-line tool power the same workflow outside the editor.

See ZigZag in action

https://github.com/user-attachments/assets/94812f25-82f4-429f-85db-5e20c1d5e723

Stitching on a Brother Skitch (PP1)

<a href="https://github.com/simpsoka/zigzag/raw/refs/heads/main/packaging/media/skitch-pp1-demo.mp4"> <img src="packaging/media/skitch-pp1-demo.jpg" alt="Download the video of ZigZag stitching a design on a Brother Skitch PP1" width="320"> </a>

Download the video (MP4, 1080p) · Original post on X.

Download for Mac

Download ZigZag.dmg

For Apple Silicon and Intel Macs, macOS 11 or later. Open the DMG, then drag ZigZag into Applications. The release is signed and notarized by Apple. No Rust installation is needed.

Or with Homebrew:

brew install --cask simpsoka/zigzag/zigzag

To update a Homebrew installation:

brew upgrade --cask --greedy simpsoka/zigzag/zigzag

Starting with version 0.1.3, ZigZag also offers an in-app updater: it tells you when there's a newer release and installs it when you say (ZigZag › Check for Updates…).

Download for Windows

Download ZigZag for Windows — the ZigZag-<version>-x86_64-windows.zip asset on the latest release.

For 64-bit Windows 10 (version 1709 or later) and Windows 11. Unzip it and double-click ZigZag.exe. Windows SmartScreen warns on apps without a Microsoft-trusted signature the first time they run; click More info → Run anyway. No Rust installation is needed.

Download for Linux

Download ZigZag for Linux — the ZigZag-<version>-x86_64-linux.tar.gz asset on the latest release.

For x86-64 Linux desktops with glibc 2.35 or newer (Ubuntu 22.04+, Debian 12+), X11 or Wayland, and OpenGL. Extract the archive and run ./zigzag-studio inside the extracted folder. It also includes the zigzag CLI and zigzag-mcp bridge; no Rust installation is needed. See the included README.txt for runtime dependencies and Bluetooth setup.

Release notes and checksums · Changelog · Publishing a release

zigzag/
  src/svg.rs              SVG import (usvg): fill and stroke parts, transforms, text
  src/document/           editable document; settings saved back into SVG ids,
                          layout edits as SVG transforms, lettering
  src/params.rs           stitch settings tokens + fabric presets
  src/stitch/fill.rs      tatami fill (scanline sections, staggered rows)
  src/stitch/satin.rs     satin columns: two rails, auto-satin, underlays, short stitches, lean
  src/stitch/columns.rs   shapes that branch or have holes, cut into satin columns
  src/stitch/stroke.rs    running / triple-run stitch
  src/boolean.rs          polygon booleans and offsets (i_overlay)
  src/design.rs           planner: overlap removal, cap order, routing, trims
  src/route.rs            travel out of sight: a way through fills and under what covers
  src/checks.rs           digitizing checks (sizes, widths, lettering, hoop)
  src/machine/profile.rs  machine profiles: hoops and file format, built in (profiles.json) or your own
  src/formats/            PES (+PEC), DST, EXP, JEF, VP3, Skitch PEN writers;
                          PES/PEC/DST/EXP/JEF readers; preview; worksheet
  src/machine/            Skitch Bluetooth protocol (+ btleplug client, `ble` feature)
  src/studio/             editor (egui on OpenGL via glow) + MCP server (`gui` feature)
  src/mcp_bridge.rs       stdio ↔ HTTP bridge for MCP clients that launch a command

Build

cargo build --release                        # CLI + MCP bridge, no system deps
cargo build --release --features gui,ble     # + the studio editor and Skitch upload

Linux needs the usual X11/Wayland and OpenGL dev libraries for gui. libdbus is vendored for ble.

Stitch types

| Type | What it does | Works on | |---|---|---| | Fill (tatami) | Staggered rows, any angle, with underlay (edge walk + rows) and pull compensation | Filled shapes | | Satin | Zigzag column between two rails, with center/contour/zigzag underlay, pull compensation and short stitches on tight curves; plain, S-stitch or zig-zag top stitching; stitches square across or leaning (lean=8); several threads across the column (multicolor satin) | Strokes (any width); Ink/Stitch-style two-rail paths with rungs; filled shapes: rings use inner/outer outline, bars and crescents split at their tips, letters and other shapes that branch or have a counter are cut into columns where the branches part (a P into its stem and bowl, a T into bar and stem), or border follows the outline | | Run | Running stitch, single or triple (bean) | Strokes and outlines | | Contour | Rows that follow the outline inward, or one spiral out from the center (Ink/Stitch's circular fill) | Filled shapes | | Blanket | E-stitch: a line with prongs into the shape | Edges, appliqué | | Appliqué | Placement line → stop → tack-down → stop → satin cover | Filled shapes | | Manual | Every path point is a needle point | Imported machine files, pen tool | | Meander | One wandering line through the shape, quilting style: light and soft | Filled shapes | | Ripple | Open running-stitch rows following the outline, or one spiral | Filled shapes | | Cross-stitch | A grid of X's, sewn as rows of half-crosses out and back | Filled shapes | | Tartan | Woven stripes in several threads (a mirrored sett you edit in the panel), each thread its own color block | Filled shapes |

Satins wider than 7 mm are auto-split (shorter, staggered stitches) and use auto spacing (narrow columns more open, wide ones denser).

Planner features:

  • Remove overlaps: fill hidden under later objects isn't sewn (keeps 0.5 mm of overlap).
  • Cap order: center-out, bottom-up, grouped by color, still respecting layering.
  • Routing: travel stitches stay out of sight: straight across where a straight line stays inside the fill, otherwise round the inside of its outline (Ink/Stitch's underpath), otherwise any way through the fill (round its holes, through its necks), under a satin that's about to be sewn, or under whatever is sewn later on top. An object's last piece is sewn toward the end the next object can be reached from. So satin lettering sewn stroke by stroke needs cuts only between letters when each stroke is followed by one that covers the way to it (a T's stem before its bar; an E's bars before its stem). A fill in separate parts is sewn part by part, each part's underlay and top together. So a fill with cut-outs, or a dither in scattered blocks under another color, is sewn with few or no cuts. Trims only where none of that works (up to 50 mm of travel).
  • Sewing control per object: a start and an end point (where the thread comes in and leaves, so the next object is close), trim after, stop after (to lay foam or trim appliqué). What's left to cut is the document's Connect bar: drag it to sew across gaps up to N mm (between objects, or the parts of one) with running stitches instead of cuts. Those stitches show, so the panel counts the cuts saved as you drag and the canvas lights up what would be sewn.
  • Fabric presets: standard, thin cotton cap, structured cap, knit.
  • Checks: narrow fills, wide/narrow satins, small lettering, tiny gaps, fully covered objects, hoop fit.
  • Group colors: reorder to cut thread changes without breaking layering.

Mac app

On a Mac with Rust and the Xcode command line tools (xcode-select --install):

packaging/macos/make-app.sh --install    # builds ZigZag.app and copies it to /Applications
packaging/macos/make-app.sh --dmg        # also makes dist/ZigZag-<version>.dmg to share
packaging/macos/make-app.sh --universal  # one app for Apple Silicon and Intel Macs
packaging/macos/make-app.sh --release    # the DMG to publish: universal, signed, notarized

--release signs with your Developer ID and has Apple notarize the app and the DMG, so it opens on any Mac without warnings. Once, beforehand: add a Developer ID Application certificate (Xcode › Settings › Accounts › Manage Certificates › +), make an app-specific password at account.apple.com, and save the notarization credentials in your keychain:

xcrun notarytool store-credentials zigzag-notary --apple-id YOUR_APPLE_ID --team-id YOUR_TEAM_ID

The app bundles the studio, the zigzag command-line tool and the MCP bridge. To use the command line from anywhere: ln -s /Applications/ZigZag.app/Contents/MacOS/zigzag /usr/local/bin/zigzag. For Claude Desktop, point the MCP config at /Applications/ZigZag.app/Contents/MacOS/zigzag-mcp.

Without --release the app is signed ad hoc, not notarized. It opens normally on the Mac that built it. On another Mac, macOS blocks it the first time: open System Settings › Privacy & Security and click Open Anyway (on macOS 14 and earlier, right-click the app and choose Open instead). macOS asks for Bluetooth permission the first time you send to the Skitch.

Studio

The approved embroidered icons live in packaging/macos/AppIcon.png (light) and packaging/macos/AppIcon-dark.png (dark). The Mac build regenerates both multi-resolution .icns files; run bash packaging/macos/make-icons.sh to regenerate them separately. Finder and the unopened app use the light icon. While the studio is running, its Dock icon follows the app's light/dark theme, including the ZIGZAG_THEME=light|dark override.

ZigZag

zigzag-studio [design.svg|logo.png] [--mcp-port 7878 | --no-mcp | --mcp-stdio]

Laid out like Illustrator, styled like a Mac app:

  • Tools down the left edge: Select (V), Direct Selection (A), Hand (H), Pen (P): click for corners, drag for curves (Option breaks the handles, Shift keeps 45°, Space moves the point being placed); while drawing, Option lends it the Anchor Point tool (drag a segment to bend it, a handle to move it alone, click a smooth point for a corner) and ⌘ lends Direct Selection (drag a point or handle, then keep drawing), and on a selected path Option-drag bends a segment too. Illustrator's Pen group is behind it: Add Anchor Point (+) clicks a point onto an outline without changing its shape, Delete Anchor Point (-) clicks one out (Option swaps the two while held), and Anchor Point (Shift+C) converts points between smooth and corner and drags one handle alone. Press and hold the Pen (or right-click it) for the group's flyout, Option-click it to step through the group, or tear the group off into a toolbar of its own with the strip at the flyout's edge; the Shape tools work the same way. Brush (B), with VectorCraft's path clean-up tools in its group: Smooth (drag along a path to take the wobble out: fewer points, smoother curves; Smoothness in the bar above), Path Eraser (drag across a path to cut that part away) and Join (scrub between two open ends to join them, or an open path's two end

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars858
CategoryDevelopment
Updated1d ago
Forks47

Languages

Rust

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions