Agent Skills

Ebb provides an official Agent Skill under the velella-sh organization namespace (velella-sh/ebb).

The skill equips AI coding agents with proactive guardrails: before recommending npm i, pip install, picking language runtimes, or upgrading GitHub Actions, the agent checks Ebb to ensure no deprecated or end-of-life dependencies enter the codebase.

Quick Install via skills.sh

Install the official Ebb skill across your agent environment using the skills CLI:

npx skills add velella-sh/ebb

This installs the skill directly from the velella-sh/ebb repository into your local or global agent configuration (.claude/skills/, .cursor/skills/, or .gemini/skills/).

Installation by Agent

Claude Code

Install via skills CLI or place the skill in your project's .claude/skills/ directory:

# Add using skills.sh CLI
npx skills add velella-sh/ebb --target claude

# Or install from local repo clone
mkdir -p .claude/skills
cp -r node_modules/@velella/ebb/skills/ebb .claude/skills/

Cursor & Codex

In Cursor and Codex, skills are automatically discovered when placed in skills/ or referenced in system rules:

npx skills add velella-sh/ebb --target cursor

Antigravity & Gemini CLI

In Antigravity and Gemini CLI:

npx skills add velella-sh/ebb --target gemini

How the Skill Works

The skill guides the agent through three strict verification steps:

1. Detect Project Runtimes: Discovers .nvmrc, Dockerfile, package.json engines, and .python-version to ensure code matches actively supported runtime versions.
2. Check New Packages Before Install: Converts packages to standard Package URLs (PURLs) like pkg:npm/request@2.88.2 and queries Ebb. If deprecated or EOL, the agent halts and proposes a modern replacement (e.g. undici or axios).
3. Verify GitHub Actions: Flags retired Node 12/16 runner actions and out-of-support runner operating systems before committing workflow YAML files.

Example Agent Verdict

When Ebb detects an issue, the agent outputs a structured finding:

- Component: pkg:npm/request@2.88.2
- Status: deprecated
- Deadline / EOL Date: 2020-02-25
- Recommended Replacement: undici, axios, or native fetch
- Evidence: https://www.npmjs.com/package/request