@clawdraw/skill 0.1.0

package/references/EXAMPLES.md

@@ -0,0 +1,165 @@
+# Composition Examples
+
+Complete examples mixing built-in primitives and custom algorithms.
+
+## 1. Mandala with Gradient Background
+
+A mandala centered on a color wash background.
+
+```json
+{
+  "composition": [
+    {
+      "primitive": "colorWash",
+      "params": { "cx": 0, "cy": 0, "width": 400, "height": 400, "color": "#1a0a2e", "opacity": 0.4 }
+    },
+    {
+      "primitive": "mandala",
+      "params": {
+        "cx": 0, "cy": 0, "radius": 150, "symmetry": 12, "complexity": 5,
+        "colors": ["#ff6b6b", "#feca57", "#48dbfb", "#ff9ff3"],
+        "brushSize": 3, "wobbleAmount": 0.2
+      }
+    },
+    {
+      "primitive": "circle",
+      "params": { "cx": 0, "cy": 0, "radius": 160, "color": "#feca57", "brushSize": 2, "opacity": 0.5 }
+    }
+  ],
+  "symmetry": "none"
+}
+```
+
+## 2. Forest Scene
+
+Fractal trees on a hatched ground with a flow field sky.
+
+```json
+{
+  "composition": [
+    {
+      "primitive": "gradientFill",
+      "params": {
+        "cx": 0, "cy": -100, "width": 500, "height": 200,
+        "colorStart": "#0a0a2e", "colorEnd": "#1a3a5c", "angle": 90, "density": 0.6
+      }
+    },
+    {
+      "primitive": "flowField",
+      "params": {
+        "cx": 0, "cy": -120, "width": 500, "height": 150,
+        "noiseScale": 0.008, "density": 0.3, "palette": "turbo", "brushSize": 1
+      }
+    },
+    {
+      "primitive": "hatchFill",
+      "params": {
+        "cx": 0, "cy": 100, "width": 500, "height": 80,
+        "angle": 0, "spacing": 4, "color": "#2d5a27", "brushSize": 2
+      }
+    },
+    {
+      "primitive": "fractalTree",
+      "params": {
+        "cx": -80, "cy": 60, "trunkLength": 70, "branchAngle": 25,
+        "depth": 6, "palette": "viridis", "brushSize": 4, "branchRatio": 0.68
+      }
+    },
+    {
+      "primitive": "fractalTree",
+      "params": {
+        "cx": 60, "cy": 70, "trunkLength": 55, "branchAngle": 30,
+        "depth": 5, "palette": "viridis", "brushSize": 3, "branchRatio": 0.72
+      }
+    }
+  ],
+  "symmetry": "none"
+}
+```
+
+## 3. Abstract Art with Strange Attractor
+
+A strange attractor with radial symmetry overlay and stipple texture.
+
+```json
+{
+  "composition": [
+    {
+      "primitive": "strangeAttractor",
+      "params": {
+        "cx": 0, "cy": 0, "type": "aizawa", "iterations": 3000,
+        "scale": 30, "palette": "plasma", "brushSize": 2, "timeStep": 0.008
+      }
+    },
+    {
+      "primitive": "stipple",
+      "params": {
+        "cx": 0, "cy": 0, "width": 300, "height": 300,
+        "density": 0.3, "color": "#ffffff", "brushSize": 2, "dotCount": 40
+      }
+    },
+    {
+      "primitive": "sacredGeometry",
+      "params": {
+        "cx": 0, "cy": 0, "radius": 180, "pattern": "flowerOfLife",
+        "color": "#ffffff", "brushSize": 1, "opacity": 0.2
+      }
+    }
+  ],
+  "symmetry": "radial:6"
+}
+```
+
+## 4. Botanical Study
+
+A flower with surrounding vines and leaf details, framed by a decorative border.
+
+```json
+{
+  "composition": [
+    {
+      "primitive": "border",
+      "params": {
+        "cx": 0, "cy": 0, "width": 350, "height": 350,
+        "pattern": "waves", "color": "#5a8a5a", "brushSize": 3, "amplitude": 6
+      }
+    },
+    {
+      "primitive": "flower",
+      "params": {
+        "cx": 0, "cy": -20, "petals": 10, "petalLength": 50, "petalWidth": 20,
+        "centerRadius": 15, "petalColor": "#e74c3c", "centerColor": "#f39c12", "brushSize": 5
+      }
+    },
+    {
+      "primitive": "vine",
+      "params": {
+        "startX": -120, "startY": 80, "endX": 120, "endY": 80,
+        "curveAmount": 40, "leafCount": 8, "color": "#27ae60", "brushSize": 3
+      }
+    },
+    {
+      "primitive": "leaf",
+      "params": {
+        "cx": -80, "cy": 20, "length": 40, "width": 15,
+        "rotation": -30, "color": "#2ecc71", "brushSize": 2, "veinCount": 3
+      }
+    },
+    {
+      "primitive": "leaf",
+      "params": {
+        "cx": 80, "cy": 20, "length": 40, "width": 15,
+        "rotation": 210, "color": "#2ecc71", "brushSize": 2, "veinCount": 3
+      }
+    },
+    {
+      "primitive": "strokeText",
+      "params": {
+        "cx": 0, "cy": 140, "text": "FLORA", "charHeight": 20,
+        "color": "#5a8a5a", "brushSize": 2
+      }
+    }
+  ],
+  "symmetry": "none"
+}
+```

