MightyMouse

Playbooks · Browser extension

Add a first-run welcome page

New installs learn what to do, so fewer uninstall on day one.

Browser extensionProductonboardingretentionfirst run

Run it on my project

The number it moves

Installs that stay

Share of installs still installed after 7 days (installs minus uninstalls).

What your AI does

Find the background service worker and manifest. Check whether chrome.runtime.onInstalled opens an onboarding page or shows the toolbar pin hint. Propose a short welcome page with one task and a pinned-icon hint, plus an uninstall feedback URL via chrome.runtime.setUninstallURL.

Done when

  1. Installing opens a short welcome page with one task
  2. The page shows how to pin the icon
  3. Uninstalling opens a feedback page

The prompt

Paste this into any AI coding tool, or run it in MightyMouse and your AI works on your own project.

Add a first-run welcome page (Browser extension)

Find the background service worker and manifest. Check whether chrome.runtime.onInstalled opens an onboarding page or shows the toolbar pin hint. Propose a short welcome page with one task and a pinned-icon hint, plus an uninstall feedback URL via chrome.runtime.setUninstallURL.

Done when:
- Installing opens a short welcome page with one task
- The page shows how to pin the icon
- Uninstalling opens a feedback page

Read the code first. If it already does this well, change nothing and say so. Otherwise make the smallest change that makes every line above true.

Work with what this project already uses. Do not add a paid tool or service unless I ask for one.

Playbook: https://getmightymouse.com/playbooks/extension-add-a-first-run-welcome-page/ - published by MightyMouse. Source: Chrome for Developers, https://developer.chrome.com/docs/extensions/reference/api/runtime

The skill file

Save this as SKILL.md and Claude Code or Cursor can run the playbook any time you ask.

---
name: extension-add-a-first-run-welcome-page
description: New installs learn what to do, so fewer uninstall on day one. Use on a browser extension project to improve "Installs that stay".
---

# Add a first-run welcome page

Find the background service worker and manifest. Check whether chrome.runtime.onInstalled opens an onboarding page or shows the toolbar pin hint. Propose a short welcome page with one task and a pinned-icon hint, plus an uninstall feedback URL via chrome.runtime.setUninstallURL.

## Done when

- [ ] Installing opens a short welcome page with one task
- [ ] The page shows how to pin the icon
- [ ] Uninstalling opens a feedback page

## How to run it

Read the code first and tick every line that is already true. If all are true, change nothing and say so. Otherwise make the smallest change that makes the rest true, then report each line as done or not done.

Work with what this project already uses. Do not add a paid tool or service unless I ask for one.

Playbook: https://getmightymouse.com/playbooks/extension-add-a-first-run-welcome-page/ - published by MightyMouse. Source: Chrome for Developers, https://developer.chrome.com/docs/extensions/reference/api/runtime

More browser extension playbooks