Agent Skills
› open-gitagent/opengap
› manage-skills
manage-skills
GitHub管理技能生命周期,包括搜索、安装(本地/全局)、创建自定义技能及验证。用于扩展代理能力或发现新工具。
Trigger Scenarios
用户希望查找或浏览可用技能
用户需要安装技能到本地或全局环境
用户想要创建新的自定义技能
用户需要验证技能是否生效
Install
npx skills add open-gitagent/opengap --skill manage-skills -g -y
SKILL.md
Frontmatter
{
"name": "manage-skills",
"license": "MIT",
"metadata": {
"author": "gitagent",
"version": "1.0.0",
"category": "skills"
},
"description": "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."
}
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.mdwith 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 referencereferences/— Reference documentsassets/— Images, static filesagents/— Skill-specific sub-agents
Version History
- d7a8e2e Current 2026-07-25 08:12


