open-gitagent/manage-skills

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