🎯

sketch

🎯Skill
g1joshi/agent-skills1 Installs9Last Updated Feb 10, 2026

Installation

$npx skills add g1joshi/agent-skills --skill sketch

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/sketch
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/sketch/
  • All projects ~/.claude/skills/sketch/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

Expert Sketch assistance covering vector UI/UX design, symbol libraries, design tokens, color variables, and developer handoff workflows. Use when creating design systems in Sketch, managing shared libraries, exporting asset slices, or integrating Sketch with prototyping tools.

Sketch

Sketch is a native macOS design platform providing vector editing, shared design system libraries, symbols, and developer asset handoff workflows.

When to Use

  • macOS Native UI/UX Vector Design: Crafting vector interfaces, design system component libraries, and interactive wireframes.
  • Design Token Automation: Exporting colors, typography, and spacing tokens to code using Sketch plugins and JavaScript APIs.
  • Symbol & Shared Style Libraries: Managing synchronized component libraries across distributed design and frontend teams.
  • Handoff Specification Generation: Exporting pixel-perfect SVG assets, PDF specs, and developer inspect documentation.

Quick Start

1. Export Assets via Sketchtool CLI

# Export all artboards to @2x PNG
sketchtool export artboards "MyDesign.sketch" --scales="1, 2" --output="assets/exports"

# Export specific slices
sketchtool export slices "MyDesign.sketch" --formats="svg,png"

2. Design Token Organization

  • Define Global Color Variables in Document Settings > Color Variables.
  • Name systematically: color/primary/500, color/neutral/100.
  • Create Components as Symbols with standardized naming: Button/Primary/Large/Default.

Core Concepts

Sketch JavaScript API: Automated Token Exporter

Writing an automated Sketch script to export document color variables to JSON tokens:

// export-tokens.js (Run via Sketch Developer Console)
const sketch = require("sketch");
const document = sketch.getSelectedDocument();

const colors = document.colors.map((colorAsset) => ({
  name: colorAsset.name || "Untitled",
  hex: colorAsset.color,
}));

const designTokens = {
  version: "1.0.0",
  palette: colors.reduce((acc, curr) => {
    const slug = curr.name.toLowerCase().replace(/\s+/g, "-");
    acc[slug] = curr.hex;
    return acc;
  }, {}),
};

console.log(JSON.stringify(designTokens, null, 2));

Sketch Plugin Manifest (manifest.json)

Creating a developer handoff plugin for Sketch:

{
  "name": "Design Token Exporter",
  "identifier": "com.company.sketch.token-exporter",
  "version": "1.0.0",
  "description": "Exports Sketch color variables and text styles to Tailwind CSS tokens.",
  "author": "Engineering Design Team",
  "appcast": "https://raw.githubusercontent.com/company/sketch-plugin/main/appcast.xml",
  "commands": [
    {
      "name": "Export Tokens to JSON",
      "identifier": "export-tokens",
      "script": "./plugin.js",
      "handler": "onExportTokens"
    }
  ],
  "menu": {
    "title": "Design Tokens",
    "items": ["export-tokens"]
  }
}

Exporting SVG Assets with Clean Paths

  • Select artboard or symbol -> Right sidebar -> Make Exportable.
  • Format: SVG (enable Compact SVG to remove editor metadata).
  • Automate CLI export using sketchtool:
    sketchtool export slices "DesignSystem.sketch" --output="./dist/assets/" --formats="svg,png"
    

Common Patterns

Reusable Symbol Design with Smart Layout

Problem: Buttons and card components break layout when text labels change in length.

Solution:

{
  "group": "Button/Primary",
  "smartLayout": {
    "direction": "HORIZONTAL_CENTER",
    "minWidth": 120,
    "padding": { "top": 12, "right": 24, "bottom": 12, "left": 24 }
  }
}

Design System Token Export to Code

Problem: Sync Sketch color variables and typography to CSS variables or Tailwind tokens.
Solution: Export JSON tokens via Sketch Cloud API or sketchtool.

{
  "colors": {
    "primary": { "value": "#4F46E5" },
    "background": { "value": "#0F172A" }
  },
  "spacing": {
    "sm": { "value": "8px" },
    "md": { "value": "16px" }
  }
}

Best Practices

Do:

  • Organize UI components into Smart Layout Symbols with flexible resizing constraints (Pin to edge, Fixed width/height).
  • Maintain a central Shared Library file hosted on Sketch Cloud for typography, colors, and elevation styles.
  • Run automated exports via sketchtool CLI in continuous integration pipelines for asset synchronization.
  • Name layers semantically (header/search-input, button/primary/hover) to improve developer handoff clarity.

Don't:

  • Leave detached symbols with unlinked layer styles across production design files.
  • Commit multi-gigabyte .sketch binary files into standard Git repos; use Git LFS or Sketch Cloud.
  • Export unoptimized SVGs; process exported vectors with SVGO before committing to frontend codebases.

Troubleshooting

ErrorCauseSolution
sketchtool: command not foundSketch command line tools not linked in system pathRun sudo /Applications/Sketch.app/Contents/Resources/sketchtool/bin/sketchtool-install.sh.
Symbol overrides reset when library updatesSymbol layer structure was modified or layer names desynchronizedKeep layer names identical in both base library and modified components to preserve overrides.
Exported SVG icons have nested clipped paths and extra wrappersSketch exports artboard backgrounds or hidden masksDisable artboard background in export settings and flatten combined vector shapes before export.

References

More from this repository10