Skip to main content

Agent Skills

What are skills?​

AI Skills are reusable instruction sets that enhance the capabilities of AI coding agents. They provide structured guidance that agents can follow when performing specific tasks — like reviewing code, enforcing conventions, or generating boilerplate.

Skills are managed and installed through the Abyss CLI. For more information about AI agent skills, visit agentskills.

Installing skills​

Before you can install skills, ensure you have the Abyss CLI set up properly:

npx @uhg-abyss/cli -v

If the command fails, refer to the CLI Setup Guide page for installation instructions.

To discover what skills are available, use the skills find command:

npx @uhg-abyss/cli skills find

This opens an interactive searchable list of all available skills in the catalog.

Once you've found a skill you want to install, use the skills add command:

npx @uhg-abyss/cli skills add <skill-name>

The CLI will guide you through an interactive process to install the skill to your preferred AI coding agents.

Supported agents​

The Abyss CLI supports installing skills to the following AI coding agents:

AgentProject PathGlobal Path
Antigravity.agent/skills/~/.gemini/antigravity/skills/
Claude Code.claude/skills/~/.claude/skills/
Codex.agents/skills/~/.codex/skills/
Cursor.agents/skills/~/.cursor/skills/
Gemini CLI.agents/skills/~/.gemini/skills/
GitHub Copilot.agents/skills/~/.copilot/skills/
Windsurf.windsurf/skills/~/.codeium/windsurf/skills/
  • Project scope installs skills into the current working directory (committed with your project)
  • Global scope installs skills into your home directory (available across all projects)

Agents that share the same project path (e.g. Cursor, Codex, GitHub Copilot, and Gemini CLI all use .agents/skills/) are grouped into a single install target to avoid duplicate files.

Commands​

skills help​

Display all available skills commands and their usage.

npx @uhg-abyss/cli skills help

skills add​

Install a skill by name. The CLI walks you through selecting install targets, scope, and method interactively.

npx @uhg-abyss/cli skills add <skill-name>

skills list​

List all installed skills with their locations and scope.

Options:

FlagDescription
-g, --globalShow only globally installed skills
-a, --agent <slug>Filter by agent (e.g. windsurf, claude-code, cursor)
# List all installed skills
npx @uhg-abyss/cli skills list


# List only global skills
npx @uhg-abyss/cli skills list --global


# List skills installed for Windsurf
npx @uhg-abyss/cli skills list --agent windsurf

Note: You can also use the shorter command skills ls.

skills find​

Search for skills in the catalog. If no query is provided, opens an interactive searchable list.

# Interactive search
npx @uhg-abyss/cli skills find


# Direct keyword search
npx @uhg-abyss/cli skills find <search-query>

skills remove​

Remove installed skills. If no skill names are provided, opens an interactive multiselect to choose which skills to remove.

# Interactive removal
npx @uhg-abyss/cli skills remove


# Remove specific skills by name
npx @uhg-abyss/cli skills remove <skill-name>

Options:

FlagDescription
-g, --globalRemove only globally installed skills
-a, --agent <slug>Filter by agent

Note: You can also use the shorter command skills rm.

skills check​

Check if any installed skills have updates available in the catalog.

npx @uhg-abyss/cli skills check

Compares each installed skill against the latest version in the catalog and reports which ones have updates available.

skills update​

Update all installed skills to the latest version from the catalog.

npx @uhg-abyss/cli skills update

Skills that are already up to date are skipped. The command reports how many were updated and how many were skipped.

Feedback and issue reporting​

If you encounter issues with any Abyss AI skills, you can report them directly from your coding session using the abyss-report-skill-issue skill. For general feedback, suggestions, or questions, visit the AI Skills category in GitHub Discussions.

What it does​

The abyss-report-skill-issue skill streamlines issue reporting by:

  • Automatically capturing context from your current session
  • Detecting which skill you were using
  • Identifying your environment (Abyss version, AI tool)
  • Guiding you through structured reporting
  • Creating GitHub Discussions in the AI Skills category with proper formatting

When to use it​

Use this skill when:

  • An Abyss AI skill produces incorrect results
  • A skill behaves inconsistently (different results for same input)
  • A skill crashes or throws errors
  • A skill is missing functionality you need

For suggestions, questions, or general feedback:

Don't use for:

  • Questions about Abyss components (use the Help category in GitHub Discussions)
  • General Abyss library bugs (file directly in the Bug category in Discussions)

Installation​

npx @uhg-abyss/cli skills add abyss-report-skill-issue

Example prompts​

Once installed, you can say to your AI agent:

  • "This isn't working, help me report it"
  • "Report skill issue"
  • "File a bug for the migration skill"

How it works​

The skill automatically collects:

Skill information:

  • Which skill you were using (from conversation history)
  • Error messages or unexpected output

Environment details:

  • Abyss version (@uhg-abyss/web or @uhg-abyss/mobile)
  • AI tool you're using (Claude Code, GitHub Copilot, Windsurf, Codex, etc.)
  • AI model (e.g., Claude Sonnet 4.6, Codex 5.3)
  • Platform (web/mobile)

Then guides you through clarifying questions:

  • Which skill? (if not auto-detected)
  • What type of issue? (bug, inconsistent behavior, incorrect output, missing functionality, performance, confusing instructions, suggestion, question)
  • What happened? (what you were trying to do, what you expected, what actually happened, error messages)
  • Additional context? (optional)

Finally, it creates a GitHub Discussion in the AI Skills category with [AI Skill] prefix for easy filtering.

Table of Contents