# Skill Recorder

**Record yourself doing a task once, then turn it into a skill your AI agent can repeat.**

Skill Recorder captures a real work session on your screen: the clicks, the app and window switches, the pages you visit, and (if you want) your spoken narration. It then uses the **GitHub Copilot CLI** to reconstruct *what you actually did* as a clear **intent plus an ordered list of steps**. From there, one step turns that single run into something an agent can reuse:

- a **Skill**: a `SKILL.md` procedure an agent runs on demand, or - an **Automation**: the same procedure on a schedule or trigger.

Both prefer the agent's **native tools** (like the `gh` CLI or `web_fetch`) over replaying UI clicks, and generalize from your one example, so recording yourself submitting *one* form can teach the agent to submit *all* of them.

<p align="center"> <img src="docs/images/recorder.png" alt="Skill Recorder capture window: a record button, timer, an optional narration toggle with language and microphone settings, and readiness checks" width="420"> &nbsp;&nbsp; <img src="docs/images/library.png" alt="Skill Recorder sessions view: recorded sessions on the left, the reconstructed intent and ordered steps on the right" width="520"> </p>

## How it works

1. 🔴 **Record.** Hit record (or `⌘⇧R` / `Ctrl+Shift+R` from anywhere) and just do your task. Skill Recorder captures your screen and activity locally, in the background. 2. 🎛️ **Control.** While recording, a small always-on-top bar shows capture and microphone state. Mute, unmute, or switch mics on the fly, then finish, or discard (with a confirmation) if the take didn't go to plan. 3. 🧠 **Analyze.** Click Analyze and GitHub Copilot reconstructs one overall intent and an ordered list of steps. Review and edit until it reads right. 4. ✨ **Create.** From an approved analysis, generate a reusable **Skill** and/or a scheduled **Automation**.

## Get started

Skill Recorder is published as a **source