What is a skill?
A skill has four parts:- Name: lowercase letters, numbers, and hyphens, such as
time-series. You invoke the skill by this name. - Description: when to use the skill. Agents read it to decide whether the skill fits a request.
- Instructions: the steps to follow.
- Mode: whether agents can load the skill on their own.
Skill modes
- Auto-invoke skills appear in the agent’s context with their name and description. If your request matches, the agent loads the skill and follows it, with no action from you. Use this mode for workflows Qualia should recognize, such as “run exploratory data analysis on a new dataset.”
- Manual skills stay out of the agent’s context until you type
/and the skill’s name. Use this mode for sensitive operations, or for procedures you want to start deliberately.
Create a skill
- Open the gear menu in the titlebar, choose Customize agent, then choose Skills.
- Open the Add menu and choose New skill.
- Enter a Name and a Description, such as “Initial analysis of a time series column.”
- Choose a Mode: Auto-invoke or Manual.
- Write the Instructions, then click Create.
Use a skill
To invoke any skill, type/ followed by its name:
/time-seriesQualia loads the skill’s instructions, and the agent follows them. Typing
/ opens a menu of your skills with their descriptions. The menu also lists built-in commands, such as /compact.
For an auto-invoke skill, describe what you want instead:
“Analyze this time series data”If a
time-series skill has a matching description, the agent recognizes the request and loads the skill.
Write a skill
A good skill covers four things:- Context: the situation that calls for the skill.
- Steps: the actions to take, in order.
- Verification: how to confirm the work succeeded.
- Error handling: what to do if something fails.
- Match each skill to one recognizable task. If a skill grows long, split it into smaller skills.
- Write specific descriptions. Agents decide whether to load an auto-invoke skill from its description, so name the trigger, such as “a new CSV file.”
- Test triggering. After creating an auto-invoke skill, check that it loads for several phrasings of the same request.
Import skills
Import skills from other tools on local workspaces. These options read folders on the machine your workspace runs on, so they don’t appear in Qualia Cloud. Both are in the Add menu on the Skills page.- Import from Cursor copies the skills in
~/.cursor/skills/. - Import from Claude Code copies the skills in
.claude/skills/and the commands in.claude/commands/, from both your home folder and the workspace. If a skill and a command share a name, the skill wins.
Re-import skills
Importing makes a copy, so later edits in the source don’t reach Qualia on their own. If you import again after the source changed, Qualia lists the skills it would replace and asks first:- Keep mine leaves your copies as they are, without the source’s edits.
- Update from Cursor or Update from Claude Code replaces each listed copy with the source version. Edits you made to those skills in Qualia are lost.
Link a skills folder
Link a folder to use its skills live, without copying them. Edits in the source reach Qualia without re-importing, so linking suits a skills repository you maintain yourself.- On the Skills page, open the … (Skill library options) menu and choose Linked folders.
- Enter the absolute path to a folder on the workspace host, then click Link. When Qualia runs on your own computer, click Browse… to pick the folder instead.
[FOLDER]/[SKILL_NAME]/SKILL.md. Each linked folder shows whether it’s valid and how many skills it contributes, so you can spot a mistyped path or an empty folder.
You can’t change linked skills in Qualia. You can’t edit, delete, or change their mode here; the disable-model-invocation field in each SKILL.md controls auto-invoke. If a linked skill has the same name as one you created in Qualia, yours takes precedence.
Linking works for local, remote, and self-hosted workspaces, but not in Qualia Cloud.
Manage skills
- Open the skills folder: on local workspaces, open the Add menu and choose Open skills folder. Each skill has its own folder with a
SKILL.mdfile. Qualia Cloud has no skills folder to open. - Edit: change your own skills on the Skills page or on disk. Qualia picks up edits automatically. Edit linked skills in their source folder.
- Delete: delete your own skills from the Skills page. To remove linked skills, unlink the folder under Linked folders, which never changes the source.
- Sync across devices: keep your skills folder in a git repository, then link it on each machine.
- Stop a skill loading on its own: switch its mode to Manual.
Skills vs rules
Use both together: rules for how to work, skills for what to do.

