AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

adobe-illustrator-scripting

Write, debug, and optimize Adobe Illustrator automation scripts using ExtendScript (JavaScript/JSX). Use when creating or modifying scripts that manipulate documents, layers, paths, text frames, colors, symbols, artboards, or any Illustrator DOM objects. Covers the complete JavaScript object model, coordinate system, measurement units, export workflows, and scripting best practices.

Original source
github
License
MIT
Pinned revision
5269f7ea2d6c3a9bfda5ed878b6726cf509121fd

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read github--adobe-illustrator-scripting at revision 5269f7ea2d6c3a9bfda5ed878b6726cf509121fd, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 2

references/object-model-quick-reference.md

Illustrator JavaScript Object Model Quick Reference

Containment Hierarchy

Application (app)
 └─ Document
     ├─ Layer
     │   ├─ pathItems[]        → PathItem → PathPoint[]
     │   ├─ compoundPathItems[] → CompoundPathItem
     │   ├─ textFrames[]       → TextFrame
     │   │   ├─ characters[]   → TextRange (single char)
     │   │   ├─ words[]        → TextRange (word)
     │   │   ├─ paragraphs[]   → TextRange (paragraph)
     │   │   ├─ lines[]        → TextRange (line)
     │   │   └─ insertionPoints[]
     │   ├─ placedItems[]      → PlacedItem
     │   ├─ rasterItems[]      → RasterItem
     │   ├─ meshItems[]        → MeshItem
     │   ├─ pluginItems[]      → PluginItem
     │   ├─ graphItems[]       → GraphItem
     │   ├─ symbolItems[]      → SymbolItem → Symbol
     │   ├─ groupItems[]       → GroupItem (recursive pageItems)
     │   ├─ nonNativeItems[]   → NonNativeItem
     │   └─ legacyTextItems[]  → LegacyTextItem
     ├─ Artboard[]
     ├─ Swatch[] / Spot[] / Gradient[] / Pattern[]
     ├─ GraphicStyle[] / Brush[] / Symbol[]
     ├─ Story[]
     ├─ CharacterStyle[] / ParagraphStyle[]
     ├─ Variable[] / Dataset[]
     └─ View[]

Artwork Item Types (pageItems members)

| Type | typename | Collection | Notes | |---|---|---|---| | Path | PathItem | pathItems | Lines, shapes, freeform paths | | Compound path | CompoundPathItem | compoundPathItems | Multiple paths combined | | Group | GroupItem | groupItems | Contains nested pageItems | | Text frame | TextFrame | textFrames | Point, area, or path text | | Placed image | PlacedItem | placedItems | Linked external files | | Raster image | RasterItem | rasterItems | Embedded bitmaps | | Mesh | MeshItem | meshItems | Gradient mesh objects | | Graph | GraphItem | graphItems | Chart/graph objects | | Plugin item | PluginItem | pluginItems | Plugin-generated art | | Symbol instance | SymbolItem | symbolItems | Instance of a Symbol | | Non-native | NonNativeItem | nonNativeItems | Foreign objects | | Legacy text | LegacyTextItem | legacyTextItems | Pre-CS text objects |

Color Object Types

| Object | Color Space | Value Range | Notes | |---|---|---|---| | RGBColor | RGB | 0-255 per channel | .red, .green, .blue | | CMYKColor | CMYK | 0-100 per channel | .cyan, .magenta, .yellow, .black | | GrayColor | Grayscale | 0-100 | .gray (0=black, 100=white) | | LabColor | Lab | L: 0-100, a/b: -128 to 127 | .l, .a, .b | | SpotColor | Spot | tint 0-100 | .spot, .tint | | PatternColor | Pattern | - | .pattern, .matrix | | GradientColor | Gradient | - | .gradient, .origin, .angle | | NoColor | None | - | Transparent/no fill |

Common Scripting Constants

Document and Color

  • DocumentColorSpace.RGB / .CMYK

Text

  • Justification.LEFT / .CENTER / .RIGHT / .FULLJUSTIFY / .FULLJUSTIFYLASTLINELEFT / .FULLJUSTIFYLASTLINECENTER / .FULLJUSTIFYLASTLINERIGHT
  • TextType.POINTTEXT / .AREATEXT / .PATHTEXT
  • FontBaselineOption.NORMALBASELINE / .SUPERSCRIPT / .SUBSCRIPT

Paths

  • PointType.SMOOTH / .CORNER
  • StrokeCap.BUTTENDCAP / .ROUNDENDCAP / .PROJECTINGENDCAP
  • StrokeJoin.MITERENDJOIN / .ROUNDENDJOIN / .BEVELENDJOIN

Transformations

  • Transformation.DOCUMENTORIGIN / .BOTTOM / .BOTTOMLEFT / .BOTTOMRIGHT / .CENTER / .LEFT / .RIGHT / .TOP / .TOPLEFT / .TOPRIGHT

Blend Modes

  • BlendModes.NORMAL / .MULTIPLY / .SCREEN / .OVERLAY / .SOFTLIGHT / .HARDLIGHT / .COLORDODGE / .COLORBURN / .DARKEN / .LIGHTEN / .DIFFERENCE / .EXCLUSION / .HUE / .SATURATIONBLEND / .COLORBLEND / .LUMINOSITY

Element Placement

  • ElementPlacement.PLACEATBEGINNING / .PLACEATEND / .PLACEBEFORE / .PLACEAFTER / .INSIDE

Z-Order

  • ZOrderMethod.BRINGTOFRONT / .SENDTOBACK / .BRINGFORWARD / .SENDBACKWARD

Save/Export

  • SaveOptions.SAVECHANGES / .DONOTSAVECHANGES / .PROMPTTOSAVECHANGES
  • ExportType.PNG24 / .PNG8 / .JPEG / .SVG / .TIFF / .PHOTOSHOP / .AUTOCAD / .FLASH / .GIF
  • Compatibility.ILLUSTRATOR8 through .ILLUSTRATOR24
  • PDFCompatibility.ACROBAT4 through .ACROBAT8

Gradient

  • GradientType.LINEAR / .RADIAL

Variables

  • VariableKind.TEXTUAL / .IMAGE / .VISIBILITY / .GRAPH

User Interaction

  • UserInteractionLevel.DISPLAYALERTS / .DONTDISPLAYALERTS

Print

  • PrintArtworkDesignation.ALLLAYERS / .VISIBLELAYERS / .VISIBLEPRINTABLELAYERS

Unit Conversions

| From | To Points | Formula | |---|---|---| | Inches | Points | inches * 72 | | Centimeters | Points | cm * 28.346 | | Millimeters | Points | mm * 2.834645 | | Picas | Points | picas * 12 | | Em units | Points | (emUnits * fontSize) / 1000 |