Skills in Settings

Settings > Skills shows the skills on this computer: where each one comes from, what it does, and the controls to add a skill, change it, or bring back one you deleted. The page is part of the DataMind Oda desktop app and of Oda in VS Code; the browser does not show it. How skills run in chats is on Skills in chat.

What the list shows

The list covers every skill this computer knows, grouped by where it comes from. Each row carries the / command that runs the skill (/<name>), its origin label, a tag when the skill is limited (Only with /name or Not in the / menu), the description, and the path of the skill's file.

LabelWhere the skill comes from
Your skillYour own skills folder.
Shared skillA shared skills location on this computer.
Project: <folder>The project you work in; the folder's name is shown after the label.
Custom folderA custom skills folder on this computer.
Built inSkills that come with DataMind Oda.
OtherAny other source.

Only Your skill rows are editable: they carry the … menu, and skills from the other origins are read-only in this list.

The page reads the list again when you open the section, when you return to the window, and after every change made here, so it keeps up with skills saved in chats or edited in the folder. While it opens, the list reads Loading skills…. When no skills are in it, it reads No skills yet. Create one, or import a skill folder, a .zip file, or a link.

Add a skill from Settings

The toolbar holds three controls:

Skills also arrive from chats, where Oda saves what you agree to: see Create and install skills.

Change a skill from its row

  1. On one of your own skills, choose … (More actions for /<name>).
  2. Pick an action:
    • History opens the skill's saved versions; Skill versions and restore covers them.
    • Edit opens the skill's form, where you change its description and its instructions.
    • Delete asks for confirmation, described below.

A skill keeps its name: A skill cannot be renamed. Create a new skill instead. To use a different name, create a new skill.

Delete and restore a skill

  1. Choose Delete on a skill's … menu. The dialog asks Delete {name}? and explains: The skill folder and all of its files are removed from your skills folder. You can bring the skill back from Recently deleted. Confirm with Delete, or keep the skill with Cancel.
  2. The skill waits in the Recently deleted area below the list, with the time it was deleted (Deleted {time}) and two actions: History and Restore.
  3. Restore brings the skill back: its newest saved version returns to your skills folder, and the app confirms with Restored {name}.

Your skills folder

Your own skills are saved in the app's skills folder, and the toolbar shows where: Your skills are saved in {path}. Open skills folder opens it in your file manager; when the app cannot open folders on this computer, it answers This computer cannot open folders from the app.

Questions, answered

Where does each skill in the list come from?

The label on its row: Your skill is your own skills folder, Shared skill is a shared location on this computer, Project: <folder> is the project you work in, Custom folder is a custom skills folder, Built in covers the skills that ship with DataMind Oda, and Other is any other source. Only your own skills can be changed here; the other origins are read-only in this list.

What do the tags next to a skill mean?

Both are set in the skill's file; Skill files and discovery covers the keys.

Why does saving a new skill say a name already exists?

Skill names are unique in your skills folder. Saving New skill under a name you already use is refused with A skill named "<name>" already exists in your skills folder. Choose another name, edit the existing skill instead, or replace it from Import.

Can I add skills from Settings?

Yes. New skill writes one from a form, and Import brings one in from a folder, a .zip file or a link. An import shows a preview of exactly which files will be saved, and nothing is written until you install.

Why did the import say the preview expired?

A preview is kept for a limited time. If it has expired when you install, the app says The preview expired. Preview the skill again. Run Preview again, then install.

Why does the list show Could not load the skills?

The app could not read the skills list. Choose Retry to try again. If the list had loaded before, the app keeps showing the previous list instead of the error.

What does Could not complete the change: <message> mean?

An action in the list did not go through, and the text after the colon names the reason. Try the action again; if the same message comes back, keep it and contact your DataMind OS administrator, as Updates and troubleshooting describes.

Why is Settings > Skills missing in the browser?

The section is part of the desktop app and of Oda in VS Code. In the browser, Oda shows only the Settings pages that are available in every app, so skills are managed in the desktop app.

Why can't the app open my skills folder?

Some computers do not allow the app to open folders. Open skills folder then answers This computer cannot open folders from the app.; the folder itself is unchanged, and you can open it in your file manager yourself.

A skill I saved in a chat is missing from the list. Why?

The page reads the list again when you open the section, when you return to the window, and after every change made here, so a saved skill should appear on its own. If it never appears, check that the save finished in the chat.