Skip to main content

Agent Skills

Yagr supports standard Agent Skills: directories containing a SKILL.md file.

Yagr keeps this integration minimal. It installs, lists, removes, and exposes skill source paths. DeepAgents.js provides the runtime SkillsMiddleware, metadata discovery, prompt injection, and progressive disclosure.

Commands​

yagr skills list
yagr skills install <source>
yagr skills remove <name>
yagr skills path

Install globally by default:

yagr skills install ./my-skill

Install for the current workspace/context root:

yagr skills install ./my-skill --scope workspace

Storage​

Global skills are stored in:

<YAGR_HOME>/skills

Workspace skills are stored in:

<contextRoot>/.agents/skills

At runtime, Yagr passes skill sources to DeepAgents.js in this order:

<YAGR_HOME>/skills
<contextRoot>/.agents/skills

DeepAgents.js uses last wins, so workspace skills override global skills with the same name.

External Tool Skills​

Yagr has no built-in domain tool logic. Tool-specific behavior should come from ordinary Agent Skills, local project files, or future plugins.

From a local development checkout:

yagr skills install /home/user/repos/example-tool/packages/skills/src/agent-skills

From a local build output:

yagr skills install /home/user/repos/example-tool/packages/skills/dist/agent-skills

From a published package:

yagr skills install npm:@example/agent-skills@latest

Yagr only installs and exposes skill directories. Commands referenced by those skills must already be available in the user environment.