Installing Califa Agent Skills

Califa Agent Skills is a library of Califa methods that coding agents can use while they work. It currently includes Better User Research, with System Design and Team Design coming soon. The installer detects supported agents, writes one canonical copy of each skill, and links it wherever each tool expects to find skills.

Before you begin

You need Node.js 20 or newer. The installer supports Codex, Claude Code, Cursor, Windsurf, Gemini CLI, OpenCode, Amp, and GitHub Copilot.

Run the installer

Choose npm or curl. Both commands run the same published installer and open the same interactive setup.

npx --yes @califaco/skills@latest

curl -fsSL https://califa.co/api/install-skills | bash

The curl command fetches the installer script straight from the public repository. The package itself is published as @califaco/skills, and the source is public on GitHub.

Install as a Claude Code plugin

In Claude Code, install the library as a plugin. Updates arrive through /plugin, and Node.js isn't needed:

/plugin install califa-skills --marketplace califa/skills

On Claude Code versions before 2.1.275, add the marketplace first with /plugin marketplace add califa/skills, then run /plugin install califa-skills@califa.

The repository uses the standard skills layout, so other skill installers work too, such as npx skills add califa/skills.

Choose what to install

The installer lets you pick individual skills or install the whole library. To install everything without that prompt, add --all. To install one skill, add its name, such as ux-research for Better User Research:

npx --yes @califaco/skills@latest ux-research

curl -fsSL https://califa.co/api/install-skills | bash -s -- ux-research

Choose where it installs

Choose For me to make the skills available across projects, or Current project to keep it inside the repository you are working in. Personal installs use ~/.agents/skills; project installs use .agents/skills in the current directory. The installer creates links for agents that use their own skills directory.

Install without prompts

For scripts and automated environments, pass the skills, scope, and confirmation flags explicitly:

npx --yes @califaco/skills@latest --all --scope project --yes

The equivalent curl command is:

curl -fsSL https://califa.co/api/install-skills | bash -s -- --all --scope project --yes

To preview the files and links without changing anything, add --dry-run.