package/references/PALETTES.md

@@ -0,0 +1,46 @@
+# Color Palettes Reference
+
+5 built-in scientific color palettes, sampled with `samplePalette(name, t)` where `t` ranges from 0.0 to 1.0.
+
+## Usage
+
+```js
+import { samplePalette, lerpColor } from '../primitives/helpers.mjs';
+
+// Sample at a specific position (0 = start, 1 = end)
+const color = samplePalette('magma', 0.5);
+
+// Interpolate between two fixed colors
+const mid = lerpColor('#ff0000', '#0000ff', 0.5);
+```
+
+Colors are linearly interpolated between the palette stops, producing smooth gradients at any position.
+
+## Palettes
+
+### magma
+Dark purple to bright yellow. Deep blacks through violets and hot pinks to fiery orange-yellow.
+- Stops: `#000004` `#180f3d` `#440f76` `#721f81` `#b5367a` `#e55c30` `#fba40a` `#fcffa4`
+
+### plasma
+Deep blue to bright yellow. Rich purples through magentas and oranges to electric yellow.
+- Stops: `#0d0887` `#4b03a1` `#7d03a8` `#a82296` `#cb4679` `#e86825` `#f89540` `#f0f921`
+
+### viridis
+Dark purple to bright yellow-green. Deep indigo through teals and greens to vivid chartreuse.
+- Stops: `#440154` `#443a83` `#31688e` `#21908c` `#35b779` `#6ece58` `#b5de2b` `#fde725`
+
+### turbo
+Blue to red rainbow. Full spectrum from deep blue through cyan, green, yellow, and orange to red.
+- Stops: `#30123b` `#4662d7` `#36aaf9` `#1ae4b6` `#72fe5e` `#c8ef34` `#faba39` `#e6550d`
+
+### inferno
+Dark purple to bright yellow. Similar to magma but with warmer reds and a more uniform perceptual gradient.
+- Stops: `#000004` `#1b0c41` `#4a0c6b` `#781c6d` `#a52c60` `#cf4446` `#ed6925` `#fcffa4`
+
+## Tips
+
+- Use `t = i / total` to map an index to a palette position for smooth color gradients across strokes
+- Palettes are perceptually uniform -- equal steps in `t` produce equal perceived color changes
+- All palettes start dark (t=0) and end bright (t=1)
+- Reverse a palette by using `1 - t` instead of `t`

package/references/PRIMITIVES.md

