Skip to content

Desktop app that records your on-screen work session and uses the GitHub Copilot SDK to reconstruct it as an intent + ordered steps, then builds a reusable Skill or Automation for Microsoft Autopilots like Scout, Microsoft Copilot Cowork, or Copilot Studio.

docs: direct users to release installation commands

Giorgio Ughini906ec7e3aba9
diff --git a/INSTALL.md b/INSTALL.md
index 47e56ea..57dad22 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -1,5 +1,16 @@
# Installing Skill Recorder from source
+> [!TIP]
+> **Just want to install and use the app? [Go to the latest release](https://github.com/microsoft/skill-recorder/releases/latest).**
+> Scroll to **Commit-pinned installation** and copy the complete command for your
+> operating system. Paste it into **PowerShell** on Windows or **Terminal** on
+> macOS or Ubuntu, then press **Enter**. No changes to the command are needed.
+> See the [step-by-step guide](README.md#install-it) for more help.
+
+This page is the **advanced installation reference**, including script inspection,
+configuration, and manual developer setup. The commands below are templates, not
+ready-to-run release commands.
+
Skill Recorder can run directly from an exact source revision on Windows, macOS,
or Ubuntu. These methods do not download a prebuilt Skill Recorder application.
Node.js, Electron, native dependencies, and the GitHub Copilot CLI are obtained
@@ -14,7 +25,10 @@ compliance bundle.
## Commit-pinned one-line installation
Replace `<40-character-release-commit>` with the full 40-character commit SHA
-published for the release.
+published for the release. Do not run a command with that placeholder still in it:
+it is not a real version and the download will fail. For a command with the correct
+value already filled in, use the
+[latest release](https://github.com/microsoft/skill-recorder/releases/latest).
### Windows 11 x64 or ARM64
@@ -164,6 +178,14 @@ installed revision.
## Manual developer setup
+> [!IMPORTANT]
+> **This section is for developers who want to work on the code. It is not required
+> to install or use Skill Recorder.** Use the ready-to-run command on the
+> [release page](https://github.com/microsoft/skill-recorder/releases/latest) instead.
+> If you continue below, replace `<40-character-release-commit>` with the release's
+> actual full commit SHA before running any commands. Pasting the placeholder
+> literally causes a **404 Not Found** error and the remaining steps cannot work.
+
Install Node.js 24.19 or newer within the Node.js 24 release line from its
official publisher. This supplies npm 11.17 or newer, which is required to
enforce the reviewed dependency lifecycle-script policy. Download the exact
diff --git a/README.md b/README.md
index 0cb1dfd..87ca1e8 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,12 @@
**Record yourself doing a task once, then turn it into a skill your AI agent can repeat.**
+> [!TIP]
+> **Want to install Skill Recorder? [Go to the latest release](https://github.com/microsoft/skill-recorder/releases/latest).**
+> Scroll to **Commit-pinned installation** and copy the complete command for your
+> operating system. It is ready to paste: you do not need to edit it or download
+> the source code yourself. [Step-by-step instructions below](#install-it).
+
Skill Recorder captures a real work session on your screen: the clicks, the app and
window switches, the pages you visit, commands/output from its optional recorded terminal,
and (if you want) your spoken narration. It then uses
@@ -47,32 +53,35 @@ macOS is the primary target. Windows 11 (x64 and ARM64) is supported too (see
### Install it
Open the **[latest release](https://github.com/microsoft/skill-recorder/releases/latest)** and
-copy the command for your platform. Each release pins an exact commit, so the real command looks
-like the patterns below with `<40-character-release-commit>` filled in.
-
-**macOS / Ubuntu**
-
-```bash
-commit="<40-character-release-commit>"; curl -fsSL "https://raw.githubusercontent.com/microsoft/skill-recorder/$commit/install.sh" | SKILL_RECORDER_COMMIT="$commit" bash
-```
-
-The commit pins both the downloaded script and the source it builds. To keep the app running
-after the terminal closes, add `SKILL_RECORDER_DETACHED=1` after the pipe:
-
-```bash
-commit="<40-character-release-commit>"; curl -fsSL "https://raw.githubusercontent.com/microsoft/skill-recorder/$commit/install.sh" | SKILL_RECORDER_COMMIT="$commit" SKILL_RECORDER_DETACHED=1 bash
-```
-
-On macOS this adds a **Skill Recorder (Source)** app to `~/Applications` (relaunch from Spotlight,
-Launchpad, or the Dock). On Ubuntu it adds a matching application entry.
-
-**Windows (PowerShell)**
-
-```powershell
-$commit="<40-character-release-commit>"; $env:SKILL_RECORDER_COMMIT=$commit; irm "https://raw.githubusercontent.com/microsoft/skill-recorder/$commit/install.ps1" | iex
-```
-
-This adds **Skill Recorder (Source)** shortcuts to your desktop and Start Menu.
+follow these steps:
+
+1. On the release page, scroll to **Commit-pinned installation**. Find **Windows 11
+ x64 or ARM64** or **macOS or Ubuntu**, then copy the **entire command** in that
+ section using the copy button at the top-right of the code block.
+2. Open **PowerShell** from the Windows Start menu, or **Terminal** on macOS or
+ Ubuntu. Paste the command and press **Enter**.
+3. Keep that window open while installation completes. The installer downloads
+ what it needs, builds the app on your computer, creates shortcuts, and launches
+ Skill Recorder. The first installation can take several minutes.
+
+> [!IMPORTANT]
+> **Copy the command from the release page, not a template from the technical docs.**
+> The release command already contains the correct version identifier; there is
+> nothing to replace. Do not paste commands containing
+> `<40-character-release-commit>` literally.
+> You do **not** need Git, a separate Node.js installation, or the **Manual developer
+> setup** instructions. The **Source code (zip)** and **Source code (tar.gz)** links
+> under **Assets** are not app installers.
+
+To review the script before running it, follow the release page's
+**inspect-first instructions** instead. Installation remains subject to your
+organization's policies.
+
+**Open it again later:** use **Skill Recorder (Source)** on your Windows desktop or
+Start Menu; on macOS, find it in `~/Applications`, Spotlight, or Launchpad; on
+Ubuntu, use the matching application entry. You do not need to reinstall each time.
+Advanced options, including running in the background on macOS or Ubuntu, are in
+[`INSTALL.md`](INSTALL.md#commit-pinned-one-line-installation).
### Then record
@@ -154,6 +163,9 @@ The in-app "Records your screen and activity" panel spells out exactly what's co
## Develop from source
+**For developers changing the code, not for installing the app.** To use Skill
+Recorder, follow [Install it](#install-it) instead.
+
Requires **Node.js 24**. After checking out a release revision:
```bash