diff --git a/.cursor/skills/new-changelog/SKILL.md b/.cursor/skills/new-changelog/SKILL.md
new file mode 100644
index 0000000000..848f875737
--- /dev/null
+++ b/.cursor/skills/new-changelog/SKILL.md
@@ -0,0 +1,16 @@
+---
+name: new-changelog
+description: Create the next desktop changelog entry when asked to add a changelog file or prepare the next release note under `packages/changelog/content`. Use this when the task is specifically about determining the next version and creating the markdown entry.
+metadata:
+  internal: true
+---
+
+# New Changelog
+
+This is a compatibility entry for Cursor-specific skill discovery. The
+canonical, universal instructions live at:
+
+`../../../.agents/skills/new-changelog/SKILL.md`
+
+Read that file completely and follow it. Do not maintain a second checklist
+here; changes belong in `.agents/skills/new-changelog/`.
diff --git a/.cursor/skills/qa-cli-mcp-api/SKILL.md b/.cursor/skills/qa-cli-mcp-api/SKILL.md
new file mode 100644
index 0000000000..02cd57ee40
--- /dev/null
+++ b/.cursor/skills/qa-cli-mcp-api/SKILL.md
@@ -0,0 +1,14 @@
+---
+name: qa-cli-mcp-api
+description: Select and run risk-based QA for Anarlog's CLI, webhooks, stdio MCP, hosted Cloud API, and remote MCP. Test only affected lanes for a branch or regression; use every lane only for an explicit programmatic-interface release gate.
+---
+
+# QA: CLI, MCP, and API
+
+This is a compatibility entry for Cursor-specific skill discovery. The
+canonical, universal instructions live at:
+
+`../../../.agents/skills/qa-cli-mcp-api/SKILL.md`
+
+Read that file completely and follow it. Do not maintain a second checklist
+here; changes belong in `.agents/skills/qa-cli-mcp-api/`.
diff --git a/.cursor/skills/qa-critical-ux/SKILL.md b/.cursor/skills/qa-critical-ux/SKILL.md
new file mode 100644
index 0000000000..59aa9218ae
--- /dev/null
+++ b/.cursor/skills/qa-critical-ux/SKILL.md
@@ -0,0 +1,14 @@
+---
+name: qa-critical-ux
+description: QA the critical Pro user journey before a desktop release — onboards from scratch, launches without hanging, captures microphone and system audio, and produces an automated summary. Use before cutting a stable release or when asked to QA the app.
+---
+
+# QA: Critical User Experience
+
+This is a compatibility entry for Cursor-specific skill discovery. The
+canonical, universal instructions and scripts live at:
+
+`../../../.agents/skills/qa-critical-ux/SKILL.md`
+
+Read that file completely and follow it. Do not maintain a second checklist
+here; changes belong in `.agents/skills/qa-critical-ux/`.
diff --git a/.cursor/skills/release-new-version/SKILL.md b/.cursor/skills/release-new-version/SKILL.md
new file mode 100644
index 0000000000..8dba3cb8ad
--- /dev/null
+++ b/.cursor/skills/release-new-version/SKILL.md
@@ -0,0 +1,16 @@
+---
+name: release-new-version
+description: Release a new desktop stable version for Anarlog. Use when asked to cut, publish, or prepare a new stable desktop release after checking and merging the changelog.
+metadata:
+  internal: true
+---
+
+# Release a New Desktop Version
+
+This is a compatibility entry for Cursor-specific skill discovery. The
+canonical, universal instructions live at:
+
+`../../../.agents/skills/release-new-version/SKILL.md`
+
+Read that file completely and follow it. Do not maintain a second release
+checklist here; changes belong in `.agents/skills/release-new-version/`.
diff --git a/AGENTS.md b/AGENTS.md
index 211c2c7d93..09676a3e9c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -82,3 +82,4 @@ Environment is Ubuntu 24.04 x86_64. Node 22, pnpm 11.1.1, and Rust 1.94.0 are pr
 - `pnpm fmt:check` (`dprint check`) reports ~67 failures on Linux, all Swift files ("Cannot start formatter process") because `dprint` shells out to `swift format`, which is macOS-only. These are not real diffs; non-Swift formatting still validates. Scope fmt checks to changed non-Swift files on Linux.
 - No audio input device exists in the headless pod; use `crates/audio-mock` for recording flows. `apps/mobile` (Expo) and `apps/cli-ui` (Swift) cannot be built/run on Linux.
 - The default `cc`/`c++` are clang (not gcc). The desktop build compiles a C++ dependency (`knf-rs-sys` from pyannote-rs) via cmake, and clang selects the newest GCC install dir for `libstdc++`, so `libstdc++-14-dev` must be present (it is in the base image). Data path is verified: creating a note writes to `sessions`/`session_documents` (ProseMirror JSON) in the SQLite DB at `~/.local/share/com.hyprnote.dev/app.db`.
+- Changelog, release, and QA skills are exposed to Cursor Cloud via `.cursor/skills/` shims (`new-changelog`, `release-new-version`, `qa-critical-ux`, `qa-cli-mcp-api`). Canonical copies live in `.agents/skills/`; edit those only. `qa-critical-ux` is macOS-native and is not a cloud-environment gate.