skills.rest
jamsdoescode
jamsdoescodeCOMMUNITY
Explore all skills by this author →
GitHub

openclicky-screen-tour

Creates recordable on-screen visual tours with markers, cursor choreography, captions, and speech.

Updated Jul 7, 2026
Search Tags:#text-to-speech#macos#demo recording#cursor animation#screen tour#openclicky#visual markers
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill openclicky-screen-tour-jamsdoescode
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openclicky-screen-tour
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/openclicky-screen-tour
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill openclicky-screen-tour-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Explaining what is on screen or recording a guided demo is hard when you must manually point at UI elements. This Skill automates visual screen tours on macOS by placing multiple simultaneous markers, animating a primary cursor, adding captions, and speaking short explanations through OpenClicky's local control bridge. ## Core Features & Use Cases - Multi-Marker Overlays: Display several labeled, color-coded markers at once via the local bridge at http://127.0.0.1:32123, focused into a chosen screen region for easy recording. - Primary Cursor Choreography: Animate the OpenClicky pointer to visit each item with smooth point-and-return motion, without warping the real macOS pointer. - Screenshot-Driven Tours: Capture screenshots first to locate UI elements, then place markers and narrate what is visible. - Use Case: A user says "focus a tour on the top-left quarter so I can record a demo" — the Skill computes coordinates from the screen's visibleFrame, places 3-6 captioned markers, visits each with the primary cursor, and speaks a short summary. ## Quick Start Ask the assistant to create a visual tour of a specific area of your screen, such as "give me a recordable tour of the top-left quarter highlighting the menu bar, editor, and sidebar."

Frequently Asked Questions about openclicky-screen-tour

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a visual screen tour on macOS?▼

Use OpenClicky's local bridge at http://127.0.0.1:32123 to POST markers to /cursors, animate the primary pointer with /cursor, and narrate with /speak. Compute coordinates from the screen's visibleFrame so markers land in the intended region.

How do I show multiple on-screen markers at the same time?▼

Send a single POST to the /cursors endpoint with an array of cursor objects, each with x, y, caption, and accentHex values. Use /clear between scenes so old markers do not clutter the recording.

Does the screen tour move the real macOS mouse pointer?▼

No. The primary cursor choreography uses OpenClicky's own smooth point-and-return animation and must not warp the real macOS pointer. Secondary markers are temporary overlays, not actual cursor movements.

Why do my tour markers cluster in the bottom-left corner?▼

Hardcoded low coordinates like 500,500 cluster at the bottom-left because AppKit uses a bottom-left origin. Calculate points from the current screen's visibleFrame instead so markers scale correctly across displays.

What visual effects can the screen tour not display?▼

Tours cannot show spotlight masks, persistent highlight boxes, arrows, or area dimming. Supported visuals are markers, captions, temporary freehand scribbles via show_scribble, and bounded rectangles via show_highlight or show_rectangle.

Related Skills

Explore More Design & Creative Skills→
jasonkneenjasonkneen
471

openclicky-screen-control

Provide screen overlay captions, pointing, and voice output on macOS.

Community
Intermediate
gerald-icagerald-ica

openscreen

Record screens and edit videos with timeline-based tools for WebM export.

Community
Intermediate
nmoralescybernmoralescyber

create-workflow-demo

Generate scene-by-scene product walkthrough scripts with narration and timing.

Community
Advanced
vathymutvathymut

image-annotations

Annotate images with callouts, arrows, labels, and highlights using PIL.

Community
Intermediate