Agent skill

manage-skills

Searches the SkillsMP registry, installs skills locally or globally, creates custom skills with SKILL.md frontmatter, and manages the skill lifecycle. Use when the user wants to find skills, add new capabilities, install a skill, browse available skills, create a custom skill, or manage the skills system.

Stars 2,657
Forks 321

Install this agent skill to your Project

npx add-skill https://github.com/open-gitagent/gitagent/tree/main/examples/gitagent-helper/skills/manage-skills

Metadata

Additional technical details for this skill

author
gitagent
version
1.0.0
category
skills

SKILL.md

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:

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

Search Skills

bash
# 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

bash
# 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

bash
# 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

bash
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:
markdown
---
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.]
  1. Reference it in agent.yaml:
yaml
skills:
  - my-skill
  1. Validate:
bash
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

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results