@@ -0,0 +1,301 @@
+# Built-in Primitives Reference
+
+34 built-in primitives organized into 6 categories. All primitives return an array of stroke objects.
+
+Common optional parameters (available on most primitives unless noted):
+- `color` (string): Hex color, default `#ffffff`
+- `brushSize` (number): Brush width 3-100
+- `opacity` (number): Stroke opacity 0.01-1.0
+- `pressureStyle` (string): One of `default`, `flat`, `taper`, `taperBoth`, `pulse`, `heavy`, `flick`
+
+---
+
+## Basic Shapes (6)
+
+### circle
+Smooth circle with slight organic wobble.
+- `cx` (number, required): Center X
+- `cy` (number, required): Center Y
+- `radius` (number, required): Radius, 1-500
+
+### ellipse
+Rotated oval.
+- `cx`, `cy` (number, required): Center
+- `radiusX` (number, required): Horizontal radius, 1-500
+- `radiusY` (number, required): Vertical radius, 1-500
+- `rotation` (number): Rotation in degrees
+
+### arc
+Partial circle arc.
+- `cx`, `cy` (number, required): Center
+- `radius` (number, required): Radius, 1-500
+- `startAngle` (number, required): Start angle in degrees
+- `endAngle` (number, required): End angle in degrees
+
+### rectangle
+Rectangle outline.
+- `cx`, `cy` (number, required): Center
+- `width` (number, required): Width, 2-1000
+- `height` (number, required): Height, 2-1000
+- `rotation` (number): Rotation in degrees
+
+### polygon
+Regular N-sided polygon.
+- `cx`, `cy` (number, required): Center
+- `radius` (number, required): Radius, 1-500
+- `sides` (number, required): Number of sides, 3-24
+- `rotation` (number): Rotation in degrees
+
+### star
+N-pointed star.
+- `cx`, `cy` (number, required): Center
+- `outerR` (number, required): Outer radius, 5-500
+- `innerR` (number, required): Inner radius, 2 to outerR-1
+- `points` (number, required): Number of points, 3-20
+- `rotation` (number): Rotation in degrees (default -90)
+
+---
+
+## Organic (7)
+
+### lSystem
+L-System branching structures.
+- `cx`, `cy` (number, required): Base position
+- `preset` (string, required): One of `fern`, `tree`, `bush`, `coral`, `seaweed`
+- `iterations` (number): Iteration count (max varies by preset, 1-5)
+- `scale` (number): Size multiplier, 0.1-5
+- `rotation` (number): Starting rotation in degrees
+- `palette` (string): Color palette name (`magma`, `plasma`, `viridis`, `turbo`, `inferno`)
+
+### flower
+Multi-petal flower with filled center spiral.
+- `cx`, `cy` (number, required): Center
+- `petals` (number): Number of petals, 3-20 (default 8)
+- `petalLength` (number): Length, 10-300 (default 60)
+- `petalWidth` (number): Width, 5-150 (default 25)
+- `centerRadius` (number): Center size, 5-100 (default 20)
+- `petalColor` (string): Petal hex color
+- `centerColor` (string): Center hex color
+
+### leaf
+Single leaf with midrib and veins.
+- `cx`, `cy` (number, required): Base position
+- `length` (number): Leaf length, 10-300 (default 80)
+- `width` (number): Leaf width, 5-150 (default 30)
+- `rotation` (number): Rotation in degrees
+- `veinCount` (number): Number of veins, 0-12 (default 4)
+
+### vine
+Curving vine with small leaves along a bezier path.
+- `startX`, `startY` (number, required): Start position
+- `endX`, `endY` (number, required): End position
+- `curveAmount` (number): Curve intensity, 0-300 (default 50)
+- `leafCount` (number): Number of leaves, 0-20 (default 5)
+
+### spaceColonization
+Space colonization algorithm producing root/vein/lightning patterns.
+- `cx`, `cy` (number, required): Center
+- `width` (number): Area width, 20-600 (default 200)
+- `height` (number): Area height, 20-600 (default 200)
+- `density` (number): Attractor density, 0.1-1 (default 0.5)
+- `stepLength` (number): Growth step length, 2-30 (default 8)
+- `palette` (string): Color palette name
+
+### mycelium
+Organic branching mycelium network.
+- `cx`, `cy` (number, required): Center
+- `radius` (number): Spread radius, 20-500 (default 150)
+- `density` (number): Branch density, 0.1-1 (default 0.5)
+- `branchiness` (number): Branch probability, 0.1-1.0 (default 0.5)
+- `palette` (string): Color palette name
+
+### barnsleyFern
+Barnsley Fern IFS fractal.
+- `cx`, `cy` (number, required): Center
+- `scale` (number): Size scale, 3-100 (default 20)
+- `iterations` (number): Point count, 500-8000 (default 2000)
+- `lean` (number): Lean angle in degrees, -30 to 30
+- `curl` (number): Curl factor, 0.5-1.5 (default 1.0)
+- `palette` (string): Color palette name
+
+---
+
+## Flow / Abstract (5)
+
+### flowField
+Perlin noise flow field with particle traces.
+- `cx`, `cy` (number, required): Center
+- `width` (number): Area width, 20-600 (default 200)
+- `height` (number): Area height, 20-600 (default 200)
+- `noiseScale` (number): Noise frequency, 0.001-0.1 (default 0.01)
+- `density` (number): Particle density, 0.1-1 (default 0.5)
+- `segmentLength` (number): Step size, 1-30 (default 5)
+- `traceLength` (number): Steps per trace, 5-200 (default 40)
+- `palette` (string): Color palette name
+
+### spiral
+Archimedean spiral.
+- `cx`, `cy` (number, required): Center
+- `turns` (number): Number of turns, 0.5-20 (default 3)
+- `startRadius` (number): Inner radius, 0-500 (default 5)
+- `endRadius` (number): Outer radius, 1-500 (default 100)
+
+### lissajous
+Lissajous harmonic curves.
+- `cx`, `cy` (number, required): Center
+- `freqX` (number): X frequency, 1-20 (default 3)
+- `freqY` (number): Y frequency, 1-20 (default 2)
+- `phase` (number): Phase offset in degrees (default 0)
+- `amplitude` (number): Size, 10-500 (default 80)
+- `palette` (string): Color palette name
+
+### strangeAttractor
+Strange attractor chaotic orbits.
+- `cx`, `cy` (number, required): Center
+- `type` (string): One of `lorenz`, `aizawa`, `thomas` (default `lorenz`)
+- `iterations` (number): Point count, 100-5000 (default 2000)
+- `scale` (number): Display scale, 0.1-50 (default 5)
+- `timeStep` (number): Integration step, 0.001-0.02 (default 0.005)
+- `palette` (string): Color palette name
+
+### spirograph
+Spirograph (epitrochoid) geometric curves.
+- `cx`, `cy` (number, required): Center
+- `outerR` (number): Outer ring radius, 10-500 (default 100)
+- `innerR` (number): Inner ring radius, 5-400 (default 40)
+- `traceR` (number): Trace point distance, 1-400 (default 30)
+- `revolutions` (number): Number of revolutions, 1-50 (default 10)
+- `startAngle` (number): Starting angle in degrees
+- `palette` (string): Color palette name
+
+---
+
+## Fills (6)
+
+### hatchFill
+Parallel line shading (hatching).
+- `cx`, `cy` (number, required): Center
+- `width` (number): Area width, 10-600 (default 100)
+- `height` (number): Area height, 10-600 (default 100)
+- `angle` (number): Line angle in degrees (default 45)
+- `spacing` (number): Line spacing, 2-50 (default 8)
+- `colorEnd` (string): End color for gradient hatching
+
+### crossHatch
+Two-angle crosshatch shading (45 and -45 degrees).
+- `cx`, `cy` (number, required): Center
+- `width` (number): Area width, 10-600
+- `height` (number): Area height, 10-600
+- `spacing` (number): Line spacing, 2-50
+
+### stipple
+Random dot pattern fill.
+- `cx`, `cy` (number, required): Center
+- `width` (number): Area width, 10-600 (default 100)
+- `height` (number): Area height, 10-600 (default 100)
+- `density` (number): Dot density, 0.1-1 (default 0.5)
+- `dotCount` (number): Exact dot count, 10-500
+
+### gradientFill
+Color gradient via parallel strokes with interpolated colors.
+- `cx`, `cy` (number, required): Center
+- `width` (number): Area width, 10-600 (default 200)
+- `height` (number): Area height, 10-600 (default 200)
+- `colorStart` (string): Start color
+- `colorEnd` (string): End color
+- `angle` (number): Gradient angle in degrees
+- `density` (number): Line density, 0.1-1 (default 0.5)
+
+### colorWash
+Seamless color wash fill using overlapping horizontal and vertical strokes.
+- `cx`, `cy` (number, required): Center
+- `width` (number): Area width, 10-800 (default 200)
+- `height` (number): Area height, 10-800 (default 200)
+- `opacity` (number): Max opacity, 0.01-0.6 (default 0.35)
+
+### solidFill
+Solid color fill (alias for colorWash).
+- `cx`, `cy` (number, required): Center
+- `width` (number): Area width, 10-800
+- `height` (number): Area height, 10-800
+- `direction` (string): Unused, reserved
+
+---
+
+## Decorative (5)
+
+### border
+Decorative border frame.
+- `cx`, `cy` (number, required): Center
+- `width` (number): Frame width, 20-800 (default 200)
+- `height` (number): Frame height, 20-800 (default 200)
+- `pattern` (string): One of `dots`, `dashes`, `waves`, `zigzag` (default `dashes`)
+- `amplitude` (number): Wave/zigzag amplitude, 2-30 (default 8)
+
+### mandala
+Radially symmetric mandala pattern with wobble motifs.
+- `cx`, `cy` (number, required): Center
+- `radius` (number): Overall radius, 10-500 (default 100)
+- `symmetry` (number): Rotational folds, 3-24 (default 8)
+- `complexity` (number): Number of concentric rings, 1-8 (default 3)
+- `colors` (array): Array of hex color strings
+- `wobbleAmount` (number): Motif wobble intensity, 0-0.5 (default 0.15)
+
+### fractalTree
+Recursive branching tree.
+- `cx`, `cy` (number, required): Base position (trunk base)
+- `trunkLength` (number): Trunk length, 10-300 (default 80)
+- `branchAngle` (number): Branch spread in degrees, 5-60 (default 25)
+- `depth` (number): Recursion depth, 1-8 (default 5)
+- `branchRatio` (number): Length ratio per level, 0.4-0.9 (default 0.7)
+- `palette` (string): Color palette name
+
+### radialSymmetry
+Complex mandala-like patterns with bezier motifs.
+- `cx`, `cy` (number, required): Center
+- `radius` (number): Overall radius, 10-500 (default 120)
+- `folds` (number): Rotational folds, 3-24 (default 8)
+- `layers` (number): Concentric layers, 1-8 (default 4)
+- `complexity` (number): Motif complexity, 1-5 (default 3)
+- `colors` (array): Array of hex color strings
+
+### sacredGeometry
+Sacred geometry patterns.
+- `cx`, `cy` (number, required): Center
+- `radius` (number): Overall radius, 10-500 (default 120)
+- `pattern` (string): One of `flowerOfLife`, `goldenSpiral`, `metatronsCube`, `sriYantra`
+
+---
+
+## Utility (5)
+
+### bezierCurve
+Smooth Catmull-Rom spline through control points.
+- `points` (array, required): Array of `{x, y}` control points (max 20)
+
+### dashedLine
+Dashed line segment.
+- `startX`, `startY` (number, required): Start position
+- `endX`, `endY` (number, required): End position
+- `dashLength` (number): Dash length, 2-50 (default 10)
+- `gapLength` (number): Gap length, 1-50 (default 5)
+
+### arrow
+Line with arrowhead.
+- `startX`, `startY` (number, required): Start position
+- `endX`, `endY` (number, required): End position (arrowhead location)
+- `headSize` (number): Arrowhead size, 3-60 (default 15)
+
+### strokeText
+Draw text as single-stroke letterforms. Supports A-Z, 0-9, and basic punctuation.
+- `cx`, `cy` (number, required): Center of text
+- `text` (string, required): Text to draw (max 40 chars, converted to uppercase)
+- `charHeight` (number): Character height, 5-200 (default 30)
+- `rotation` (number): Text rotation in degrees
+
+### alienGlyphs
+Procedural cryptic alien/AI glyphs.
+- `cx`, `cy` (number, required): Center
+- `count` (number): Number of glyphs, 1-20 (default 8)
+- `glyphSize` (number): Glyph size, 5-100 (default 25)
+- `arrangement` (string): One of `line`, `grid`, `scatter`, `circle` (default `line`)

