Create reusable instruction playbooks that agents invoke on their own to standardize repetitive work like document generation
A Skill is a reusable instruction playbook that an agent invokes on its own.
Define the method once (“when this kind of request comes in, handle it this way”), and the agent automatically loads and follows it whenever a request during a conversation matches the skill’s purpose.
The Skills tab is currently in preview and appears only in certain environments (development/staging hosts).
If the Skills tab isn’t visible in production, contact your administrator. Document-generation skills (PPT, Word, Excel, HTML) are provided through the Marketplace.
What is a skill?
A skill is an imperative instruction set you hand to the agent. It has three parts.
Element
Role
Name
Skill identifier (globally unique)
Description (when to use)
The criteria the agent uses to decide when to invoke this skill
Body (SKILL.md)
The step-by-step instructions the agent follows
You can also bundle files (scripts, reference documents, etc.) with it when needed.
Skill vs prompt
They are easy to confuse but are opposites.
Prompt
You type it yourself. In chat, a / command expands saved text.
Skill
The agent chooses it. You never call a skill — when a request matches the description, the agent invokes it on its own.
That’s why writing a good description (“when to use”) matters most. The agent decides whether to trigger a skill based solely on this description.
Example: “Use when the user asks to organize meeting notes into the standard format.”
Skill list
Go to Workspace > Skills to see every skill you can access.
See every skill you can access in Workspace > Skills
Each card shows the name, description, author, and last-modified time. Use the search box at the top to search by name or description. The Generate with AI and + New Skill buttons are at the top right (if you have skill write permission).Card actions:
Action
Description
Click the card
Open the edit screen (if you have write permission)
Export
Download the skill as a JSON file
Delete
Owner or admin only
Export is a partial backup. It includes only the name, description, and body — not bundle files or access-control settings. Do not rely on it as a full backup.
Creating a skill
There are two ways to create a skill.
+ New Skill (write it yourself)
Generate with AI
Click + New Skill and enter the basic information first.
Click + New Skill and enter the basic information first
Field
Description
What are you working on? (name)
Skill name
When should the agent use this skill? (description)
Trigger condition
Permission
Private / Public. If private, set per-group read/write in the Groups card below
After saving, you go straight to the editor to write the body (SKILL.md). A skill you create yourself is private (owner-only) by default.
Click Generate with AI, describe the skill you need in natural language, and select a model.
Example: A skill that reviews Python code and suggests performance improvements
The AI drafts the skill’s name, description, and body. You are taken to the editor afterward to review and refine.
Describe the skill you need in natural language, then select a model
A skill generated with AI is saved as Public by default — every logged-in user can read it.
To keep it private, change the permission via the Access button in the editor.
A skill name must be unique across the whole workspace and is case-sensitive. Saving with a name that already exists produces an error.
Skill editor
The editor is a small IDE with a file tree on the left and an editing area on the right.
An AI-generated skill — select a file in the tree to edit it directly in the editor
Entry point — SKILL.md
SKILL.md always appears at the top of the file tree with an Entry tag. Its contents are the skill body — the instructions the agent follows when the skill is triggered.
Write the body as imperative instructions to the agent. The more specific the steps, rules, and output format, the more consistently the agent follows it.
Adding bundle files
Use the Add file button in the file tree to add scripts or reference documents. Specify a path (e.g. scripts/lookup.py, references/style-guide.md) and they are organized by folder.
Markdown files support a formatting toolbar (bold/italic/code/list) and an Edit/Preview toggle
Code files (.py, .js, .sql, etc.) get syntax highlighting
Only relative paths are allowed, and SKILL.md cannot be a bundle file (it is the entry point)
When the body references a bundle file, the agent reads it only when needed. It does not load all files at once, so you can include large reference materials without concern.
Meta information
The meta area at the top of the editor shows two things.
Item
Meaning
Used by agents
List of agents using this skill (reverse dependency)
Imported
Marks skills brought in from the marketplace, a bundle, etc.
Check Used by agents before deleting or heavily changing a skill. Trying to delete a skill that’s in use triggers a confirmation step.
Attaching to an agent
A skill only works once it’s attached to an agent.
1
Open the agent edit screen
Open the agent to edit in Workspace > Agents.
2
Select in the Skills section
Add the skills to attach in the Skills section. Marketplace document-generator capabilities are also selected here.
3
Save
After saving, the agent can use those skills.
Skills have no separate on/off toggle. Attaching to an agent turns it on; detaching turns it off. There is no per-conversation toggle.
How it works in chat
Once skills are attached to an agent, the following happens during chat.
The agent is always aware of the name + description list of attached skills
When a user request matches a skill’s description, the agent loads that skill’s body
It follows the instructions (reading bundle files or running scripts as needed)
It reflects the result in the answer
Skill activation has no separate on-screen indicator. The agent simply follows the instructions quietly. However, when a skill produces a file (like the document generators), the result file appears above the answer as 📎 Download: [filename](link) first.
Executable skills and document generation
Some skills can actually run bundled scripts to produce files (PPT, Word, Excel, HTML, etc.). Such executable skills work only under these conditions.
The skill must be marked as executable (the marketplace document generators are the prime example)
An administrator must have configured a code execution engine (Jupyter)
If the code execution engine is not configured, an executable skill cannot run its scripts and only follows the instructions, so no file is generated. If document generation isn’t working, ask your administrator to check the code execution setup.
Skills you write yourself cannot become executable. If you need executable document generation, use the document generators in the Marketplace.
Access control
Skills follow the same permission model as other workspace resources.
Option
Description
Public
Any logged-in user can read
Private
Owner and admin only. Can grant read/write to specific groups
When an agent uses a skill, it re-checks against the executing user’s read permission. Even if a private skill is attached to a shared agent, it is not exposed to or triggered for users who lack read access.
Administrators control per-group Skills Access permission (none/read/write) in Admin Panel > Users > Groups & Permissions. The default is None.
Troubleshooting
The Skills tab isn't showing
Cause
Solution
Preview environment restriction
The Skills tab appears only in certain environments. Contact your administrator
No permission
Ask an administrator to grant your group Skills Access permission
I can't save the name
Skill names must be unique across the whole workspace. Use a different name. (Names are case-sensitive.)
Documents (PPT, etc.) aren't being created
Executable skills require an administrator to configure a code execution engine (Jupyter). Check Admin Panel > Settings > Marketplace or the Code Execution settings.
I can't delete a skill
Deletion is blocked if agents are using it. Check the Used by agents list in the editor, and if you still want to delete it, confirm the force delete.
FAQ
How is a skill different from a knowledge base?
A knowledge base (RAG) retrieves and provides factual information. A skill provides a method or procedure. They work together — for example, a skill instructs “organize it in this format,” and the knowledge base fills in the content.
How long can the skill body be?
We recommend under 500 lines. Don’t put long reference material in the body — split it into bundle files and reference them from the body. The agent reads them only when needed.
Can multiple agents use the same skill?
Yes. You can attach one skill to multiple agents. Check Used by agents in the editor to see which agents currently use it.
Can I use an AI-generated skill right away?
It’s a draft, so always review it. In particular it’s saved as Public by default, so if needed, change the access to Private and refine the body before using it.
Next steps
Marketplace
Set up the PPT/Word/Excel/HTML document generators and Google Workspace/Microsoft 365 integrations
Attach to an agent
Attach skills to agents to standardize how they work
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"en/workspace/skills","slug":"/en/workspace/skills","pageMetadata":{"title":"Skills","description":"Create reusable instruction playbooks that agents invoke on their own to standardize repetitive work like document generation","href":"/en/workspace/skills"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create reusable instruction playbooks that agents invoke on their own to standardize repetitive work like document generation\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CodeBlock,Columns,Frame,Heading,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A Skill is a `,_jsx(_components.strong,{children:`reusable instruction playbook that an agent invokes on its own`}),`.\nDefine the method once (“when this kind of request comes in, handle it this way”), and the agent automatically loads and follows it whenever a request during a conversation matches the skill’s purpose.`]}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[User request] --> B[Agent checks skill catalog\u003cbr/>name + when to use]\n B --> C{Is there a\u003cbr/>matching skill?}\n C -->|No| D[Answer from general knowledge]\n C -->|Yes| E[Load skill body]\n E --> F[Follow instructions exactly]\n F --> G[Answer · result]`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The Skills tab is currently in `,_jsx(_components.strong,{children:`preview`}),` and appears only in certain environments (development/staging hosts).\nIf the Skills tab isn’t visible in production, contact your administrator. Document-generation skills (PPT, Word, Excel, HTML) are provided through the `,_jsx(_components.a,{href:`/en/workspace/marketplace`,children:`Marketplace`}),`.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`what-is-a-skill`,children:`What is a skill?`}),`\n`,_jsxs(_components.p,{children:[`A skill is an `,_jsx(_components.strong,{children:`imperative instruction set`}),` you hand to the agent. It has three parts.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Element`}),_jsx(_components.th,{children:`Role`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Name`})}),_jsx(_components.td,{children:`Skill identifier (globally unique)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Description (when to use)`})}),_jsx(_components.td,{children:`The criteria the agent uses to decide when to invoke this skill`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Body (SKILL.md)`})}),_jsx(_components.td,{children:`The step-by-step instructions the agent follows`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`You can also bundle `,_jsx(_components.strong,{children:`files`}),` (scripts, reference documents, etc.) with it when needed.`]}),`\n`,_jsx(Heading,{level:`3`,id:`skill-vs-prompt`,children:`Skill vs prompt`}),`\n`,_jsx(_components.p,{children:`They are easy to confuse but are opposites.`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Prompt`,icon:`message`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`You type it yourself.`}),` In chat, a `,_jsx(_components.code,{children:`/`}),` command expands saved text.`]})}),_jsx(Card,{title:`Skill`,icon:`wand-magic-sparkles`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`The agent chooses it.`}),` You never call a skill — when a request matches the description, the agent invokes it on its own.`]})})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`That’s why `,_jsx(_components.strong,{children:`writing a good description (“when to use”) matters most.`}),` The agent decides whether to trigger a skill based solely on this description.\nExample: “Use when the user asks to organize meeting notes into the standard format.”`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`skill-list`,children:`Skill list`}),`\n`,_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Workspace > Skills`}),` to see every skill you can access.`]}),`\n`,_jsx(Frame,{caption:`See every skill you can access in Workspace > Skills`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-list.png?fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=af75e26be47aee2fdc3bc8f05fc0d849`,alt:`Skill list`,\"data-og-width\":`1913`,width:`1913`,\"data-og-height\":`907`,height:`907`,\"data-path\":`images/en/workspace/skills-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=5a235b066b4a999f61ed2f5b7bac3c06 280w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=a042e613e39d4b7cbfe2fd56e17ecf6f 560w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=aa6cf3c25f98fd44702fc90d2c36ed67 840w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=4d56f3f9564f7534dad5a633bd546926 1100w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=f76a263dbc5051633705473e804263b3 1650w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=a4dd4a7f506efe8d2bb77c3cf66ab33f 2500w`})}),`\n`,_jsxs(_components.p,{children:[`Each card shows the name, description, author, and last-modified time. Use the search box at the top to search by name or description. The `,_jsx(_components.strong,{children:`Generate with AI`}),` and `,_jsx(_components.strong,{children:`+ New Skill`}),` buttons are at the top right (if you have skill write permission).`]}),`\n`,_jsx(_components.p,{children:`Card actions:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Click the card`})}),_jsx(_components.td,{children:`Open the edit screen (if you have write permission)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Export`})}),_jsx(_components.td,{children:`Download the skill as a JSON file`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Delete`})}),_jsx(_components.td,{children:`Owner or admin only`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Export is a partial backup.`}),` It includes only the name, description, and body — not bundle files or access-control settings. Do not rely on it as a full backup.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`creating-a-skill`,children:`Creating a skill`}),`\n`,_jsx(_components.p,{children:`There are two ways to create a skill.`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`+ New Skill (write it yourself)`,id:`%2B-new-skill-write-it-yourself`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`+ New Skill`}),` and enter the basic information first.`]}),_jsx(Frame,{caption:`Click **+ New Skill** and enter the basic information first`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-create.png?fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=226dcb7a30eb1f12ef52ed875be1f772`,alt:`Create a skill form`,\"data-og-width\":`821`,width:`821`,\"data-og-height\":`492`,height:`492`,\"data-path\":`images/en/workspace/skills-create.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-create.png?w=280\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=b93d82e6029e46990f02837df758605c 280w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-create.png?w=560\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=6db46f89e5e553c5362e8bc3771290a4 560w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-create.png?w=840\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=641fb7e4d692ab057e9e4ce8a36901b6 840w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-create.png?w=1100\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=8dfe2ffb25ffd9adc384e7820b49bf72 1100w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-create.png?w=1650\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=0fcb8d9ae78156fecca203ca0787bfbc 1650w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-create.png?w=2500\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=3f435fbcc84ee79ee7382e373442f240 2500w`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`What are you working on?`}),` (name)`]}),_jsx(_components.td,{children:`Skill name`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`When should the agent use this skill?`}),` (description)`]}),_jsx(_components.td,{children:`Trigger condition`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Permission`})}),_jsxs(_components.td,{children:[`Private / Public. If private, set per-group read/write in the `,_jsx(_components.strong,{children:`Groups`}),` card below`]})]})]})]}),_jsxs(_components.p,{children:[`After saving, you go straight to the `,_jsx(_components.strong,{children:`editor`}),` to write the body (SKILL.md). A skill you create yourself is `,_jsx(_components.strong,{children:`private`}),` (owner-only) by default.`]})]}),_jsxs(Tab,{title:`Generate with AI`,id:`generate-with-ai`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Generate with AI`}),`, describe the skill you need in natural language, and select a model.`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Example: A skill that reviews Python code and suggests performance improvements`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`The AI drafts the skill’s `,_jsx(_components.strong,{children:`name, description, and body`}),`. You are taken to the editor afterward to review and refine.`]}),_jsx(Frame,{caption:`Describe the skill you need in natural language, then select a model`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-generate-ai.png?fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=26879173d2235351e062c8fcd7d84202`,alt:`Generate with AI modal`,\"data-og-width\":`508`,width:`508`,\"data-og-height\":`384`,height:`384`,\"data-path\":`images/en/workspace/skills-generate-ai.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-generate-ai.png?w=280\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=b88db41a66f18010cbf3c8fbfed85141 280w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-generate-ai.png?w=560\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=02b322c1f8b67b320bb7ca6dea9ac85b 560w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-generate-ai.png?w=840\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=fd7b4b7a39773d70cc8cc34b6f218941 840w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-generate-ai.png?w=1100\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=23dc18cfe7d72cd638931c9dfbd9070b 1100w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-generate-ai.png?w=1650\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=283a8d5c577e992f9703021a7e29c268 1650w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-generate-ai.png?w=2500\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=ecd2c931daafa40fc45e5201a8d1d26d 2500w`})}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`A skill generated with AI is saved as Public by default`}),` — every logged-in user can read it.\nTo keep it private, change the permission via the `,_jsx(_components.strong,{children:`Access`}),` button in the editor.`]})})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`A skill `,_jsx(_components.strong,{children:`name must be unique across the whole workspace`}),` and is case-sensitive. Saving with a name that already exists produces an error.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`skill-editor`,children:`Skill editor`}),`\n`,_jsxs(_components.p,{children:[`The editor is a small IDE with a `,_jsx(_components.strong,{children:`file tree`}),` on the left and an `,_jsx(_components.strong,{children:`editing area`}),` on the right.`]}),`\n`,_jsx(Frame,{caption:`An AI-generated skill — select a file in the tree to edit it directly in the editor`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-editor.png?fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=1d473d5ea222b53126fcb2f4a9a76d22`,alt:`Skill editor`,\"data-og-width\":`1906`,width:`1906`,\"data-og-height\":`907`,height:`907`,\"data-path\":`images/en/workspace/skills-editor.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-editor.png?w=280\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=46a4c3eb25a828cdb88fd9675e2b4a11 280w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-editor.png?w=560\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=8059941206d218c6dd031b9209d76109 560w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-editor.png?w=840\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=ea3303a7480c2537b9e3383c39ba88ce 840w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-editor.png?w=1100\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=d9c95362c444ef6474d50533410b3236 1100w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-editor.png?w=1650\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=18e8ce94c9693c2eafb18200c7f46553 1650w, https://mintcdn.com/cloocus/3DqvQt_1XXNsHMlX/images/en/workspace/skills-editor.png?w=2500\u0026fit=max\u0026auto=format\u0026n=3DqvQt_1XXNsHMlX\u0026q=85\u0026s=f23f017c09675c22c5dbbd8a920cdc36 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`entry-point-—-skill-md`,children:`Entry point — SKILL.md`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`SKILL.md`}),` always appears at the top of the file tree with an `,_jsx(_components.strong,{children:`Entry`}),` tag. Its contents are the skill body — the instructions the agent follows when the skill is triggered.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Write the body as `,_jsx(_components.strong,{children:`imperative instructions to the agent.`}),` The more specific the steps, rules, and output format, the more consistently the agent follows it.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`adding-bundle-files`,children:`Adding bundle files`}),`\n`,_jsxs(_components.p,{children:[`Use the `,_jsx(_components.strong,{children:`Add file`}),` button in the file tree to add scripts or reference documents. Specify a path (e.g. `,_jsx(_components.code,{children:`scripts/lookup.py`}),`, `,_jsx(_components.code,{children:`references/style-guide.md`}),`) and they are organized by folder.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Markdown files support a formatting toolbar (bold/italic/code/list) and an `,_jsx(_components.strong,{children:`Edit/Preview`}),` toggle`]}),`\n`,_jsxs(_components.li,{children:[`Code files (`,_jsx(_components.code,{children:`.py`}),`, `,_jsx(_components.code,{children:`.js`}),`, `,_jsx(_components.code,{children:`.sql`}),`, etc.) get syntax highlighting`]}),`\n`,_jsxs(_components.li,{children:[`Only relative paths are allowed, and `,_jsx(_components.code,{children:`SKILL.md`}),` cannot be a bundle file (it is the entry point)`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`When the body references a bundle file, the agent reads it only when needed. It does not load all files at once, so you can include large reference materials without concern.`})}),`\n`,_jsx(Heading,{level:`3`,id:`meta-information`,children:`Meta information`}),`\n`,_jsx(_components.p,{children:`The meta area at the top of the editor shows two things.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Item`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Used by agents`})}),_jsx(_components.td,{children:`List of agents using this skill (reverse dependency)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Imported`})}),_jsx(_components.td,{children:`Marks skills brought in from the marketplace, a bundle, etc.`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Check `,_jsx(_components.strong,{children:`Used by agents`}),` before deleting or heavily changing a skill. Trying to delete a skill that’s in use triggers a confirmation step.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`attaching-to-an-agent`,children:`Attaching to an agent`}),`\n`,_jsx(_components.p,{children:`A skill only works once it’s attached to an agent.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the agent edit screen`,children:_jsxs(_components.p,{children:[`Open the agent to edit in `,_jsx(_components.strong,{children:`Workspace > Agents`}),`.`]})}),_jsx(Step,{title:`Select in the Skills section`,children:_jsxs(_components.p,{children:[`Add the skills to attach in the `,_jsx(_components.strong,{children:`Skills`}),` section. Marketplace document-generator capabilities are also selected here.`]})}),_jsx(Step,{title:`Save`,children:_jsx(_components.p,{children:`After saving, the agent can use those skills.`})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Skills have no separate on/off toggle. `,_jsx(_components.strong,{children:`Attaching to an agent turns it on; detaching turns it off.`}),` There is no per-conversation toggle.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works-in-chat`,children:`How it works in chat`}),`\n`,_jsx(_components.p,{children:`Once skills are attached to an agent, the following happens during chat.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`The agent is always aware of the `,_jsx(_components.strong,{children:`name + description`}),` list of attached skills`]}),`\n`,_jsxs(_components.li,{children:[`When a user request matches a skill’s description, the agent `,_jsx(_components.strong,{children:`loads that skill’s body`})]}),`\n`,_jsx(_components.li,{children:`It follows the instructions (reading bundle files or running scripts as needed)`}),`\n`,_jsx(_components.li,{children:`It reflects the result in the answer`}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Skill activation has `,_jsx(_components.strong,{children:`no separate on-screen indicator.`}),` The agent simply follows the instructions quietly. However, when a skill produces a file (like the document generators), the result file appears above the answer as `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`📎 Download: [filename](link)`})}),` first.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`executable-skills-and-document-generation`,children:`Executable skills and document generation`}),`\n`,_jsxs(_components.p,{children:[`Some skills can actually `,_jsx(_components.strong,{children:`run`}),` bundled scripts to produce files (PPT, Word, Excel, HTML, etc.). Such `,_jsx(_components.strong,{children:`executable skills`}),` work only under these conditions.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The skill must be marked as executable (the marketplace document generators are the prime example)`}),`\n`,_jsxs(_components.li,{children:[`An administrator must have configured a `,_jsx(_components.strong,{children:`code execution engine (Jupyter)`})]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`If the code execution engine is not configured, an executable skill cannot run its scripts and only follows the instructions, so `,_jsx(_components.strong,{children:`no file is generated.`}),` If document generation isn’t working, ask your administrator to check the code execution setup.`]})}),`\n`,_jsxs(_components.p,{children:[`Skills you write yourself cannot become executable. If you need executable document generation, use the document generators in the `,_jsx(_components.a,{href:`/en/workspace/marketplace`,children:`Marketplace`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`access-control`,children:`Access control`}),`\n`,_jsx(_components.p,{children:`Skills follow the same permission model as other workspace resources.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Public`})}),_jsx(_components.td,{children:`Any logged-in user can read`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Private`})}),_jsxs(_components.td,{children:[`Owner and admin only. Can grant read/write to specific `,_jsx(_components.strong,{children:`groups`})]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`When an agent uses a skill, it re-checks against the `,_jsx(_components.strong,{children:`executing user’s read permission.`}),` Even if a private skill is attached to a shared agent, it is not exposed to or triggered for users who lack read access.`]})}),`\n`,_jsxs(_components.p,{children:[`Administrators control per-group `,_jsx(_components.strong,{children:`Skills Access`}),` permission (none/read/write) in `,_jsx(_components.strong,{children:`Admin Panel > Users > Groups \u0026 Permissions`}),`. The default is `,_jsx(_components.strong,{children:`None`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`The Skills tab isn't showing`,icon:`eye-slash`,id:`the-skills-tab-isnt-showing`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Cause`}),_jsx(_components.th,{children:`Solution`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Preview environment restriction`}),_jsx(_components.td,{children:`The Skills tab appears only in certain environments. Contact your administrator`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`No permission`}),_jsxs(_components.td,{children:[`Ask an administrator to grant your group `,_jsx(_components.strong,{children:`Skills Access`}),` permission`]})]})]})]})}),_jsx(Accordion,{title:`I can't save the name`,icon:`triangle-exclamation`,id:`i-cant-save-the-name`,children:_jsx(_components.p,{children:`Skill names must be unique across the whole workspace. Use a different name. (Names are case-sensitive.)`})}),_jsx(Accordion,{title:`Documents (PPT, etc.) aren't being created`,icon:`file-slash`,id:`documents-ppt-etc-arent-being-created`,children:_jsxs(_components.p,{children:[`Executable skills require an administrator to configure a code execution engine (Jupyter). Check `,_jsx(_components.strong,{children:`Admin Panel > Settings > Marketplace`}),` or the `,_jsx(_components.strong,{children:`Code Execution`}),` settings.`]})}),_jsx(Accordion,{title:`I can't delete a skill`,icon:`lock`,id:`i-cant-delete-a-skill`,children:_jsxs(_components.p,{children:[`Deletion is blocked if agents are using it. Check the `,_jsx(_components.strong,{children:`Used by agents`}),` list in the editor, and if you still want to delete it, confirm the force delete.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`How is a skill different from a knowledge base?`,icon:`circle-question`,id:`how-is-a-skill-different-from-a-knowledge-base`,children:_jsxs(_components.p,{children:[`A knowledge base (RAG) retrieves and provides `,_jsx(_components.strong,{children:`factual information.`}),` A skill provides a `,_jsx(_components.strong,{children:`method or procedure.`}),` They work together — for example, a skill instructs “organize it in this format,” and the knowledge base fills in the content.`]})}),_jsx(Accordion,{title:`How long can the skill body be?`,icon:`circle-question`,id:`how-long-can-the-skill-body-be`,children:_jsxs(_components.p,{children:[`We recommend under 500 lines. Don’t put long reference material in the body — split it into `,_jsx(_components.strong,{children:`bundle files`}),` and reference them from the body. The agent reads them only when needed.`]})}),_jsx(Accordion,{title:`Can multiple agents use the same skill?`,icon:`circle-question`,id:`can-multiple-agents-use-the-same-skill`,children:_jsxs(_components.p,{children:[`Yes. You can attach one skill to multiple agents. Check `,_jsx(_components.strong,{children:`Used by agents`}),` in the editor to see which agents currently use it.`]})}),_jsx(Accordion,{title:`Can I use an AI-generated skill right away?`,icon:`circle-question`,id:`can-i-use-an-ai-generated-skill-right-away`,children:_jsx(_components.p,{children:`It’s a draft, so always review it. In particular it’s saved as Public by default, so if needed, change the access to Private and refine the body before using it.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Marketplace`,icon:`store`,href:`/en/workspace/marketplace`,children:_jsx(_components.p,{children:`Set up the PPT/Word/Excel/HTML document generators and Google Workspace/Microsoft 365 integrations`})}),_jsx(Card,{title:`Attach to an agent`,icon:`robot`,href:`/en/workspace/agents`,children:_jsx(_components.p,{children:`Attach skills to agents to standardize how they work`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Skills","description":"Create reusable instruction playbooks that agents invoke on their own to standardize repetitive work like document generation","href":"/en/workspace/skills"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What is a skill?","slug":"what-is-a-skill","depth":2,"children":[{"title":"Skill vs prompt","slug":"skill-vs-prompt","depth":3,"children":[]}]},{"title":"Skill list","slug":"skill-list","depth":2,"children":[]},{"title":"Creating a skill","slug":"creating-a-skill","depth":2,"children":[]},{"title":"Skill editor","slug":"skill-editor","depth":2,"children":[{"title":"Entry point — SKILL.md","slug":"entry-point-—-skill-md","depth":3,"children":[]},{"title":"Adding bundle files","slug":"adding-bundle-files","depth":3,"children":[]},{"title":"Meta information","slug":"meta-information","depth":3,"children":[]}]},{"title":"Attaching to an agent","slug":"attaching-to-an-agent","depth":2,"children":[]},{"title":"How it works in chat","slug":"how-it-works-in-chat","depth":2,"children":[]},{"title":"Executable skills and document generation","slug":"executable-skills-and-document-generation","depth":2,"children":[]},{"title":"Access control","slug":"access-control","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"Skills - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/workspace/skills","matchLevel":1},"en":{"href":"/en/workspace/skills","matchLevel":0}}},"lastModified":"2026-08-21T05:37:35.428Z","originalFileLocation":"en/workspace/skills.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create reusable instruction playbooks that agents invoke on their own to standardize repetitive work like document generation\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Skills - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create reusable instruction playbooks that agents invoke on their own to standardize repetitive work like document generation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/en/workspace/skills\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=Customization\u0026amp;title=Skills\u0026amp;description=Create+reusable+instruction+playbooks+that+agents+invoke+on+their+own+to+standardize+repetitive+work+like+document+generation\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=3b2ddef1e7d80c0d81c534fb0cc8518a7e0fe266b00d1ade22d24972de028d9a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Skills - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create reusable instruction playbooks that agents invoke on their own to standardize repetitive work like document generation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=Customization\u0026amp;title=Skills\u0026amp;description=Create+reusable+instruction+playbooks+that+agents+invoke+on+their+own+to+standardize+repetitive+work+like+document+generation\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=3b2ddef1e7d80c0d81c534fb0cc8518a7e0fe266b00d1ade22d24972de028d9a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/en/workspace/skills\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/workspace/skills.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/workspace/skills\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/workspace/skills\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/workspace/skills\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/en/workspace/skills#webpage\",\"url\":\"https://docs.cloosphere.ai/en/workspace/skills\",\"name\":\"Skills\",\"description\":\"Create reusable instruction playbooks that agents invoke on their own to standardize repetitive work like document generation\",\"dateModified\":\"2026-08-21T05:37:35.428Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/en/workspace/skills#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/en/workspace/skills#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Customization\",\"item\":\"https://docs.cloosphere.ai/en/workspace/prompts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Skills\",\"item\":\"https://docs.cloosphere.ai/en/workspace/skills\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/en/workspace/skills#article\",\"headline\":\"Skills\",\"name\":\"Skills\",\"description\":\"Create reusable instruction playbooks that agents invoke on their own to standardize repetitive work like document generation\",\"url\":\"https://docs.cloosphere.ai/en/workspace/skills\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/en/workspace/skills#webpage\"},\"dateModified\":\"2026-08-21T05:37:35.428Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/workspace/skills.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"pages":[{"title":"ko","href":"/ko/workspace/skills"}]},{"language":"en","tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/en"}]},{"tab":"Chat","icon":"comments","pages":[{"title":"Chat","href":"/en/chat/overview"}]},{"tab":"Workspace","icon":"briefcase","groups":[{"group":"Workspace","pages":[{"title":"Workspace","href":"/en/workspace/overview"}]},{"group":"AI Agents","pages":[{"title":"Agents","href":"/en/workspace/agents"},{"title":"Agent Flow","href":"/en/workspace/flows"},{"title":"Flow Node Reference","href":"/en/workspace/flows-nodes"}]},{"group":"Knowledge \u0026 Data","pages":[{"title":"Knowledge Base","href":"/en/workspace/knowledge"},{"title":"Dynamic Filters Deep-Dive","href":"/en/workspace/knowledge-filters"},{"title":"Knowledge Graph","href":"/en/workspace/knowledge-graph"},{"title":"Database","href":"/en/workspace/database"},{"title":"Glossary","href":"/en/workspace/glossary"}]},{"group":"Safety","pages":[{"title":"Guardrails","href":"/en/workspace/guardrails"}]},{"group":"Customization","pages":[{"title":"Prompts","description":"Create reusable prompt templates with variable substitution and team sharing","href":"/en/workspace/prompts"},{"title":"Skills","href":"/en/workspace/skills"},{"title":"Tools","description":"Connect external APIs and MCP servers to AI for real-time data lookup and task automation","href":"/en/workspace/tools"},{"title":"Marketplace","href":"/en/workspace/marketplace"},{"title":"Tags","href":"/en/workspace/tags"}]}]},{"tab":"Collaboration","icon":"users","pages":[{"title":"Collaboration","href":"/en/collaboration/overview"}]},{"tab":"Automation","icon":"clock","pages":[{"title":"Automation","href":"/en/automation/overview"}]},{"tab":"Admin","icon":"gear","pages":[{"title":"Admin","href":"/en/admin/overview"}]},{"tab":"Monitoring","icon":"chart-line","pages":[{"title":"Monitoring","href":"/en/monitoring/overview"}]},{"tab":"Resources","icon":"screwdriver-wrench","pages":[{"title":"Resources","href":"/en/admin/deployment-checklist"}]}]}]},"basePath":"","title":"Skills - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}