Skills
Reusable "experience packs" · SKILL.md spec · Workspace vs Organization
A Skill is a reusable experience pack: bundle a set of prompts + scripts + reference materials, shared across multiple Agents / Workflows.
Skill ≠ Tool:
| Tool | Skill | |
|---|---|---|
| Form | Remote RPC | Static asset bundle |
| Content | One or more callable methods | Prompts / templates / scripts / files |
| Example | "Query weather API" | "Company-style writing guide" |
| Invocation | LLM function call | Injected into the prompt or referenced from code |
Skill Shape
A Skill = a directory + SKILL.md:
SKILL.md describes the Skill:
Create a Skill · Two Modes
Mode 1 · Direct UI
Workspace → Capabilities · Skill → New → fill the form:
| Field | Description |
|---|---|
| Icon / name / description | Metadata |
| Content | Markdown editor; attachments supported |
| Tags | For categorization and search |
Mode 2 · Import
Pack an existing Skill directory into a ZIP and upload, or pick a local directory (Private). The system auto-scans SKILL.md.
Import Constraints
| Constraint | Limit |
|---|---|
| Top-level Skill directories | ≥ 1 |
SKILL.md location | Root or one-level subdirectory (one or the other; cannot coexist; cannot go deeper) |
| File count per Skill | Configurable in org settings |
| Total size per Skill | Configurable in org settings |
| Binary file size | Per-file limit configurable in org settings |
Lifecycle
Workspace Skill vs Organization Skill
| Workspace Skill | Organization Skill | |
|---|---|---|
| Creator | Workspace admin / app builder | Org admin |
| Best for | Team-private experiments, project-specific guides | Company-wide standards (writing style, review rules, translation guides) |
| Authorization | Visible only in this workspace | Granted to specified workspaces |
→ Organization skill management
Reference a Skill in Agent / Workflow
Agent
Edit Agent → Skills tab → tick the Skills you want to use. The selected Skills' prompt.md content is injected into the role prompt.
Workflow
In an LLM node → Load Skill → select → auto-injected.
A Real Example
Scenario: every Agent in the company must follow the same customer-service script guide.
Each workspace's CS Agent ticks this Skill uniformly → company-wide consistent CS scripts; versioning and rollouts are easy.
Anti-Patterns
- Stuffing a whole business process into a Skill — that's Workflow's job
- Putting volatile data (product prices) into Skill content — use a knowledge base
- Cramming 100 use cases into one Skill — split into focused Skills
Next Steps
- Configure tools → Tools
- Org-level standards → Organization Skills
- Integrate into an Agent → Agent configuration