# Skills Turn on packaged procedures the assistant can follow, build your own, and keep them private until you share. A **skill** is a packaged procedure the assistant can follow: instructions for one job, usually with code it can run. A skill might build a discounted cash-flow model, run a regression, price a bond, pull the text out of a scanned PDF or lay out a Word document. Turn a skill on once and the assistant uses it whenever your request matches, so you don't have to explain the method each time. A skill is a small folder. It holds a `SKILL.md` file, with a name, a short description of what the skill does and when to use it, and a markdown body of steps, plus any reference documents and scripts. Skills use the open Agent Skills format, so a skill folder that follows it can move between PrivateMind and other tools that read the format. Each skill is off until you turn it on in **Settings → Skills**. Skills you write yourself start on for you. ## How skills work, briefly Skills load in layers, smallest first: - The assistant always knows the **name and one-line description** of each skill you've turned on. Only this part goes into every conversation, and it's small. If you've turned nothing on, skills add nothing to your chats. - When your request matches a skill, the assistant **reads that skill's steps** in `SKILL.md`. - If the steps call for it, the assistant **runs the skill's scripts and reads its reference documents**. So turning a skill on doesn't make the assistant use it all the time. It uses the skill when it fits and ignores it otherwise, and a dozen skills you rarely use cost almost nothing per chat. A skill runs in the sandbox the assistant already uses to run code in each conversation, so it gives no new access. It can't reach data or systems the assistant couldn't already reach in that conversation, and it runs only inside the conversation that used it. ## Turning a skill on 1. Open **Settings → Skills**. 2. Find the skill in the catalog and switch it on. The skill is available from your next message. Turn it off the same way. Skills are per-user: turning one on affects only your account. ## What's in the catalog The built-in catalog covers common analysis and document work: - **Documents**: create and edit Excel workbooks, Word documents, PowerPoint decks and PDFs. - **Data and analysis**: explore datasets and make charts, run SQL over local files, transform large dataframes, run statistical inference and apply classical machine learning. - **Finance**: portfolio and risk analytics, fixed-income and derivatives pricing, portfolio optimisation, market and tail-risk measurement, and financial-statement analysis. - **OCR**: pull text out of scanned documents. - **Structured writing**: produce internal documents in a consistent format. - **Skill creator**: scaffold a new skill from a short description (see below). Turn on the skills that fit your work and describe your task in plain words. The assistant matches your request to the right skill. The built-in skills come with the product and are kept up to date in regular releases. ## Writing your own skill Anyone can write a skill in **Settings → Skills**, in one of two ways: - **The form**: give the skill a name, a description of what it does and when to use it, and the steps. Good for skills that are mostly instructions, such as a house style for memos or a checklist for reviewing a contract. - **A ZIP upload**: package the skill as a folder and upload it. Use this when the skill includes scripts or reference files. If you're not sure how to structure a skill, turn on the **skill creator** and ask it to scaffold one. It produces the folder layout and a first description you can edit. Skills you write are **private to you**. Nobody else in your organisation can see them or turn them on until they're shared. If a skill needs a software library that isn't already available, ask your admin. Adding a library is a change to the platform, since a skill holds only instructions and code. ## Sharing Your **org admin** controls sharing, and it's off by default. Once it's on, you can share a skill with a colleague, and an admin can make a skill available to the whole organisation. A shared skill is still **opt-in for the recipient**: it appears in their catalog switched off. When they run it, it runs in their own sandbox, against their own conversation. Sharing a skill hands over the procedure only. It gives no access to anyone's session or data. ## When the org turns one off Every catalog skill is available to your organisation unless your admin turns it off for the whole org. If a skill you expect is missing from your catalog, or disappears, that's the likely reason. Ask your admin. ## Where next - [Chat](https://docs.privatemind.com/chat.html): where skills get used, in the flow of a conversation. - [Files & sources](https://docs.privatemind.com/files-and-sources.html): attach the documents and data a skill works on. - [Memory](https://docs.privatemind.com/memory.html): another per-user feature you enable at Settings.