Skills

A skill is a reusable procedure: written instructions an agent loads when a task calls for them, then follows using the tools it already has. Praxis runs as one general agent backed by a library of these skills (see How Praxis works). Adding skills is the main way you make Praxis do more, without writing code.

Built-in and custom skills

Praxis ships a library of Built-in skills that cover common DevOps and Facets Control Plane work. They are bundled with the platform and available to every agent in your organization. You can review what each one does, but you can't change it.

Custom skills are the ones you add. Each is either an Organization skill, shared with everyone in your org (the default), or a Personal skill only you can use. Once you add one, your agents discover and load it the same way they load a built-in.

How an agent uses a skill

You don't invoke a skill yourself or trigger it with a command. When you give an agent a task, it reads the descriptions of the skills available to it, loads the one that fits, and follows its steps. Skills load on demand, so an agent pulls in only what a task needs instead of carrying every procedure at once.

📘

Adding a skill teaches an agent a procedure; it does not give the agent new access. An agent running a skill still works through the same tools and permissions it already has.

The Skills page

Find your skills under Context > Skills in the console. The page lists every skill your agents can load, built-in and custom together, and tracks how much each one gets used so you can see which earn their keep.

Four counts sit at the top: the Total number of skills, how many are Hot (loaded in the last 7 days), how many are Cold (untouched for 30 days or more), and how many are Built-in. Open any skill to read its description, triggers, and supporting files, and to see how often agents have loaded it and when it was last used. You can search by name, description, trigger, or tag, filter by scope or category, and group or sort the list to match how you think about your skills.

Add a custom skill

Custom skills are how you teach Praxis your team's own procedures, so a runbook you write once is available to every agent. Add one with Paste skill on the Skills page:

Paste a skill written in the Claude skill format: a short YAML block that names and describes the skill, then the instructions as markdown.
Choose whether it's an Organization or Personal skill, and where it can run (see below).
Import it.

---
name: deploy-checklist
description: Steps to run before and after a production deploy.
---

Use this skill whenever the user is preparing a production deploy...

The skill name is a slug: lowercase letters, numbers, hyphens, and underscores only. It becomes the skill's permanent identifier and can't be changed after creation. A skill can also carry supporting files alongside its main instructions, which helps when one procedure references a longer reference document.

You can also have an agent draft a skill for you in chat, then paste the result here.

Where a skill can run

Every skill is marked for one of three surfaces, so Praxis only offers it where its tools actually work:

Both (the default) runs in the web console and through the Praxis CLI.
CLI only needs tools on your own machine, such as raptor or a cloud CLI, so it stays hidden from the web chat agent.
UI only runs in the web console and is never installed onto a local machine.

The Praxis CLI installs your organization's skills, your personal skills, and the eligible built-ins into your local AI tools, so the same procedures are available in your terminal. A built-in installs there only when its tools can run on your machine.

Edit or remove a skill

You can edit any custom skill you created from the same page. An organization admin can also edit or remove any Organization skill, though not someone else's Personal skill. Built-in skills stay read-only for everyone. The skill's name is fixed, but everything else, including its instructions, description, and where it runs, stays editable.

🚧

Removing an Organization skill takes it away from every agent in your org, so check that no one relies on it first. A removed skill's name can't be reused. To recreate a skill with the same purpose, give it a different name.

How Praxis works - One general agent backed by a library of on-demand skills
Praxis CLI - Installs your skills into your terminal and AI tools
Memories - What your agents remember across sessions, another shared knowledge surface
Connect Tools - Give your agents new tools through MCP servers