// Install new skills into the agent's skills directory by fetching from a URL or writing from scratch.
| name | skill-installer |
| description | Install new skills into the agent's skills directory by fetching from a URL or writing from scratch. |
OpenAgentd discovers skills from five roots, in this order. The first skill with a given name wins:
{cwd}/.openagentd/skills/{skill-name}/SKILL.md — project-specific OpenAgentd skill.{cwd}/.opencode/skills/{skill-name}/SKILL.md — project opencode-compatible skill.{SKILLS_DIR}/{skill-name}/SKILL.md — global OpenAgentd skill.~/.config/opencode/skills/{skill-name}/SKILL.md — global opencode-compatible skill.Default to {SKILLS_DIR} for user-global installs unless the user explicitly
asks for a project-local skill or an opencode-shared skill.
If the target name already exists only as a bundled skill, install an override
in {SKILLS_DIR} (or the requested project root); never edit bundled files.
A skill is a directory at {root}/{skill-name}/ containing at minimum a SKILL.md file. The SKILL.md has YAML frontmatter and a Markdown body:
---
name: skill-name
description: One-sentence description shown in the system prompt.
---
# Skill Title
Full instructions the agent reads when it calls skill("skill-name").
web_fetch.name field — that becomes the directory name.{SKILLS_DIR}/{name}/SKILL.md.SKILL.md following the format above to {SKILLS_DIR}/{name}/SKILL.md.reference.md) in the same directory if useful.name field in frontmatter (lowercase, hyphens only).skills: list.OpenAgentd workflow for well-formatted, detailed conventional commits.
OpenAgentd workflow for investigating bugs, regressions, sessions, and runtime issues.
OpenAgentd workflow for syncing project documentation with recent code changes.
OpenAgentd workflow for version bumps, release PRs, GitHub releases, and release notes.
Install, update, remove, or restart Model Context Protocol (MCP) servers in `{OPENAGENTD_CONFIG_DIR}/mcp.json`. Use when the user asks to add / remove / list / restart an MCP, or to enable a server like filesystem, github, postgres, puppeteer, brave-search.
Update or upgrade the agent's own configuration on request — swap the model, tune thinking/temperature, add tools/skills, change the image-generation provider/model, or install a new skill. Use when the user says things like "upgrade yourself", "switch your model to X", "use Gemini for images", "add the plugin-installer skill to yourself", "make yourself faster/smarter".