Manage skills

Skill open-gitagent/opengap/examples/gitagent-helper/skills/manage-skills

A framework-agnostic, git-native standard for defining AI agents

Install

npx -y skills add open-gitagent/opengap --skill manage-skills

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

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.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.5 KB, as published. Nobody here has run it

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:

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

Search Skills

# Search SkillsMP registry
opengap skills search "code review"

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

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

Install Skills

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

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

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

List Skills

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

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

Inspect a Skill

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

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

Create a Skill

Create directory: skills/<name>/
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.]

Reference it in agent.yaml:

skills:
  - my-skill

Validate:

opengap 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