albedo docs

Skills and instructions

Give agents durable project instructions (AGENTS.md) and reusable skills (SKILL.md) that can be invoked as slash commands or mentioned inline in chat.

On this page: Instruction files, Where skills are discovered, Write a skill, and Activate and reload skills.

Both skills and instructions are enabled by default.

Instruction files

Albedo loads project-level and global instruction files into the agent's context:

The agent directories exclude system.md and append_system.md from this list. See instruction loading for the host owner.

Open /instructions in the terminal or web client to inspect which instruction files are active and toggle per-session defaults.

Where skills are discovered

Albedo scans immediate child directories under these five roots in precedence order:

  1. <workspace>/.albedo/skills
  2. <workspace>/.agents/skills
  3. $HOME/.albedo/skills
  4. $HOME/.agents/skills
  5. Built-in skills shipped with Albedo

If two directories define the same skill name, the earlier root in that order wins. For declarative Nix setups, programs.albedo.skills in home-manager links skills into ~/.albedo/skills.

Write a skill

Each skill lives in its own directory containing a SKILL.md file with YAML frontmatter:

---
name: release-notes
description: Summarize merged changes since the last tag.
---

Inspect commits since the latest tag and group user-visible changes by area.

Scripts, templates, and reference files placed beside SKILL.md belong to the skill. Mention them in SKILL.md, and the agent reads them when they need them.

Activate and reload skills

A skill is used in three ways:

Activating a skill loads its instructions. It does not run bundled scripts or grant new tools by itself.

Use /skills to enable or disable individual skills for a session. After adding or editing skill files on disk, run /reload session in an existing session (no daemon restart is needed).

Previous webhooks Next mcp servers