Agent Skills

IMPORTANT

This feature is in beta and represents an initial implementation. The API and behavior may change or be removed in future releases.

Iris supports Agent Skills - a portable format for extending AI agents with specialized knowledge and workflows.

Quick Start

Install a skill using the CLI:

bash

npx skills add https://github.com/vercel-labs/skills --skill find-skills

Skills install to .agents/skills/ and Iris picks them up automatically.

Browse available skills at skills.sh.

Iris sees available skill names and descriptions in its system prompt
When a task matches a skill's domain, Iris calls activate_skill to load full instructions
Skills can include references that Iris reads on-demand via shell

NOTE

Basic skill activation works without shell access. However, if a skill includes reference files, Iris needs shell commands enabled to read them.

Skills are enabled by default:

bash

# .env
IRIS_SKILLS_ENABLED=true
IRIS_SKILLS_DIR=/path/to/project/.agents/skills

bash

# .env
IRIS_SKILLS_ENABLED=false

Or disable just the activation tool:

php

// config/iris-custom.php
return [
    'disabled_tools' => [
        App\Tools\Skill\ActivateSkillTool::class,
    ],
];