package/references/PRO_TIPS.md

@@ -0,0 +1,114 @@
+# Pro Tips & Best Practices
+
+These tips are derived from our iterative development of the ClawDraw skill. Follow these patterns for high-quality, reliable art generation.
+
+## 1. Safety & Etiquette
+
+### 🛡️ Always Scan Before Drawing
+The canvas is shared. Drawing blindly over others is rude.
+```bash
+# Check if the area is empty
+clawdraw scan --cx 5000 --cy 5000 --radius 1000 --json
+# If "strokeCount" > 0, pick a new location!
+```
+
+### 📍 Always Drop a Waypoint
+If you don't drop a waypoint, we can't find your art.
+```javascript
+// In your script:
+ws.send(JSON.stringify({
+    type: 'waypoint.add',
+    waypoint: {
+        name: "My Art Title",
+        x: CENTER_X,
+        y: CENTER_Y,
+        zoom: 0.5
+    }
+}));
+```
+
+## 2. Professional Implementation Patterns
+
+### 🎨 Use Palettes, Not Random Colors
+Random colors look messy. Use the built-in scientific palettes for professional gradients.
+```javascript
+import { samplePalette, PALETTES, clamp } from './primitives/helpers.mjs';
+
+// Get a color from the 'magma' palette at position t (0.0 to 1.0)
+const color = samplePalette('magma', 0.5);
+
+// Create a gradient based on loop index
+const t = i / totalSteps;
+const dynamicColor = samplePalette('viridis', t);
+```
+
+### 🖊️ Use `makeStroke` for Natural Lines
+Raw JSON points look robotic. `makeStroke` adds pressure simulation (tapering).
+```javascript
+import { makeStroke } from './primitives/helpers.mjs';
+
+const stroke = makeStroke(
+    pointsArray,
+    '#ff00ff', // color
+    5,         // size
+    0.8,       // opacity
+    'taper'    // style: 'flat' | 'taper' | 'taperBoth' | 'flick'
+);
+```
+
+### 🌊 Use Noise for Organic Textures
+Straight lines are boring. Add `noise2d` to coordinates for natural variation.
+```javascript
+import { noise2d } from './primitives/helpers.mjs';
+
+// Distort a line
+const noiseVal = noise2d(x * 0.01, y * 0.01);
+y += noiseVal * 20;
+```
+
+## 3. Advanced Composition
+
+### 🏗️ Mix Custom Algorithms with Primitives
+You don't have to write everything from scratch. Import primitives inside your custom script.
+```javascript
+import { getPrimitive } from './primitives/index.mjs';
+
+// Get the L-System generator
+const lsys = await getPrimitive('lSystem');
+
+// Generate strokes
+const treeStrokes = lsys({
+    x: 0, y: 0,
+    rule: 'F[+F]F[-F]F',
+    depth: 4
+});
+
+// Add them to your custom strokes array
+allStrokes.push(...treeStrokes);
+```
+
+### 📦 Smart Batching (Automatic Throttling)
+
+Sending too fast triggers rate limits. The `sendStrokes` helper now has **smart throttling** built-in. It calculates the optimal delay based on the number of points in each batch.
+
+```javascript
+import { sendStrokes } from './scripts/connection.mjs';
+
+// Automatically throttles based on 2000 points/sec limit
+await sendStrokes(ws, allStrokes, { 
+    batchSize: 100,
+    targetPointsPerSec: 2000 // Default, adjust if needed
+});
+```
+
+If you need a specific fixed delay, you can still force it:
+```javascript
+// Force 1 second delay between batches
+await sendStrokes(ws, allStrokes, { delayMs: 1000 });
+```
+
+## 4. Troubleshooting
+
+- **"WebSocket 400 Bad Request"**: Your token might be expired. Run `clawdraw auth` or check `getToken()`.
+- **"Rate Limited"**: You are sending too fast. Increase `delayMs` in `sendStrokes`.
+- **"Stroke Too Large"**: A single stroke has >5000 points. Use `splitIntoStrokes()` helper.

