Skills

A skill is a small bundle — a SKILL.md plus any helper files — that teaches an AI coding agent how to do one job well: scaffold a revenexx App, follow a house style, drive a release. The Skill Registry hosts the skills your organisation can use, and the skills command group browses that registry and installs skills straight into your agent's skill directory.

The skills commands come from a CLI plugin, so they are present when the CLI is built with that plugin. See the Skills command reference for the exhaustive flag list.

Before you start

The Skill Registry authenticates with your SSO session, not a gateway API key. Sign in once:

revenexx login

With no API key configured, login opens a browser for single sign-on and stores a session token that refreshes automatically; the skills commands reuse it. (You can force the browser flow with revenexx login --browser.) For CI or scripts, pass a session token directly with the global --token flag — it overrides the stored session:

revenexx --token "$REVENEXX_SSO_JWT" skills list

If no session exists and no --token is given, the command exits with a sign-in hint.

By default the CLI talks to https://skills.revenexx.ai. Point it elsewhere with the REVENEXX_SKILLS_API_URL environment variable or the --skills-endpoint <url> flag (the flag wins).

List skills

skills list shows every skill visible to your organisation as a table — repository, name, title, visibility, category, latest version, and whether it is installed for the selected agent.

revenexx skills list

Filter the list server-side:

revenexx skills list --search invoice
revenexx skills list --category codegen
revenexx skills list --tag release --tag ci   # repeatable; matches any tag

• --agent <agent> chooses whose install directory the Installed column reflects (default claude).
• --json prints the raw records — including installed, installed_version, and outdated — for scripting.

Inspect a skill

skills show prints the details for a single skill. Give it <owner>/<repo> and the skill name, or omit arguments to pick interactively — no arguments lists every skill, just the repo narrows to that repository.

revenexx skills show revenexx/app-builder app-builder
revenexx skills show                    # pick interactively

Add --readme to print the skill's README alongside its metadata.

Install or update a skill

skills add downloads a skill and unpacks it into your agent's skill directory. The repository is <owner>/<repo>; the second argument is the skill name.

revenexx skills add revenexx/app-builder app-builder

Re-running add for a skill you already have updates it in place — the target directory is removed and rewritten, so local edits are not preserved. Pin a specific release with --version <v>; without it, the latest published version is installed.

revenexx skills add revenexx/app-builder app-builder            # latest
revenexx skills add revenexx/app-builder app-builder --version 1.2.0

After installing, the CLI reminds you to review the skill contents before trusting it.

Agent directories

--agent selects the coding agent, which decides where the skill lands (relative to the current directory):

An unknown agent, or a missing session and no --token, exits with an error.

revenexx skills add revenexx/app-builder app-builder --agent opencode

Related

• Skills command reference — every subcommand and flag.
• Authentication — how the CLI resolves credentials.
• Scaffolding — create and deploy apps and themes.