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 on load — what good output looks like, which edge cases to handle, which formats to prefer. Written once, applied every invocation.

tools

What it can call.

An explicit allowlist of tools and MCP servers the skill needs. The model picks from this list, not the kitchen sink — focused tool surface, fewer wrong calls, faster reasoning.

prompts

What to say first.

Reusable prompt scaffolding — the opening, the structure, the post‑processing. Skills compose with prompts: a skill can teach the model how to use a prompt template (parameters, expected outputs, validation).

data

What it knows about.

Optional: a data source, a vector slice, an attached doc set. The skill carries its own grounding so the model doesn't have to re‑search public knowledge every time.

One skill, every surface

Build once. Use everywhere.

Skills aren't tied to chat or to workflows — they're a primitive that lives across surfaces. Define earnings‑prep once; every team member who calls load_skill("earnings‑prep") gets the same behavior.

in chat

Load by name in any session.

The model calls load_skill("X") when the conversation matches, or you can pin a skill to a session. The instructions inject into the system prompt; the tools join the available set.

in workflows

The promote shortcut.

The reference example: workflow‑author is the skill that teaches the LLM to emit workflow artifacts. Calling it before promote means the resulting workflow has the right shape, every time.

in agents

The default playbook.

Agent nodes can declare a skill as their "operating mode" — the model gets the skill's instructions + tool allowlist baked into the run. Different skill, different agent personality, same engine.

shareable

Public catalog, private overrides.

Admins publish skills org‑wide via the public catalog — every authenticated user can load them. Individual users override the configuration (different model, different prompt) without affecting the shared definition.

versioned

Update once, propagate everywhere.

A skill is a row in skills. Update the body; every session, workflow, and agent loading that skill picks up the change on next load. No fan‑out, no copy‑paste drift.

composable

Skills load skills.

One skill can call load_skill on another. Build foundational primitives — "format as memo", "cite sources" — and have your higher‑level skills inherit them.

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 LLM the workflow JSON shape, node types, defensive parsing rules. Auto‑loaded when promoting a chat.
  • board‑summary — Pulls Q‑over‑Q numbers from the warehouse, formats them as a board memo using the company's voice guide.
  • code‑review — Reads a GitHub diff, applies the team's style guide as instructions, checks against an internal docs vector store.
  • 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 primitives, not screenshots in a doc. Skills are how they become verbs your AI knows.