// 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.
Creates and configures agent.yaml files, writes SOUL.md personality definitions, and sets up agent directory structures with skills, tools, and knowledge. Use when the user wants to configure an agent, create agent.yaml, write SOUL.md, set up agent directory structure, or customize agent settings.
Converts agent definitions between frameworks — exports to Claude Code, OpenAI, CrewAI, Lyzr, and GitHub Models formats, and imports from Claude, Cursor, and CrewAI projects. Use when the user wants to convert an agent, migrate to another framework, export to LangChain/AutoGen/CrewAI, or import from existing automation tools.
Guides installation of gitagent and creation of first agent with scaffolding, configuration, and validation. Use when the user is new to gitagent, asks how to get started, wants to install gitagent, set up their first agent, or says 'how do I start?'
Configures and runs agents with different adapters including Claude, OpenAI, CrewAI, Lyzr, and GitHub Models. Supports local execution, remote git repos, and one-shot prompts. Use when the user wants to run an agent, switch LLM providers, configure adapter settings, or launch agents from git repositories.
Model selection by provider health, not task complexity. Tier 0 (local) handles most tasks. Paid models are break-glass only. Fallbacks activate on 429 or timeout — never on perceived task difficulty.
Memory integrity audit. Detects hallucinations, circular confirmations, and state poisoning. Runs automatically after 2 consecutive failures or at nightly deep dive. Uses Opus 4.6 as the auditor model.
| name | manage-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. |
| license | MIT |
| metadata | {"author":"gitagent","version":"1.0.0","category":"skills"} |
When a user wants to find skills, install them, create new ones, or understand the skills system.
After installing a skill, confirm it's available:
opengap skills list -d ./my-agent | grep "code-review"
# 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 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
# Show all discovered skills (local + global)
opengap skills list -d ./my-agent
# Only agent-local skills
opengap skills list -d ./my-agent --local
opengap skills info code-review -d ./my-agent
Shows: name, description, license, allowed tools, metadata, optional directories.
skills/<name>/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.]
agent.yaml:skills:
- my-skill
opengap validate -d ./my-agent
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/ |
scripts/ — Executable scripts the skill can referencereferences/ — Reference documentsassets/ — Images, static filesagents/ — Skill-specific sub-agents