Manage Skills

When to Use

When a user wants to find skills, install them, create new ones, or understand the skills system.

Verify Installation

After installing a skill, confirm it's available:

gitagent skills list -d ./my-agent | grep "code-review"

Search Skills

# Search SkillsMP registry
gitagent skills search "code review"

# Search GitHub
gitagent skills search "pdf reader" --provider github

# Limit results
gitagent skills search "testing" --limit 5

Install Skills

# Install from SkillsMP to agent-local skills/
gitagent skills install code-review -d ./my-agent

# Install globally to ~/.agents/skills/
gitagent skills install code-review --global

# Install from GitHub
gitagent skills install owner/repo#skills/my-skill --provider github

List Skills

# Show all discovered skills (local + global)
gitagent skills list -d ./my-agent

# Only agent-local skills
gitagent skills list -d ./my-agent --local

Inspect a Skill

gitagent skills info code-review -d ./my-agent

Shows: name, description, license, allowed tools, metadata, optional directories.

Create a Skill

1. Create directory: skills/<name>/
2. Create SKILL.md with frontmatter:

---
name: my-skill
description: What this skill does (max 1024 chars)
license: MIT
allowed-tools: Read Edit Grep Glob Bash
metadata:
  author: your-name
  version: "1.0.0"
  category: developer-tools
---

# Instructions

[Detailed instructions for using this skill.
Keep under ~5000 tokens / ~20000 characters.]

3. Reference it in agent.yaml:

skills:
  - my-skill

4. Validate:

gitagent validate -d ./my-agent

Skill Discovery Paths

Skills are found in this order (first match wins):

Priority	Path
1	<agent>/skills/
2	<agent>/.agents/skills/
3	<agent>/.claude/skills/
4	<agent>/.github/skills/
5	~/.agents/skills/

Optional Directories in Skills

• scripts/ — Executable scripts the skill can reference
• references/ — Reference documents
• assets/ — Images, static files
• agents/ — Skill-specific sub-agents