new skill adobe-illustrator-scripting (#1448)

* new skill adobe-illustrator-scripting

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

docs/README.skills.md

@@ -29,6 +29,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to
 | ---- | ----------- | -------------- |
 | [acquire-codebase-knowledge](../skills/acquire-codebase-knowledge/SKILL.md) | Use this skill when the user explicitly asks to map, document, or onboard into an existing codebase. Trigger for prompts like "map this codebase", "document this architecture", "onboard me to this repo", or "create codebase docs". Do not trigger for routine feature implementation, bug fixes, or narrow code edits unless the user asks for repository-level discovery. | `assets/templates`<br />`references/inquiry-checkpoints.md`<br />`references/stack-detection.md`<br />`scripts/scan.py` |
 | [add-educational-comments](../skills/add-educational-comments/SKILL.md) | Add educational comments to the file specified, or prompt asking for file to comment if one is not provided. | None |
+| [adobe-illustrator-scripting](../skills/adobe-illustrator-scripting/SKILL.md) | 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. | `references/object-model-quick-reference.md`<br />`scripts/batch-export-png.jsx`<br />`scripts/create-color-grid.jsx`<br />`scripts/find-replace-text.jsx` |
 | [agent-governance](../skills/agent-governance/SKILL.md) | Patterns and techniques for adding governance, safety, and trust controls to AI agent systems. Use this skill when:<br />- Building AI agents that call external tools (APIs, databases, file systems)<br />- Implementing policy-based access controls for agent tool usage<br />- Adding semantic intent classification to detect dangerous prompts<br />- Creating trust scoring systems for multi-agent workflows<br />- Building audit trails for agent actions and decisions<br />- Enforcing rate limits, content filters, or tool restrictions on agents<br />- Working with any agent framework (PydanticAI, CrewAI, OpenAI Agents, LangChain, AutoGen) | None |
 | [agent-owasp-compliance](../skills/agent-owasp-compliance/SKILL.md) | Check any AI agent codebase against the OWASP Agentic Security Initiative (ASI) Top 10 risks.<br />Use this skill when:<br />- Evaluating an agent system's security posture before production deployment<br />- Running a compliance check against OWASP ASI 2026 standards<br />- Mapping existing security controls to the 10 agentic risks<br />- Generating a compliance report for security review or audit<br />- Comparing agent framework security features against the standard<br />- Any request like "is my agent OWASP compliant?", "check ASI compliance", or "agentic security audit" | None |
 | [agent-supply-chain](../skills/agent-supply-chain/SKILL.md) | Verify supply chain integrity for AI agent plugins, tools, and dependencies. Use this skill when:<br />- Generating SHA-256 integrity manifests for agent plugins or tool packages<br />- Verifying that installed plugins match their published manifests<br />- Detecting tampered, modified, or untracked files in agent tool directories<br />- Auditing dependency pinning and version policies for agent components<br />- Building provenance chains for agent plugin promotion (dev → staging → production)<br />- Any request like "verify plugin integrity", "generate manifest", "check supply chain", or "sign this plugin" | None |

skills/adobe-illustrator-scripting/SKILL.md

@@ -0,0 +1,718 @@
+---
+name: adobe-illustrator-scripting
+description: '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.'
+---
+
+# Adobe Illustrator Scripting
+
+Expert guidance for automating Adobe Illustrator through ExtendScript (JavaScript/JSX). This skill covers the Illustrator scripting object model, all major API objects, code patterns, and best practices for writing production-quality `.jsx` scripts.
+
+## Bundled Assets
+
+- [`references/object-model-quick-reference.md`](references/object-model-quick-reference.md): Use this as a quick lookup for the Illustrator scripting object model, common document and page item types, and related DOM concepts while writing or debugging scripts.
+- `scripts/`: Contains example Illustrator automation scripts you can use as starting points or implementation patterns for common tasks such as document manipulation, exports, batch processing, and DOM usage. Review and adapt these examples when you need working JSX patterns or want to compare behavior while debugging.
+## When to Use This Skill
+
+- Writing new Illustrator automation scripts (`.jsx` or `.js` files)
+- Debugging or fixing existing Illustrator ExtendScript code
+- Manipulating documents, layers, page items, paths, text, or colors programmatically
+- Batch-processing Illustrator files or generating artwork from data
+- Exporting documents to various formats (PDF, SVG, PNG, EPS, etc.)
+- Working with the Illustrator DOM (Application, Document, Layer, PathItem, TextFrame, etc.)
+- Creating data-driven graphics using variables and datasets
+- Automating print workflows with scripted print options
+
+## Prerequisites
+
+- Adobe Illustrator CC or later installed
+- Basic JavaScript knowledge (ExtendScript is ES3-based with Adobe extensions)
+- Scripts are executed via File > Scripts > Other Scripts, the Scripts menu, or placed in the Startup Scripts folder
+- The ExtendScript Toolkit (ESTK) or any text editor can be used to write `.jsx` files
+
+## Scripting Environment
+
+### Language and File Extensions
+
+| Language | Extension | Platform |
+|---|---|---|
+| ExtendScript/JavaScript | `.jsx`, `.js` | Windows, macOS |
+| AppleScript | `.scpt` | macOS only |
+| VBScript | `.vbs` | Windows only |
+
+**This skill focuses on ExtendScript/JavaScript** as the cross-platform, most widely used option.
+
+### Executing Scripts
+
+- **Scripts menu**: File > Scripts lists scripts from the application scripts folder
+- **Other Scripts**: File > Scripts > Other Scripts to browse and run any `.jsx` file
+- **Startup Scripts**: Place scripts in the Startup Scripts folder to run automatically on launch
+- **Target directive**: Begin scripts with `#target illustrator` when running from ESTK or external tools
+- **`#targetengine` directive**: Use `#targetengine "session"` to persist variables across script executions
+
+### Naming Conventions (JavaScript)
+
+- Objects and properties use **camelCase**: `activeDocument`, `pathItems`, `textFrames`
+- The `app` global references the `Application` object
+- Collection indices are **zero-based**: `documents[0]` is the frontmost document
+- Use `typename` property to identify object types at runtime
+
+## Object Model Overview
+
+The Illustrator DOM follows a strict containment hierarchy:
+
+```
+Application (app)
+├── activeDocument / documents[]
+│   ├── layers[]
+│   │   ├── pageItems[] (all artwork)
+│   │   ├── pathItems[]
+│   │   ├── compoundPathItems[]
+│   │   ├── textFrames[]
+│   │   ├── placedItems[]
+│   │   ├── rasterItems[]
+│   │   ├── meshItems[]
+│   │   ├── pluginItems[]
+│   │   ├── graphItems[]
+│   │   ├── symbolItems[]
+│   │   ├── nonNativeItems[]
+│   │   ├── legacyTextItems[]
+│   │   └── groupItems[]
+│   ├── artboards[]
+│   ├── views[]
+│   ├── selection (array of selected items)
+│   ├── swatches[], spots[], gradients[], patterns[]
+│   ├── graphicStyles[], brushes[], symbols[]
+│   ├── textFonts[] (via app.textFonts)
+│   ├── stories[], characterStyles[], paragraphStyles[]
+│   ├── variables[], datasets[]
+│   └── inkList[], printOptions
+├── preferences
+├── printerList[]
+└── textFonts[]
+```
+
+### Top-Level Objects
+
+- **Application** (`app`): The root object. Provides access to documents, preferences, fonts, and printers. Key properties: `activeDocument`, `documents`, `textFonts`, `printerList`, `userInteractionLevel`, `version`.
+- **Document**: Represents an open `.ai` file. Key properties: `layers`, `pageItems`, `selection`, `activeLayer`, `width`, `height`, `rulerOrigin`, `documentColorSpace`. Key methods: `saveAs()`, `exportFile()`, `close()`, `print()`.
+- **Layer**: A drawing layer. Key properties: `pageItems`, `pathItems`, `textFrames`, `visible`, `locked`, `opacity`, `name`, `zOrderPosition`, `color`.
+
+## Measurement Units and Coordinates
+
+### Units
+
+All scripting API values use **points** (72 points = 1 inch). Convert other units:
+
+| Unit | Conversion |
+|---|---|
+| Inches | multiply by 72 |
+| Centimeters | multiply by 28.346 |
+| Millimeters | multiply by 2.834645 |
+| Picas | multiply by 12 |
+
+Kerning, tracking, and `aki` properties use **em units** (thousandths of an em, proportional to font size).
+
+### Coordinate System
+
+- For **scripted documents**, the origin `(0,0)` is at the **bottom-left** of the artboard
+- X increases left to right; Y increases bottom to top
+- The `position` property of a page item is the **top-left corner** of its bounding box as `[x, y]`
+- Maximum page item width/height: 16348 points
+
+### Art Item Bounds
+
+Every page item has three bounding rectangles:
+
+- `geometricBounds`: Excludes stroke width `[left, top, right, bottom]`
+- `visibleBounds`: Includes stroke width
+- `controlBounds`: Includes control/direction points
+
+## Working with Documents
+
+### Creating and Opening
+
+```javascript
+// Create a new document
+var doc = app.documents.add();
+
+// Create with a preset
+var preset = new DocumentPreset();
+preset.width = 612;  // 8.5 inches
+preset.height = 792; // 11 inches
+preset.colorMode = DocumentColorSpace.CMYK;
+var doc = app.documents.addDocument("Print", preset);
+
+// Open an existing file
+var fileRef = new File("/path/to/file.ai");
+var doc = app.open(fileRef);
+```
+
+### Saving and Exporting
+
+```javascript
+// Save as Illustrator format
+var saveOpts = new IllustratorSaveOptions();
+saveOpts.compatibility = Compatibility.ILLUSTRATOR17; // CC
+doc.saveAs(new File("/path/to/output.ai"), saveOpts);
+
+// Export as PDF
+var pdfOpts = new PDFSaveOptions();
+pdfOpts.compatibility = PDFCompatibility.ACROBAT7;
+pdfOpts.preserveEditability = false;
+doc.saveAs(new File("/path/to/output.pdf"), pdfOpts);
+
+// Export as PNG
+var pngOpts = new ExportOptionsPNG24();
+pngOpts.horizontalScale = 300;
+pngOpts.verticalScale = 300;
+pngOpts.transparency = true;
+doc.exportFile(new File("/path/to/output.png"), ExportType.PNG24, pngOpts);
+
+// Export as SVG
+var svgOpts = new ExportOptionsSVG();
+svgOpts.fontType = SVGFontType.OUTLINEFONT;
+doc.exportFile(new File("/path/to/output.svg"), ExportType.SVG, svgOpts);
+```
+
+## Working with Paths and Shapes
+
+### Built-in Shape Methods
+
+The `pathItems` collection provides convenience methods for common shapes:
+
+```javascript
+var doc = app.activeDocument;
+var layer = doc.activeLayer;
+
+// Rectangle: rectangle(top, left, width, height)
+var rect = layer.pathItems.rectangle(500, 100, 200, 150);
+
+// Rounded rectangle: roundedRectangle(top, left, width, height, hRadius, vRadius)
+var rrect = layer.pathItems.roundedRectangle(500, 100, 200, 150, 20, 20);
+
+// Ellipse: ellipse(top, left, width, height)
+var oval = layer.pathItems.ellipse(400, 200, 100, 100);
+
+// Polygon: polygon(centerX, centerY, radius, sides)
+var hex = layer.pathItems.polygon(300, 300, 50, 6);
+
+// Star: star(centerX, centerY, radius, innerRadius, points)
+var star = layer.pathItems.star(300, 300, 50, 25, 5);
+```
+
+### Freeform Paths Using Coordinate Arrays
+
+```javascript
+var doc = app.activeDocument;
+var path = doc.pathItems.add();
+path.setEntirePath([[100, 100], [200, 200], [300, 100]]);
+path.closed = false;
+path.stroked = true;
+path.strokeWidth = 2;
+```
+
+### Freeform Paths Using PathPoint Objects
+
+```javascript
+var doc = app.activeDocument;
+var path = doc.pathItems.add();
+
+var point1 = path.pathPoints.add();
+point1.anchor = [100, 100];
+point1.leftDirection = [100, 100];
+point1.rightDirection = [150, 150];
+point1.pointType = PointType.SMOOTH;
+
+var point2 = path.pathPoints.add();
+point2.anchor = [300, 100];
+point2.leftDirection = [250, 150];
+point2.rightDirection = [300, 100];
+point2.pointType = PointType.SMOOTH;
+
+path.closed = false;
+```
+
+### Path Properties
+
+```javascript
+var item = doc.pathItems[0];
+item.filled = true;
+item.stroked = true;
+item.strokeWidth = 1.5;
+item.strokeCap = StrokeCap.ROUNDENDCAP;
+item.strokeJoin = StrokeJoin.ROUNDENDJOIN;
+item.opacity = 80;
+item.closed = true;
+```
+
+## Working with Colors
+
+### Color Objects
+
+```javascript
+// RGB Color (values 0-255)
+var red = new RGBColor();
+red.red = 255;
+red.green = 0;
+red.blue = 0;
+
+// CMYK Color (values 0-100)
+var cyan = new CMYKColor();
+cyan.cyan = 100;
+cyan.magenta = 0;
+cyan.yellow = 0;
+cyan.black = 0;
+
+// Grayscale (0-100, 0 = black)
+var gray = new GrayColor();
+gray.gray = 50;
+
+// Lab Color
+var lab = new LabColor();
+lab.l = 50;
+lab.a = 20;
+lab.b = -30;
+
+// No color (transparent)
+var none = new NoColor();
+```
+
+### Applying Colors
+
+```javascript
+var item = doc.pathItems[0];
+item.fillColor = red;
+item.strokeColor = cyan;
+
+// Gradient fill
+var gradient = doc.gradients.add();
+gradient.type = GradientType.LINEAR;
+gradient.gradientStops[0].color = red;
+gradient.gradientStops[1].color = cyan;
+
+var gradColor = new GradientColor();
+gradColor.gradient = gradient;
+item.fillColor = gradColor;
+```
+
+### Spot Colors and Swatches
+
+```javascript
+// Create a spot color
+var spot = doc.spots.add();
+spot.name = "My Spot Color";
+spot.color = red; // Base color definition
+
+var spotColor = new SpotColor();
+spotColor.spot = spot;
+spotColor.tint = 100;
+
+item.fillColor = spotColor;
+
+// Access a swatch by name
+var swatch = doc.swatches.getByName("PANTONE 185 C");
+item.fillColor = swatch.color;
+```
+
+## Working with Text
+
+### Text Frame Types
+
+```javascript
+var doc = app.activeDocument;
+
+// Point text
+var pointText = doc.textFrames.add();
+pointText.contents = "Hello World!";
+pointText.position = [100, 500];
+
+// Area text (text inside a path)
+var rectPath = doc.pathItems.rectangle(500, 100, 200, 100);
+var areaText = doc.textFrames.areaText(rectPath);
+areaText.contents = "Text inside a rectangle shape.";
+
+// Path text (text along a path)
+var curvePath = doc.pathItems.add();
+curvePath.setEntirePath([[50, 300], [150, 400], [250, 300]]);
+var pathText = doc.textFrames.pathText(curvePath);
+pathText.contents = "Text on a path";
+```
+
+### Character and Paragraph Formatting
+
+```javascript
+var tf = doc.textFrames[0];
+var textRange = tf.textRange;
+
+// Character attributes
+var charAttr = textRange.characterAttributes;
+charAttr.size = 24;           // Font size in points
+charAttr.textFont = app.textFonts.getByName("ArialMT");
+charAttr.fillColor = red;
+charAttr.tracking = 50;       // Em units
+charAttr.horizontalScale = 100;
+charAttr.verticalScale = 100;
+charAttr.baselineShift = 0;
+
+// Paragraph attributes
+var paraAttr = textRange.paragraphAttributes;
+paraAttr.justification = Justification.CENTER;
+paraAttr.firstLineIndent = 0;
+paraAttr.leftIndent = 0;
+paraAttr.spaceBefore = 0;
+paraAttr.spaceAfter = 0;
+```
+
+### Accessing Text Content
+
+```javascript
+var tf = doc.textFrames[0];
+
+// Access sub-ranges
+var firstChar = tf.characters[0];
+var firstWord = tf.words[0];
+var firstPara = tf.paragraphs[0];
+var firstLine = tf.lines[0];
+
+// Modify specific ranges
+tf.words[0].characterAttributes.size = 36;
+tf.paragraphs[0].paragraphAttributes.justification = Justification.LEFT;
+```
+
+### Threading Text Frames
+
+```javascript
+var frame1 = doc.textFrames.areaText(path1);
+var frame2 = doc.textFrames.areaText(path2);
+
+// Link frames so text flows from frame1 to frame2
+frame1.nextFrame = frame2;
+
+// Stories represent the full text across threaded frames
+var storyCount = doc.stories.length;
+var fullText = doc.stories[0].textRange.contents;
+```
+
+## Working with Layers
+
+```javascript
+var doc = app.activeDocument;
+
+// Create a layer
+var newLayer = doc.layers.add();
+newLayer.name = "Background";
+newLayer.visible = true;
+newLayer.locked = false;
+newLayer.opacity = 100;
+
+// Access existing layers
+var topLayer = doc.layers[0];
+var layerByName = doc.layers.getByName("Background");
+
+// Move items between layers
+var item = doc.pathItems[0];
+item.move(newLayer, ElementPlacement.PLACEATBEGINNING);
+
+// Reorder layers
+newLayer.zOrder(ZOrderMethod.SENDTOBACK);
+```
+
+## Working with Selections
+
+```javascript
+// Get current selection
+var sel = app.activeDocument.selection;
+
+// Iterate selected items
+for (var i = 0; i < sel.length; i++) {
+    var item = sel[i];
+    // Check type using typename
+    if (item.typename === "PathItem") {
+        item.fillColor = red;
+    } else if (item.typename === "TextFrame") {
+        item.contents = "Modified";
+    }
+}
+
+// Select an item programmatically
+doc.pathItems[0].selected = true;
+
+// Deselect all
+doc.selection = null;
+```
+
+## Working with Symbols
+
+```javascript
+// Place a symbol instance
+var sym = doc.symbols.getByName("MySymbol");
+var instance = doc.symbolItems.add(sym);
+instance.position = [200, 400];
+
+// Access symbol definition
+var symDef = instance.symbol;
+
+// Break link to symbol (expand to regular art)
+instance.breakLink();
+```
+
+## Transformations
+
+```javascript
+var item = doc.pathItems[0];
+
+// Rotate 45 degrees around center
+item.rotate(45);
+
+// Scale to 50% width, 75% height
+item.resize(50, 75);
+
+// Translate (move) by 100 points right and 50 points up
+item.translate(100, 50);
+
+// Using a transformation matrix
+var matrix = app.getIdentityMatrix();
+matrix = app.concatenateRotationMatrix(matrix, 30);
+matrix = app.concatenateScaleMatrix(matrix, 150, 150);
+item.transform(matrix);
+```
+
+## Working with Artboards
+
+```javascript
+var doc = app.activeDocument;
+
+// Access artboards
+var ab = doc.artboards[0];
+var rect = ab.artboardRect; // [left, top, right, bottom]
+
+// Create a new artboard
+var newAB = doc.artboards.add([0, 0, 612, 792]); // Letter size
+newAB.name = "Page 2";
+
+// Set active artboard
+doc.artboards.setActiveArtboardIndex(1);
+```
+
+## Data-Driven Graphics (Variables and Datasets)
+
+```javascript
+// Variables link document items to data fields
+var v = doc.variables.add();
+v.kind = VariableKind.TEXTUAL;
+v.name = "headline";
+
+// Link a text frame to the variable
+var tf = doc.textFrames[0];
+tf.contentVariable = v;
+
+// Create datasets for batch content
+var ds = doc.dataSets.add();
+ds.name = "Version 1";
+// Dataset captures current variable bindings
+
+// Switch datasets to swap content
+doc.dataSets[0].display();
+```
+
+## Printing
+
+```javascript
+var doc = app.activeDocument;
+var opts = new PrintOptions();
+
+opts.printPreset = "Default";
+
+// Paper options
+var paperOpts = new PrintPaperOptions();
+paperOpts.name = "Letter";
+opts.paperOptions = paperOpts;
+
+// Job options
+var jobOpts = new PrintJobOptions();
+jobOpts.copies = 1;
+jobOpts.designation = PrintArtworkDesignation.VISIBLELAYERS;
+opts.jobOptions = jobOpts;
+
+doc.print(opts);
+```
+
+## User Interaction Levels
+
+Control whether Illustrator shows dialogs during script execution:
+
+```javascript
+// Suppress all dialogs
+app.userInteractionLevel = UserInteractionLevel.DONTDISPLAYALERTS;
+
+// Perform operations that might prompt dialogs...
+doc.close(SaveOptions.DONOTSAVECHANGES);
+
+// Restore dialog display
+app.userInteractionLevel = UserInteractionLevel.DISPLAYALERTS;
+```
+
+## Working with Methods (JavaScript-Specific)
+
+When calling methods with multiple optional parameters, use `undefined` to skip middle parameters:
+
+```javascript
+// rotate(angle, [changePositions], [changeFillPatterns], [changeFillGradients], ...)
+item.rotate(30, undefined, undefined, true);
+```
+
+## Common Patterns
+
+### Iterate All Page Items in a Document
+
+```javascript
+function processAllItems(doc) {
+    for (var i = 0; i < doc.pageItems.length; i++) {
+        var item = doc.pageItems[i];
+        // Process based on type
+        switch (item.typename) {
+            case "PathItem":
+                // handle path
+                break;
+            case "TextFrame":
+                // handle text
+                break;
+            case "GroupItem":
+                // handle group (may contain nested items)
+                break;
+        }
+    }
+}
+```
+
+### Batch Process Files in a Folder
+
+```javascript
+var folder = Folder.selectDialog("Select folder of .ai files");
+if (folder) {
+    var files = folder.getFiles("*.ai");
+    for (var i = 0; i < files.length; i++) {
+        var doc = app.open(files[i]);
+        // Process each document...
+        doc.close(SaveOptions.DONOTSAVECHANGES);
+    }
+}
+```
+
+### Error Handling
+
+```javascript
+try {
+    var doc = app.activeDocument;
+    var layer = doc.layers.getByName("NonExistentLayer");
+} catch (e) {
+    alert("Error: " + e.message);
+    // e.message, e.line, e.fileName available
+}
+```
+
+## Troubleshooting
+
+- **"undefined is not an object"**: Usually means the collection is empty or the index is out of bounds. Check `.length` before accessing items.
+- **Script runs but nothing changes visually**: Call `app.redraw()` to force a screen refresh after modifications.
+- **Color mode mismatch**: Document color space (RGB vs CMYK) must match color objects. Use `doc.documentColorSpace` to check.
+- **Position seems wrong**: Remember scripted documents use bottom-left origin with Y increasing upward. The `position` property is the top-left of the bounding box.
+- **Text not appearing**: Ensure the text frame has a non-zero size. For point text, set `position`; for area text, provide a valid path to `areaText()`.
+- **File paths on Windows**: Use forward slashes (`/`) or double backslashes (`\\`) in path strings, or use the `File` object constructor.
+- **Dialog boxes interrupting batch scripts**: Set `app.userInteractionLevel = UserInteractionLevel.DONTDISPLAYALERTS` before batch operations.
+- **Collections use `getByName()`**: Many collection objects support `getByName("name")` which throws an error if not found; wrap in try/catch.
+
+## Scripting Constants Reference
+
+Common enumeration constants used across the API:
+
+| Category | Constants |
+|---|---|
+| **Color Space** | `DocumentColorSpace.RGB`, `DocumentColorSpace.CMYK` |
+| **Justification** | `Justification.LEFT`, `Justification.CENTER`, `Justification.RIGHT`, `Justification.FULLJUSTIFY` |
+| **Point Type** | `PointType.SMOOTH`, `PointType.CORNER` |
+| **Stroke Cap** | `StrokeCap.BUTTENDCAP`, `StrokeCap.ROUNDENDCAP`, `StrokeCap.PROJECTINGENDCAP` |
+| **Stroke Join** | `StrokeJoin.MITERENDJOIN`, `StrokeJoin.ROUNDENDJOIN`, `StrokeJoin.BEVELENDJOIN` |
+| **Blend Mode** | `BlendModes.NORMAL`, `BlendModes.MULTIPLY`, `BlendModes.SCREEN`, `BlendModes.OVERLAY` |
+| **Save Options** | `SaveOptions.SAVECHANGES`, `SaveOptions.DONOTSAVECHANGES`, `SaveOptions.PROMPTTOSAVECHANGES` |
+| **Export Type** | `ExportType.PNG24`, `ExportType.PNG8`, `ExportType.JPEG`, `ExportType.SVG`, `ExportType.TIFF`, `ExportType.PHOTOSHOP`, `ExportType.AUTOCAD`, `ExportType.FLASH` |
+| **Element Placement** | `ElementPlacement.PLACEATBEGINNING`, `ElementPlacement.PLACEATEND`, `ElementPlacement.PLACEBEFORE`, `ElementPlacement.PLACEAFTER`, `ElementPlacement.INSIDE` |
+| **Z-Order** | `ZOrderMethod.BRINGTOFRONT`, `ZOrderMethod.SENDTOBACK`, `ZOrderMethod.BRINGFORWARD`, `ZOrderMethod.SENDBACKWARD` |
+| **Gradient Type** | `GradientType.LINEAR`, `GradientType.RADIAL` |
+| **Text Frame Kind** | `TextType.POINTTEXT`, `TextType.AREATEXT`, `TextType.PATHTEXT` |
+| **Variable Kind** | `VariableKind.TEXTUAL`, `VariableKind.IMAGE`, `VariableKind.VISIBILITY`, `VariableKind.GRAPH` |
+| **User Interaction** | `UserInteractionLevel.DISPLAYALERTS`, `UserInteractionLevel.DONTDISPLAYALERTS` |
+| **Compatibility** | `Compatibility.ILLUSTRATOR10` through `Compatibility.ILLUSTRATOR24` |
+
+## JavaScript Object Reference (Complete API Object List)
+
+The Illustrator JavaScript API contains the following objects, grouped by category:
+
+### Core Objects
+
+`Application`, `Document`, `Documents`, `DocumentPreset`, `Layer`, `Layers`, `PageItem`, `PageItems`, `View`, `Views`, `Preferences`
+
+### Path and Shape Objects
+
+`PathItem`, `PathItems`, `PathPoint`, `PathPoints`, `CompoundPathItem`, `CompoundPathItems`, `GroupItem`, `GroupItems`
+
+### Text Objects
+
+`TextFrame`, `TextRange`, `TextRanges`, `TextPath`, `Characters`, `Words`, `Paragraphs`, `Lines`, `InsertionPoint`, `InsertionPoints`, `Story`, `Stories`, `CharacterAttributes`, `ParagraphAttributes`, `CharacterStyle`, `CharacterStyles`, `ParagraphStyle`, `ParagraphStyles`, `TextFont`, `TextFonts`, `TabStopInfo`
+
+### Color Objects
+
+`RGBColor`, `CMYKColor`, `GrayColor`, `LabColor`, `NoColor`, `SpotColor`, `Spot`, `Spots`, `PatternColor`, `GradientColor`, `Color`, `Gradient`, `Gradients`, `GradientStop`, `GradientStops`
+
+### Swatch and Style Objects
+
+`Swatch`, `Swatches`, `SwatchGroup`, `SwatchGroups`, `GraphicStyle`, `GraphicStyles`, `Pattern`, `Patterns`, `Brush`, `Brushes`
+
+### Symbol Objects
+
+`Symbol`, `Symbols`, `SymbolItem`, `SymbolItems`
+
+### Artboard Objects
+
+`Artboard`, `Artboards`
+
+### Placed and Raster Objects
+
+`PlacedItem`, `PlacedItems`, `RasterItem`, `RasterItems`, `MeshItem`, `MeshItems`, `GraphItem`, `GraphItems`, `PluginItem`, `PluginItems`, `NonNativeItem`, `NonNativeItems`, `LegacyTextItem`, `LegacyTextItems`
+
+### Data-Driven Objects
+
+`Variable`, `Variables`, `Dataset`, `Datasets`
+
+### Matrix and Transform Objects
+
+`Matrix`
+
+### Tag Objects
+
+`Tag`, `Tags`
+
+### Tracing Objects
+
+`TracingObject`, `TracingOptions`
+
+### Save and Export Options
+
+`IllustratorSaveOptions`, `EPSSaveOptions`, `PDFSaveOptions`, `FXGSaveOptions`, `ExportOptionsAutoCAD`, `ExportOptionsFlash`, `ExportOptionsGIF`, `ExportOptionsJPEG`, `ExportOptionsPhotoshop`, `ExportOptionsPNG8`, `ExportOptionsPNG24`, `ExportOptionsSVG`, `ExportOptionsTIFF`
+
+### Open Options
+
+`OpenOptions`, `OpenOptionsAutoCAD`, `OpenOptionsFreeHand`, `OpenOptionsPhotoshop`, `PDFFileOptions`, `PhotoshopFileOptions`
+
+### Print Objects
+
+`PrintOptions`, `PrintJobOptions`, `PrintPaperOptions`, `PrintColorManagementOptions`, `PrintColorSeparationOptions`, `PrintCoordinateOptions`, `PrintFlattenerOptions`, `PrintFontOptions`, `PrintPageMarksOptions`, `PrintPostScriptOptions`, `Printer`, `PrinterInfo`, `Paper`, `PaperInfo`, `PPDFile`, `PPDFileInfo`, `Ink`, `InkInfo`, `Screen`, `ScreenInfo`, `ScreenSpotFunction`
+
+### Image and Rasterize Options
+
+`ImageCaptureOptions`, `RasterEffectOptions`, `RasterizeOptions`
+
+## References
+
+- [Changelog](https://ai-scripting.docsforadobe.dev/introduction/changelog/) - Recent scripting API changes (CC 2020 added `Document.getPageItemFromUuid` and `PageItem.uuid`; CC 2017 added `Application.getIsFileOpen`)
+- [Illustrator Scripting Guide](https://ai-scripting.docsforadobe.dev/) - Full community-maintained documentation

skills/adobe-illustrator-scripting/references/object-model-quick-reference.md

@@ -0,0 +1,130 @@
+# 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` |

skills/adobe-illustrator-scripting/scripts/batch-export-png.jsx

@@ -0,0 +1,39 @@
+// batch-export-png.jsx
+// Exports every open Illustrator document as a PNG24 file to a chosen folder.
+// Usage: Run from File > Scripts > Other Scripts in Adobe Illustrator.
+
+#target illustrator
+
+(function () {
+    if (app.documents.length === 0) {
+        alert("No documents are open.");
+        return;
+    }
+
+    var outputFolder = Folder.selectDialog("Select output folder for PNG export");
+    if (!outputFolder) return;
+
+    var savedInteraction = app.userInteractionLevel;
+    app.userInteractionLevel = UserInteractionLevel.DONTDISPLAYALERTS;
+
+    try {
+        for (var i = app.documents.length - 1; i >= 0; i--) {
+            var doc = app.documents[i];
+            var fileName = doc.name.replace(/\.[^.]+$/, "");
+            var destFile = new File(outputFolder + "/" + fileName + ".png");
+
+            var pngOpts = new ExportOptionsPNG24();
+            pngOpts.transparency = true;
+            pngOpts.artBoardClipping = true;
+            pngOpts.horizontalScale = 100;
+            pngOpts.verticalScale = 100;
+
+            doc.exportFile(destFile, ExportType.PNG24, pngOpts);
+        }
+        alert("Exported " + app.documents.length + " file(s) to:\n" + outputFolder.fsName);
+    } catch (e) {
+        alert("Export error: " + e.message);
+    } finally {
+        app.userInteractionLevel = savedInteraction;
+    }
+})();

skills/adobe-illustrator-scripting/scripts/create-color-grid.jsx

@@ -0,0 +1,38 @@
+// create-color-grid.jsx
+// Creates a grid of colored rectangles to demonstrate path creation,
+// color manipulation, and layer organization in Illustrator scripting.
+// Usage: Run from File > Scripts > Other Scripts in Adobe Illustrator.
+
+#target illustrator
+
+(function () {
+    var doc = app.documents.add();
+    var layer = doc.layers.add();
+    layer.name = "Color Grid";
+
+    var columns = 5;
+    var rows = 4;
+    var cellSize = 72;  // 1 inch
+    var gap = 10;
+    var startX = 72;
+    var startY = doc.height - 72;
+
+    for (var row = 0; row < rows; row++) {
+        for (var col = 0; col < columns; col++) {
+            var x = startX + col * (cellSize + gap);
+            var y = startY - row * (cellSize + gap);
+
+            var rect = layer.pathItems.rectangle(y, x, cellSize, cellSize);
+
+            var color = new RGBColor();
+            color.red = Math.round((col / (columns - 1)) * 255);
+            color.green = Math.round((row / (rows - 1)) * 255);
+            color.blue = Math.round(128 + Math.random() * 127);
+
+            rect.fillColor = color;
+            rect.stroked = false;
+        }
+    }
+
+    app.redraw();
+})();

skills/adobe-illustrator-scripting/scripts/find-replace-text.jsx

@@ -0,0 +1,32 @@
+// find-replace-text.jsx
+// Finds and replaces text across all text frames in the active document.
+// Usage: Run from File > Scripts > Other Scripts in Adobe Illustrator.
+
+#target illustrator
+
+(function () {
+    if (app.documents.length === 0) {
+        alert("No document is open.");
+        return;
+    }
+
+    var doc = app.activeDocument;
+
+    var findStr = prompt("Find text:", "");
+    if (findStr === null || findStr === "") return;
+
+    var replaceStr = prompt("Replace with:", "");
+    if (replaceStr === null) return;
+
+    var count = 0;
+    for (var i = 0; i < doc.textFrames.length; i++) {
+        var tf = doc.textFrames[i];
+        var original = tf.contents;
+        if (original.indexOf(findStr) !== -1) {
+            tf.contents = original.split(findStr).join(replaceStr);
+            count++;
+        }
+    }
+
+    alert("Replaced text in " + count + " text frame(s).");
+})();