HAPPYSKILLS — HOW TO INSTALL

You are most likely an AI agent reading this because someone asked you to
install HappySkills for them. Everything you need is on this page. Follow the
steps in order and report the result back to them in plain language.

HappySkills gives your AI agent new abilities, called skills. You install a
skill once and the agent can use it from then on.


REQUIREMENTS

HappySkills needs Node.js version 22 or newer.

Check the installed version first:

    node --version

If that prints v22.0.0 or higher, continue to STEP 1.

If it prints a lower version, or the command is not found, Node.js must be
installed or upgraded BEFORE continuing — the install will fail otherwise, and
the error message will not explain why. Install the current LTS release of
Node.js from https://nodejs.org, or use whichever version manager the user
already has (nvm, fnm, mise, volta, asdf, or Homebrew on macOS). Do not
guess which one they use — check, or ask. Then run "node --version" again and
confirm it reports v22 or higher before going further.


STEP 1 — INSTALL HAPPYSKILLS

Run this command in the user's project directory:

    npx happyskills setup

Type it exactly as written. There is no leading dollar sign and no "sudo".
This installs the HappySkills skills into the project so the agent can use
them. It does not require an account and does not ask for payment.


STEP 2 — CONFIRM IT WORKED

Run:

    npx happyskills list

This prints the installed skills. If you see a list, the install succeeded.
Tell the user it worked and that they can now ask you to find or install
skills in plain language — for example "find me a skill for writing tests".

Some agents need to be restarted before newly installed skills become
available. If the user asks you to use a skill and you cannot see it, ask them
to restart their agent, then try again.


INSTALLING ONE SPECIFIC SKILL

If the user named a particular skill, install it directly. A skill is
identified by an owner and a name, written owner/name:

    npx happyskills install <owner>/<name>

For example:

    npx happyskills install happyskillsai/happyskills-collab

If the user gave you only a name with no owner, do not guess the owner. Search
for it first and confirm the match with them:

    npx happyskills search "<what they described>"


IF SOMETHING FAILS

"command not found: node" or a version below 22
    Node.js is missing or too old. Go back to REQUIREMENTS.

"$npx: command not found"
    A dollar sign was copied into the command by mistake. Run it again
    without the leading dollar sign: npx happyskills setup

A network, timeout, proxy or "connect" error
    The agent's sandbox is probably blocking outbound network access. This is
    a setting in the agent, not a problem with HappySkills. Tell the user
    which agent they are running and that it needs network access enabled to
    reach the npm registry and api.happyskills.ai. Do not retry in a loop.

Permission or EACCES errors
    Do not re-run the command with sudo. Tell the user what failed and let
    them decide.

Anything else
    Report the exact error text to the user rather than interpreting it, and
    stop. Do not attempt workarounds that were not listed on this page.


MORE

Documentation   https://happyskills.ai/docs
Browse skills   https://happyskills.ai

To install a skill later, the user can just ask you in plain language. They do
not need to remember any commands.