manage-skills
Scannednpx machina-cli add skill open-gitagent/gitagent/manage-skills --openclawManage Skills
When to Use
When a user wants to find skills, install them, create new ones, or understand the skills system.
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
- 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:
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 referencereferences/— Reference documentsassets/— Images, static filesagents/— Skill-specific sub-agents
Source
git clone https://github.com/open-gitagent/gitagent/blob/main/examples/gitagent-helper/skills/manage-skills/SKILL.mdView on GitHub Overview
Manage Skills helps users search, install, create, and inspect agent skills, enabling a modular and extensible toolset. It covers local and global installations, skill discovery, and a guided skill-creation workflow so agents can grow capabilities over time.
How This Skill Works
Users interact with a set of gitagent commands: search discovers skills from SkillsMP or GitHub; install adds a skill to a local agent or globally; list shows discovered skills; info inspects metadata; and create scaffolds a new skill with a SKILL.md frontmatter and references it in agent.yaml. Skill discovery follows a defined path so first matches are loaded deterministically.
When to Use It
- When you want to find a skill that fits a task (e.g., code review).
- When you want to install a skill locally for a specific agent.
- When you want to install a skill globally for all agents.
- When you want to inspect a skill's details before using it.
- When you want to create a brand-new skill and wire it into agent.yaml.
Quick Start
- Step 1: gitagent skills search "code review"
- Step 2: gitagent skills install code-review -d ./my-agent
- Step 3: gitagent skills info code-review -d ./my-agent
Best Practices
- Use precise search terms and consider quoting multi-word queries.
- Prefer local installs for reproducible environments and easy testing.
- Validate the agent after installation with gitagent validate.
- Follow the Create a Skill steps: directory, SKILL.md frontmatter, and agent.yaml reference.
- Understand Skill Discovery Paths and how first-match wins affect loaded skills.
Example Use Cases
- Search SkillsMP for 'code review' to find relevant skills.
- Install code-review to agent-local skills/ for a specific agent.
- Install a GitHub-hosted skill with gitagent skills install owner/repo#skills/my-skill --provider github.
- List all discovered skills for your agent path to see what's available.
- Inspect code-review to view name, description, license, and metadata.
