Skip to main content

Overview

Skills are pluggable knowledge modules that extend what your AI agents can do. They’re sourced from the skills.sh marketplace — a community-driven ecosystem of agent capabilities. When you install a skill, its instructions are automatically injected into every enabled agent’s config file.

How Skills Work

  1. Installdrevon skill add downloads the skill to .drevon/skills/
  2. Register — The skill is recorded in skills-lock.json
  3. Compile — On drevon sync, skills appear as a table in each agent’s instructions
  4. Use — Agents read skill descriptions and follow their SKILL.md instructions

Installing Skills

You can copy-paste the install command directly from skills.sh — Drevon automatically strips the npx skills add prefix and --skill flags.

Managing Skills

The Lock File

skills-lock.json tracks all installed skills:
Commit skills-lock.json to Git. This ensures teammates get the same skills when they run drevon sync.

Bundled Skills

Every Drevon workspace comes with one pre-installed skill:

find-skills

A comprehensive guide that helps agents discover, evaluate, and install new skills from the skills.sh ecosystem. It teaches agents how to:
  • Search for skills by category
  • Evaluate skill quality and compatibility
  • Install skills via the Drevon CLI
  • Recommend skills based on the current task

Skill Packs

Drevon includes curated skill collections for common use cases:
Skill packs are defined in the codebase and will be installable via CLI in a future release.

Skill Anatomy

Each skill is a directory containing a SKILL.md file:
The SKILL.md file contains:
  • Description — What the skill does
  • When to use — Trigger conditions for the agent
  • Instructions — Detailed guidance for the agent
  • Examples — Usage patterns

How Skills Appear in Agent Configs

Installed skills are rendered as a structured section in each agent’s instruction file:
Agents also receive a reference to each skill’s SKILL.md file path, which they can read for detailed instructions when the skill is relevant to the current task. Browse popular skills at skills.sh: