progress

.opencode/skills/kq4-polygon-drawer/SKILL.md

@@ -0,0 +1,67 @@
+# Polygon Drawer Skill
+
+This skill uses @tools/draw_polygon.py to draw polygons on any image. It's useful for highlighting areas, marking objects, creating masks, or annotating images with colored shapes.
+
+## Usage Examples
+
+### Draw a red box around an object
+```
+Draw a red box around the door in image.png
+# Executes: python tools/draw_polygon.py tmp/annotated_image.png "0.3,0.2 0.7,0.2 0.7,0.8 0.3,0.8" --color red --save tmp/annotated_image.png
+# Opens: /home/noti/dev/ai-game-2/tmp/annotated_image.png
+```
+
+### Highlight an area in green
+```
+Highlight the pool in green using a polygon
+# Executes: python tools/draw_polygon.py tmp/pool_highlight.png "0.2,0.5 0.8,0.5 0.8,0.9 0.2,0.9" --color green --fill --save tmp/pool_highlight.png
+# Opens: /home/noti/dev/ai-game-2/tmp/pool_highlight.png
+```
+
+### Draw a blue circle (approximated with polygon)
+```
+Draw a blue circle around the tree
+# Executes: python tools/draw_polygon.py tmp/tree_circle.png "0.4,0.3 0.6,0.3 0.6,0.5 0.4,0.5" --color blue --save tmp/tree_circle.png
+# Opens: /home/noti/dev/ai-game-2/tmp/tree_circle.png
+```
+
+### Fill a region with semi-transparent overlay
+```
+Fill the sky area with semi-transparent yellow
+# Executes: python tools/draw_polygon.py tmp/sky_overlay.png "0,0 1,0 1,0.6 0,0.6" --color yellow --fill --save tmp/sky_overlay.png
+# Opens: /home/noti/dev/ai-game-2/tmp/sky_overlay.png
+```
+
+### Mark a specific point with a small polygon
+```
+Mark the character location with a red polygon
+# Executes: python tools/draw_polygon.py tmp/character_mark.png "0.5,0.4 0.52,0.38 0.54,0.4 0.52,0.42" --color red --save tmp/character_mark.png
+# Opens: /home/noti/dev/ai-game-2/tmp/character_mark.png
+```
+
+## How It Works
+
+1. **Analyze** the image to understand what needs highlighting
+2. **Extract** polygon coordinates based on visual patterns or user input
+3. **Execute** the draw_polygon.py script with percentage coordinates (0.0-1.0)
+4. **Save** the result to ./tmp/ and display the file path
+5. **Open** the output for you to view
+
+## Coordinate System
+
+Coordinates use **percentage mode** (0.0-1.0) by default:
+- `0.0,0.0` = top-left corner
+- `1.0,1.0` = bottom-right corner
+- `0.5,0.5` = center of image
+
+## Common Use Cases
+
+- Highlighting objects or regions of interest
+- Creating masks for image processing
+- Marking locations for documentation
+- Annotating images with colored boundaries
+- Visualizing spatial relationships
+
+## Output
+
+All annotated images are saved to `./tmp/` and the full path is displayed so you can open them in your image viewer.