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: ReadSkill
description: >-
Read a skill's complete markdown instructions by its documentId from
ListSkills or SearchSkills, or a skill mention.
---
# ReadSkill
Read a skill's complete markdown instructions by its documentId from ListSkills or SearchSkills, or a skill mention. Supports user-authored and built-in skills. Read a relevant skill before performing the task and follow its instructions for that request. Returns the skill name and full content; only skill documents the user can view are readable.
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `documentId` | string | Yes | The documentId returned by ListSkills or SearchSkills, or the id of a mentioned skill. |