Skills

A skill is project-specific instruction. It tells an agent how to work in a repository, what conventions matter, what workflows are expected, and what domain context it should keep in mind.

Skills are installed into agent-specific directories along with any associated files (scripts, references, assets):

# Open Agents standard (codex, cursor, opencode, copilot, etc.)
.agents/skills/<id>/SKILL.md

# Claude Code
.claude/skills/<id>/SKILL.md

Manifest

Skills installed from a local directory or git repository do not require a manifest file. Tuff discovers the skill’s structure automatically. For source-based development, a tuff.toml in the source directory is optional but not emitted into agent directories.

Installing a skill

# Local directory
tuff add --agent open-agents ./my-skill

# Git repository
tuff add skill https://github.com/owner/repo <name> --agent open-agents

# Global scope
tuff add --agent open-agents --global ./my-skill

Tuff tracks where each skill came from, records a baseline, and reports local drift after installation. See the CLI reference for available lifecycle commands.