Skills

Skills extend fx with reusable instructions for tasks and workflows. fx can choose a relevant skill for your prompt, or you can select one yourself.

Browse and invoke

Browse available skills:

Search by name or filter by source. Press enter to add a skill to your prompt, then describe what you need. You can also type $ to open the skill picker.

For a skill named review-tests:

$review-tests Review the tests changed in this branch.

fx loads the selected skill’s full instructions when you send the prompt.

Find a specific skill:

If several skills have the same name, check their source in the catalog before selecting one.

Install

Install one skill from a repository:

Install from a local directory:

Installed skills go to ~/.fx/skills/. Use --skill to choose one from a repository; omit it to install all skills in the source.

You can also ask fx to install a skill. /skills path shows where fx stores installed skills.

Create a skill

Create a template:

Open ~/.fx/skills/review-tests/SKILL.md in your editor and replace the template with instructions for the task. For a skill shared with your project, create .fx/skills/review-tests/SKILL.md in the repository instead.

For example:

---
name: review-tests
description: Review tests for missing cases and brittle assertions.
---

# Review tests

- Read the changed code and its tests.
- Find missing cases and assertions tied to incidental output.
- Report findings with file paths. Edit files only when asked.

After saving, run /skills to refresh the catalog and select your skill.

File format

Include a name in the YAML header. Use description to explain when fx should use the skill, and write the instructions below the header. Without a header, fx uses the directory name.

Remove an installed skill

This removes the skill from ~/.fx/skills/. Remove workspace or third-party skills at their source. The /skills catalog shows each skill’s source.

Discovery roots

fx checks .fx/skills/, skills/, and compatible directories from the workspace upward, stopping before your home directory:

.fx/skills/
skills/
.opencode/skills/
.codex/skills/
.claude/skills/
.agents/skills/
.claw/skills/

It then checks user roots:

~/.fx/skills/
~/.config/opencode/skills/
~/.codex/skills/
~/.claude/skills/
~/.agents/skills/
~/.claw/skills/

Additional workspace directories do not contribute skills.