krishhggkrishhgg/Insomnia/skills/install-insomnia/SKILL.md

install-insomnia

Skill1.7k starsChanged 14 days agoMITView on GitHub

Install or upgrade Insomnia, the macOS menu bar app that keeps a Mac awake for a timed session, from a GitHub release or from source. Use when the user asks to install, update or reinstall Insomnia.

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Read that page, then follow these steps.
line 10
Very specific:
Pick the channel: Use the latest stable release unless the user asked for the newest nightly.
line 18
Distinctive:
Download and verify: Follow "Install a release yourself", steps 1 and
line 21
Very specific:
Run both checks. Keep --source-digest and the full 40-character commit.
line 22
Distinctive:
If either check fails, stop and tell the user.
line 23

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Install Insomnia

The exact commands are in docs/install.md. Read that page, then follow these steps. Never run sudo yourself and never pass a password to it. When a step needs the administrator password, give the user the exact command to run in Terminal and wait for them to say it finished.

Check the Mac. Insomnia needs macOS 26 or later (sw_vers -productVersion). Release zips run only on Apple Silicon: sysctl -n hw.optional.arm64 prints 1. On an Intel Mac, use "Build from source" and tell the user that build is untested on Intel.
Pick the channel. Use the latest stable release unless the user asked for the newest nightly. If the release is v0.1.0, follow its release notes instead of docs/install.md.
Download and verify. Follow "Install a release yourself", steps 1 and 2. Run both checks. Keep --source-digest and the full 40-character commit. If either check fails, stop and tell the user. Do not download a different file to get past it.
Install. Step 3 of the same section runs install.sh, which asks for the administrator password, so hand that command to the user. Before they run it, tell them the installer adds a sudoers rule. That rule lets their account run four pmset power commands without a password, and the page's "What gets installed" section lists them. --allow-unverified-origin tells the installer that both download checks passed. Never suggest it when they did not.
First launch. macOS blocks the first launch of a downloaded app until the user allows it in System Settings > Privacy & Security.
Confirm. The eye shows in the menu bar, and launchctl print gui/$(id -u)/com.insomnia.backstop finds the recovery agent. Ask the user to review the lid-close options in Settings before the first session.

An upgrade is the same steps. The installer asks the running app to quit and stops if a session is still waiting to be undone. Then use the maintain-insomnia skill to find out why.

To build from source, follow "Build from source" on the same page. Its ./scripts/install.sh also needs the password.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free