Custom skills

Upload your own skill, written in a SKILL.md file, and attach it to an agent.

A custom skill is a skill you write yourself and upload to an agent. It's a folder that holds one SKILL.md file, which describes the skill, plus any supporting files it needs, such as scripts, reference data, or templates.

Use a custom skill to give an agent your own procedure or know-how, such as how your institution reviews a loan file or formats a credit memo, when no built-in skill or configured skill covers it.

A custom skill you upload is attached to one agent. Each project also has a catalog of reusable custom skills, which you can attach to an agent without uploading anything.

What the folder holds

Item	Rule
SKILL.md	Exactly one. It describes the skill, and its frontmatter gives the skill's name and description
Supporting files	Up to 10
File size	At most 10 KB per file

The frontmatter at the top of SKILL.md sets the name and description that Qore shows for the skill:

---
name: credit-memo-format
description: Formats a credit memo in the institution's house style. Use when the user asks for a credit memo or a memo summary.
---

# Credit memo format

Write the memo in these sections, in this order: ...

Say when to use the skill in the description. The description tells the agent what the skill is for. "Use when the user asks for a credit memo" works better than "Credit memo helper".

Supported file types

Every file type you can upload

Kind	Extensions
Code	.py, .js, .mjs, .cjs, .ts, .mts, .cts, .jsx, .tsx, .rb, .php, .pl, .lua, .r, .go, .rs, .java, .kt, .swift, .c, .h, .cpp, .hpp, .cc, .cs, .sql
Scripts	.sh, .bash, .zsh, .ps1, .bat
Data and configuration	.json, .jsonc, .yaml, .yml, .toml, .ini, .cfg, .conf, .env, .xml, .csv, .tsv
Text and web	.md, .mdx, .rst, .txt, .html, .htm, .css

Keep secrets out of the folder. .env files can be uploaded, but a custom skill is a set of files, not a secret store. Put keys and tokens in Secrets & Variables instead.

Upload a custom skill

1. On the Builder Canvas, select + Add Skill.
2. Open the Custom Skills tab.
3. In Upload a Skill, select the upload area to choose the skill folder, or drag the folder onto it.

Qore reads the name and description from SKILL.md and attaches the skill to the agent.

Remove a custom skill

Deleting a custom skill from an agent removes the skill and deletes the files you uploaded for it.

Related pages

• Skill Library: the built-in skills, and the skills you configure.
• Adding a skill to the agent: every tab in the Add Skill dialog.

---

Maintained by Abhishek Paul AI-assisted, human-approved