Skills · the long version

Package what
works once.

A skill is a named bundle — instructions, tools, prompts, optional data — that the model can load on demand. Build one skill, and it works the same way in chat, in workflows, in agents. The pattern your team uses every Monday becomes a verb the model already knows.

Anatomy of a skill

Four parts. One verb.

A skill bundles the thing the model needs to know with the things it needs to call. Loaded by name, available everywhere.

instructions

How to do it well.

Plain‑language guidance the model reads when the skill loads — what good output looks like, which edge cases to handle, which formats to prefer. Written once, applied every time it's used.

tools

What it can call.

A short list of the exact tools and connected servers the skill needs. The model picks from this list, not the kitchen sink — a focused set means fewer wrong calls and faster reasoning.

prompts

What to say first.

Reusable prompt building blocks — the opening, the structure, what to do with the result. Skills work hand in hand with prompts: a skill can teach the model how to use a saved prompt template — what to fill in, what to expect back, how to check it.

data

What it knows about.

Optional: a data source, a slice of vector memory, an attached set of docs. The skill carries its own reference material, so the model doesn't have to go re‑search the basics every time.

One skill, every surface

Build once. Use everywhere.

Skills aren't tied to chat or to workflows — they're a building block that works across every surface. Define earnings‑prep once; every team member who loads it gets the exact same behavior.

in chat

Load by name in any session.

The model calls load_skill("X") when the conversation calls for it, or you can pin a skill to a session yourself. Its guidance folds into the model's instructions, and its tools join the ones already on hand.

in workflows

The save‑as‑workflow shortcut.

The go‑to example: workflow‑author is the skill that teaches the model how to write a workflow. Load it before you save a chat as a workflow, and the result comes out in the right shape, every time.

in agents

The default playbook.

An agent can take a skill as its "operating mode" — the model starts the run with that skill's instructions and its set of allowed tools already in place. Different skill, different agent personality, same engine underneath.

shareable

Shared catalog, private overrides.

Admins publish skills across the org through a shared catalog — anyone on the team can load them. You can tweak your own copy (different model, different prompt) without touching the shared original.

versioned

Update once, everywhere follows.

A skill lives in one place. Update it, and every chat, workflow, and agent that uses it picks up the change the next time it loads. No copy‑paste, nothing drifting out of sync.

composable

Skills load skills.

One skill can call load_skill on another. Build small building blocks — "format as memo", "cite sources" — and have your bigger skills pull them in.

what teams ship

Some real skills, not toy ones.

The skills concept earns its keep when teams have repeated workflows. A handful of patterns we've seen people define and load constantly:

  • workflow‑author — Teaches the model the workflow's structure, the node types, and how to parse it safely. Loaded automatically when you save a chat as a workflow.
  • board‑summary — Pulls quarter‑over‑quarter numbers from your database, formats them as a board memo in the company's voice.
  • code‑review — Reads a GitHub diff, applies the team's style guide, and checks it against your internal docs (searched by meaning).
  • daily‑standup — Pulls yesterday's Linear + GitHub activity, drafts the standup post, posts to Slack.
  • earnings‑prep — Pulls market data + internal metrics, generates the morning brief, attaches the PDF, emails the desk.
catalyst · skills
workflow-author
teaches the workflow schema · system
board-summary
2 tools · 1 data source · jinja template
daily-standup
linear · github · slack · cron
code-review
filesystem · github diff · style guide
earnings-prep
postgres · web search · email · pdf
+ new skill
describe it, run it, save it
Patterns that compound

Name the pattern.
Share the verb.

The repeated workflows your team runs — board reports, code reviews, standups — deserve to be building blocks, not screenshots in a doc. Skills are how they become verbs your AI knows.