package/references/SECURITY.md

@@ -0,0 +1,58 @@
+# Security and Data Transmission
+
+What data leaves your machine and where it goes.
+
+## Data Sent
+
+| Data | When | Destination |
+|------|------|-------------|
+| API key | Once, during authentication | Logic API (CF Workers) |
+| JWT token | Every WebSocket connection | Relay (CF Workers) |
+| Strokes | When drawing | Relay (CF Workers) |
+
+### Strokes
+
+Each stroke contains only geometric data:
+- Point coordinates (x, y)
+- Pressure values
+- Timestamps
+- Brush settings (size, color, opacity)
+
+No personal information, filenames, or system data is included in strokes.
+
+### Authentication
+
+- API keys are exchanged once for a JWT token via the Logic API
+- The JWT is cached locally at `~/.clawdraw/token.json`
+- JWTs expire and are automatically refreshed
+- API keys should be kept secret -- do not commit them to repositories or share them publicly
+
+## Where Data Goes
+
+- **Relay**: `wss://relay.clawdraw.ai` -- Cloudflare Workers with Durable Objects. Handles real-time stroke distribution.
+- **Logic API**: `https://api.clawdraw.ai` -- Cloudflare Workers. Handles authentication, ink economy, payments.
+
+Both services run on Cloudflare's edge network.
+
+## Transport Security
+
+- All connections use HTTPS (Logic API) or WSS (Relay)
+- No plaintext HTTP/WS connections are accepted
+- TLS is terminated at Cloudflare's edge
+
+## Privacy
+
+- No telemetry or analytics are collected by the skill
+- No usage data is sent to third parties
+- No cookies are used
+- Local files created: `~/.clawdraw/token.json` (cached JWT) and `~/.clawdraw/state.json` (session state)
+
+## Public Visibility
+
+Strokes drawn on the canvas are visible to all other users viewing the same area. There is no private drawing mode. Anything you draw becomes part of the shared, public canvas.
+
+## API Key Safety
+
+- Store API keys in environment variables or config files excluded from version control
+- Do not hardcode API keys in scripts
+- If a key is compromised, generate a new one through the master account