Skills overview

A skill is a SKILL.md file with YAML frontmatter and instructions. It can also include scripts, references, and assets in a bundle.

SKILL.md

---
name: incident-brief
description: Build a concise incident brief from alerts and service context.
---

## Incident brief

Check the context map for service ownership before querying alerts.
Report impact, timeline, owner, current status, and the next decision.

Port of Context stores the original skill content and keeps its name, description, scope, placement, source, and review state with it.

The skill library

The library gives members one place to:

Author a new SKILL.md
Search and import from a public registry
Import a skill from a supported repository URL
Upload a SKILL.md, .zip, or .skill bundle
Add or remove bundled files
Download a portable copy
Submit a personal skill for workspace review

Admins can disable external skill import or require review before a skill is shared across the workspace.

Scope

Scope	Who can use it	Typical use
`personal`	The owner	Drafts, experiments, and individual workflows
`team`	The selected team	Workflows tied to one function or domain
`org`	Everyone in the workspace	Approved workspace-wide methods

Placement

Place a skill on a team, system, or domain when it applies there. Placement makes the skill discoverable from that part of the context map. Leave a skill unplaced when it is a general personal or library skill.

Create a skill

Author, import, or upload a skill and its bundled files.

Govern skills

Set import policy, review submissions, and publish shared skills.

⌘I

Getting started

Core concepts

Skills

Administration

Reference

The skill library

Scope

Placement

Create a skill

Govern skills

​The skill library

​Scope

​Placement

Create a skill

Govern skills

The skill library

Scope

Placement