Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
---
title: CreateSkill
description: >-
Create a skill: a markdown document of reusable instructions that AI reads and
follows when the skill is referenced or a request needs it, as Compose Skill
in the app does.
---
# CreateSkill
Create a skill: a markdown document of reusable instructions that AI reads and follows when the skill is referenced or a request needs it, as Compose Skill in the app does. Write the instructions as the markdown body, and say in description when to use it. Edit an existing skill with EditDocument; find skills with ListSkills or SearchSkills.
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `skillName` | string | Yes | The skill's name. |
| `description` | string | Yes | When to use the skill, in one line starting "Use when", at most 300 characters, e.g. "Use when drafting release notes; not changelog entries". Agents load the skill for requests this describes. |
| `markdown` | string | Yes | The skill's instructions, in markdown. |
| `projectId` | string | No | The id of the project (shown as a folder in the app UI) to create the skill in. Requires edit access to the project. Omit to create it at the top level of the user's files. |