Create and install skills

You can add a skill from a chat: ask Oda to create one for you, or point it at an existing skill to install from a folder, a .zip file or a link. Oda shows what will be written before anything is saved, and the files are written only after you approve them.

Create a skill with Oda

  1. Ask Oda in a chat to create a skill, and agree the name first. Skill names are lowercase words joined by hyphens, up to 64 characters, such as weekly-report; the name becomes the /<name> command.
  2. Tell Oda what the skill should do and when to use it. Oda drafts the description (up to 1024 characters), the optional note on when to use it, and the instructions.
  3. Check what Oda prepared, and approve the save in the approval prompt.
  4. Run the skill with /<name> in any chat, or let Oda load it when a task matches. How skills run is on Skills: loading and running.

Install a skill from a folder, a .zip file or a link

  1. Tell Oda where the skill is: an absolute path to a folder or a .zip file, or an https link, such as a GitHub repository or a folder inside one, a SKILL.md page, or a raw SKILL.md file. If you ask for a skill by name, Oda can find its source for you, and shows you the link it picked before installing.
  2. Oda checks the source first. A check reads the skill and shows what would be installed, where it comes from and its size; it writes nothing and asks for nothing.
  3. If the source holds more than one skill, name the one to install: The source holds N skills: …. Name the one to install.
  4. Approve the prompt, and Oda writes the files into your skills folder, the resource files first and SKILL.md last, so a half-written skill never appears. The file format is on Skill files (SKILL.md).

The approval prompt

Before a skill is written from a chat, Oda asks for your approval, starting with Create the skill "<name>" in your skills folder? (an install says Install the skill "<name>" in your skills folder?). The prompt shows:

The prompt closes with The files are only saved, never run. Installing a skill never runs anything; the files are only saved.

In a session with Full access, Oda writes the files without an approval prompt, and reports The session has Full access, so it was written without an approval prompt.

After the save

The chat keeps a card for the save, titled Create skill or Install skill (Check skill when Oda only checks a source):

Add a skill in Settings

Settings > Skills can also add a skill: import one from a folder, a .zip file or a link. The import writes exactly what its preview showed, so check the preview before you confirm. Everything else you can do with the skills on this computer, including saved versions and restoring a deleted skill, is on Manage your skills.

Questions, answered

Can I install a skill from GitHub?

Yes. Point Oda at a repository link, a link to a folder inside a repository, a link to a SKILL.md page, or a raw SKILL.md file. Private repositories cannot be read. If the public request limit for this computer is used up, Oda says: GitHub refused the request because the hourly limit for this computer is used up. Try again later, or download the repository as a .zip file and install it from that file.

Why was my link refused?

Downloads come from the public internet over https only:

What happens if the source holds several skills?

Nothing is installed until you choose one. Name the skill you want, and Oda installs it: The source holds N skills: …. Name the one to install.

Does checking a skill save anything?

No. A check reads the source and shows what would be installed and where it comes from, and writes nothing; the card ends with nothing saved yet. Nothing is added to your skills folder until you approve a real install.

What do the outcomes on the card mean?

Why do some files not get saved?

Only text files and images are kept, so a skill is never made of files Oda cannot read or show. Anything else is listed for you under Not saved: with a reason, for example:

Fix the file names in the source, or remove the files you do not need, and install again.

Why can't skills be added from a chat?

When approval prompts are turned off and the session does not have Full access, nothing can approve the write, so it is refused: Approval prompts are turned off in this session and it does not have Full access, so skills cannot be added from the chat. Ask the user to add the skill in Settings > Skills, or to switch the session to Full access or to a permission mode that asks for approval. Add the skill in Settings > Skills instead, or switch the session to Full access or to a mode that asks for approval.

What happens if I decline or nobody answers the approval?

Nothing is written in any of these cases, and Oda reports why:

Tell Oda what to change, and it can ask again.

How do I know a new skill is ready to use?

Oda reports it right after the save. Usually the skill is available at once and runs with /<name>. The two exceptions:

Can I replace a skill that already exists?

Yes, with your agreement. Oda refuses to write over it first (A skill named "<name>" already exists in your skills folder.), asks whether to replace it, and the approval prompt says This replaces your existing skill "<name>"; its current version is kept, and you can restore it in Settings > Skills. The old version stays in the skill's history.

How large can an installed skill be?

A download is limited to about 5 MB, a single file to 1 MB, and a skill to 200 files. A source that breaks these limits is refused, or the extra files are left out and listed under Not saved:.