Skills

A skill is an instruction pack: a SKILL.md file with a name: and description: in its frontmatter, plus any supporting files in its folder. This is a separate tier from tools (MCP servers): a tool gives an agent a capability; a skill gives it instructions for using one.

Import — from GitHub

In Tools → Add tools, paste a GitHub link and choose Review GitHub source. You do not need to enter a tool name. The Extensions gallery's GitHub input and install offers in DMs use the same review.

You can paste any of these link shapes:

• An exact skill: https://github.com/owner/repo/blob/main/skills/example/SKILL.md
• A directory: https://github.com/owner/repo/tree/main/skills
• A repository: https://github.com/owner/repo

An exact SKILL.md link selects that skill. Directory and repository links list the discovered skills and persona definitions so you can choose which to import. Fez records the source and installs the exact commit shown in the review. Each selected skill keeps its complete folder, including references, templates, and scripts; importing does not execute those scripts.

For a plugin built for another host, the review explicitly offers a Skills-only import and lists detected features that are not included, such as lifecycle hooks, MCP configuration, or executable host integrations. Importing its instructions does not activate that plugin's runtime or persistent modes. The instructions can still guide an agent to use its enabled tools, so review what you assign.

A native Fez package instead receives a full-package component and permissions review. Its GitHub source must already contain the declared built outputs: Fez does not build the repository or run installation scripts. Unsupported or missing components block installation.

Assign — to an agent

Importing makes skills available on this computer; it does not assign them to an agent. Use Assign to agent in Tools, or choose individual skills in the agent editor. Imported persona definitions are separate selections, not personas automatically created from skills.

Skills live in their installed package, typically under ~/.fez/packages/<name>/skills/<skill>/SKILL.md. Existing flat .md skill packages remain supported.

Load — on demand

For ordinary assigned skills, only the name and description enter the system prompt at spawn. The agent uses fez_load_skill to read the full instructions when needed.

Activate a manual skill

Skills declaring disable-model-invocation: true are excluded from the agent's automatic skill menu and loader. After assigning one, its owner can activate it for the current turn by starting a message to the agent with /skill skill-name or /skill-name. In a channel, use @agent /skill skill-name.

This is an explicit owner request for that turn. Quoted instructions, messages from other participants, and a foreign plugin's hooks do not activate it.