How to create and edit custom skills through the Context Builder.
A skill is a reusable analytical methodology the agent follows step by step when invoked with /skill_name. The Context Builder is where you create new skills, edit existing ones, and refine them based on real usage.You can provide a full methodology or just describe the analysis you want to capture. The agent structures the skill for you — writing the content, defining clarifications, and setting up the todo list.
Starting a Skill
You can start a new skill from three places:
Skills page — Click Add Skill in the top right. ClarityQ opens a Builder chat with the command pre-filled.
Builder chat directly — Type /skill add in any Builder chat.
From an Ask Anything conversation — If you’ve just run an analysis in Ask Anything that you’d like to make repeatable, continue in the Builder. The agent already has the context and can encode the methodology into a skill.
What the Agent Creates
The agent builds a skill with the following fields:
Name — A snake_case identifier that becomes the slash command (e.g., /cohort_analysis)
Description — A one-line summary shown in the slash command picker. This is what triggers the agent to import the skill, so it includes what the skill does, when to use it, and trigger phrases
Content — The methodology itself in structured Markdown — rules, steps, constraints, SQL patterns, and gotchas specific to your data
Clarifications — Questions the agent asks the user before running the skill, to gather any required inputs
Todo list — The checklist the agent works through during execution
Before writing anything, the agent checks for existing skills that cover the same topic. If one exists, it suggests editing it instead of creating a near-duplicate.
Clarifications, Todo List, and References
Skills have three supporting mechanisms that control how the agent behaves when running them. You can use clarifications, a todo list, or both — depending on what the skill needs.
Clarifications
Questions the agent asks the user before executing the skill. Use clarifications when the skill needs one or two small inputs that change the analytical path — for example, which date range to use or which user segment to focus on.Keep clarifications minimal. If you find yourself adding more than two or three, the skill’s content should handle the branching instead.
Todo List
A checklist the agent works through during execution. Each todo item maps to a step or rule in the skill’s content, keeping the agent on track as it progresses through the analysis.When the agent creates a skill, it typically generates the right todo list automatically based on the content. You can review and adjust the items if needed.In chat, the todo list appears as a visible checklist with checkboxes. As the agent completes each step, it checks off the corresponding item — so you can follow along and see exactly where the agent is in the workflow.Use a todo list when the skill has multiple steps and you want to ensure none are skipped.
References
Supplementary documentation that loads on demand. When the agent imports a skill, it sees the names and descriptions of its references — but the full content only loads when the agent decides it needs more detail. This keeps skills concise while supporting deep documentation when needed.References are ideal for information that’s too detailed or too long to put in the skill’s content but that the agent may need to consult during execution — business logic edge cases, known data quirks, analysis guidelines, or output formatting rules.Example: A /funnel_analysis skill’s content defines the general methodology — how to build a funnel query, how to calculate drop-off rates, and how to present results. Its references contain special requirements for specific funnels: “Onboarding funnel” might document that step 2 must exclude users who skipped the tutorial, while “Purchase funnel” might note that the checkout step has a known 30-second delay before the event fires. The agent loads the relevant reference only when the user asks about that particular funnel.
The Description Matters Most
The description is the only thing the agent reads on every message to decide whether to import a skill. The content and hooks only load if the description triggers first.The agent usually writes a good description automatically, but it’s worth reviewing to make sure it captures the right scope — specific enough to trigger on relevant questions, but not so broad that it fires on unrelated ones.A good description follows this pattern: what it does + when to use it + trigger phrases. For example: “Analyze user retention by cohort. Use when: ‘retention’, ‘cohort analysis’, ‘D7 retention’.”
Editing Skills
Edit an existing skill from the Skills page (click Edit in the row menu) or type /skill edit <skill_name> in a Builder chat. The agent loads the current definition and walks you through the changes. Each save creates a new version.
Testing and Iterating
Before deploying a skill, test it in Ask Anything by invoking it with /skill_name. Review the agent’s output — did it follow the right steps? Did it miss anything? Did it produce the answer you expected?If something is off, go back to the Builder and refine the skill. Repeat until the results are consistent and accurate. First drafts rarely come out perfect, and that’s fine — the iteration is what makes a skill reliable.
You don’t need to have the perfect skill in mind before you start. Chat with the agent in the Builder — describe the analysis you’re trying to capture, brainstorm the steps, debate edge cases, and iterate on the content together. The agent will refine the skill with you until it’s right. The conversation is the drafting process.
The best skills come from encoding workflows your team already runs manually. If you find yourself explaining the same analysis more than once, that’s a skill.
Skill Scope
All custom skills are scoped to the workspace level — once deployed, they’re available to everyone working in the workspace.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ClarityQ Documentation","colors":{"primary":"#5A57FC","light":"#9391ff","dark":"#5A57FC"},"logo":{"light":"https://mintcdn.com/clarityq/RMDLvxRyN9-VIA7h/logo/light.svg?fit=max\u0026auto=format\u0026n=RMDLvxRyN9-VIA7h\u0026q=85\u0026s=f8d4e57d3c0e50c3f720e5b6a7afef0b","dark":"https://mintcdn.com/clarityq/RMDLvxRyN9-VIA7h/logo/dark.svg?fit=max\u0026auto=format\u0026n=RMDLvxRyN9-VIA7h\u0026q=85\u0026s=f838d08af4bdbf4b9f80be89bbd57203"},"favicon":"https://mintcdn.com/clarityq/RMDLvxRyN9-VIA7h/favicon.svg?fit=max\u0026auto=format\u0026n=RMDLvxRyN9-VIA7h\u0026q=85\u0026s=ccd0c18ac98544dea1c3e42018f2db76","navbar":{"links":[{"href":"mailto:support@clarityq.ai","label":"Support"}]},"footer":{"socials":{"linkedin":"https://linkedin.com/company/clarityq"}},"seo":{"metatags":{"msvalidate.01":"2653DA8E28F50109EA5130713FEE874C"},"indexing":"all"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"clarityq","hasAudioNarration":false,"actualSubdomain":"clarityq","customDomains":["docs.clarityq.ai"],"gitSource":{"type":"github","owner":"clarityq","repo":"clarityq-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afd9ba25e3b11ff7dbe3e94","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Context Layer","count":19},{"language":"default","tag":"Data Warehouse Connections","count":11},{"language":"default","tag":"Integrations","count":11},{"language":"default","tag":"Building the Context Layer","count":10},{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Ask Anything","count":8},{"language":"default","tag":"Administration","count":7},{"language":"default","tag":"Semantic Catalog","count":6},{"language":"default","tag":"Event Catalog","count":5},{"language":"default","tag":"Dashboards","count":5}]},"assistantConfig":{},"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":"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":[],"page":{"pagePath":"context-layer/building/building-skills","slug":"/context-layer/building/building-skills","pageMetadata":{"title":"Building Skills","description":"How to create and edit custom skills through the Context Builder.","href":"/context-layer/building/building-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: \"How to create and edit custom skills through the Context Builder.\"\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`,em:`em`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A `,_jsx(_components.a,{href:`/context-layer/skills`,children:`skill`}),` is a reusable analytical methodology the agent follows step by step when invoked with `,_jsx(_components.code,{children:`/skill_name`}),`. The `,_jsx(_components.strong,{children:`Context Builder`}),` is where you create new skills, edit existing ones, and refine them based on real usage.`]}),`\n`,_jsx(_components.p,{children:`You can provide a full methodology or just describe the analysis you want to capture. The agent structures the skill for you — writing the content, defining clarifications, and setting up the todo list.`}),`\n`,_jsx(Heading,{level:`2`,id:`starting-a-skill`,children:`Starting a Skill`}),`\n`,_jsx(_components.p,{children:`You can start a new skill from three places:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Skills page`}),` — Click `,_jsx(_components.strong,{children:`Add Skill`}),` in the top right. ClarityQ opens a Builder chat with the command pre-filled.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Builder chat directly`}),` — Type `,_jsx(_components.code,{children:`/skill add`}),` in any Builder chat.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`From an Ask Anything conversation`}),` — If you’ve just run an analysis in Ask Anything that you’d like to make repeatable, continue in the Builder. The agent already has the context and can encode the methodology into a skill.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-the-agent-creates`,children:`What the Agent Creates`}),`\n`,_jsx(_components.p,{children:`The agent builds a skill with the following fields:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name`}),` — A `,_jsx(_components.code,{children:`snake_case`}),` identifier that becomes the slash command (e.g., `,_jsx(_components.code,{children:`/cohort_analysis`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Description`}),` — A one-line summary shown in the slash command picker. This is what triggers the agent to import the skill, so it includes what the skill does, when to use it, and trigger phrases`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Content`}),` — The methodology itself in structured Markdown — rules, steps, constraints, SQL patterns, and gotchas specific to your data`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Clarifications`}),` — Questions the agent asks the user before running the skill, to gather any required inputs`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Todo list`}),` — The checklist the agent works through during execution`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Before writing anything, the agent checks for existing skills that cover the same topic. If one exists, it suggests editing it instead of creating a near-duplicate.`}),`\n`,_jsx(Heading,{level:`2`,id:`clarifications-todo-list-and-references`,children:`Clarifications, Todo List, and References`}),`\n`,_jsx(_components.p,{children:`Skills have three supporting mechanisms that control how the agent behaves when running them. You can use clarifications, a todo list, or both — depending on what the skill needs.`}),`\n`,_jsx(Heading,{level:`3`,id:`clarifications`,children:`Clarifications`}),`\n`,_jsxs(_components.p,{children:[`Questions the agent asks the user `,_jsx(_components.strong,{children:`before`}),` executing the skill. Use clarifications when the skill needs one or two small inputs that change the analytical path — for example, which date range to use or which user segment to focus on.`]}),`\n`,_jsx(_components.p,{children:`Keep clarifications minimal. If you find yourself adding more than two or three, the skill’s content should handle the branching instead.`}),`\n`,_jsx(Heading,{level:`3`,id:`todo-list`,children:`Todo List`}),`\n`,_jsxs(_components.p,{children:[`A checklist the agent works through `,_jsx(_components.strong,{children:`during`}),` execution. Each todo item maps to a step or rule in the skill’s content, keeping the agent on track as it progresses through the analysis.`]}),`\n`,_jsx(_components.p,{children:`When the agent creates a skill, it typically generates the right todo list automatically based on the content. You can review and adjust the items if needed.`}),`\n`,_jsx(_components.p,{children:`In chat, the todo list appears as a visible checklist with checkboxes. As the agent completes each step, it checks off the corresponding item — so you can follow along and see exactly where the agent is in the workflow.`}),`\n`,_jsx(_components.p,{children:`Use a todo list when the skill has multiple steps and you want to ensure none are skipped.`}),`\n`,_jsx(Heading,{level:`3`,id:`references`,children:`References`}),`\n`,_jsx(_components.p,{children:`Supplementary documentation that loads on demand. When the agent imports a skill, it sees the names and descriptions of its references — but the full content only loads when the agent decides it needs more detail. This keeps skills concise while supporting deep documentation when needed.`}),`\n`,_jsx(_components.p,{children:`References are ideal for information that’s too detailed or too long to put in the skill’s content but that the agent may need to consult during execution — business logic edge cases, known data quirks, analysis guidelines, or output formatting rules.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Example:`}),` A `,_jsx(_components.code,{children:`/funnel_analysis`}),` skill’s content defines the general methodology — how to build a funnel query, how to calculate drop-off rates, and how to present results. Its references contain special requirements for specific funnels: “Onboarding funnel” might document that step 2 must exclude users who skipped the tutorial, while “Purchase funnel” might note that the checkout step has a known 30-second delay before the event fires. The agent loads the relevant reference only when the user asks about that particular funnel.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-description-matters-most`,children:`The Description Matters Most`}),`\n`,_jsx(_components.p,{children:`The description is the only thing the agent reads on every message to decide whether to import a skill. The content and hooks only load if the description triggers first.`}),`\n`,_jsx(_components.p,{children:`The agent usually writes a good description automatically, but it’s worth reviewing to make sure it captures the right scope — specific enough to trigger on relevant questions, but not so broad that it fires on unrelated ones.`}),`\n`,_jsxs(_components.p,{children:[`A good description follows this pattern: `,_jsx(_components.em,{children:`what it does + when to use it + trigger phrases.`}),` For example: `,_jsx(_components.em,{children:`“Analyze user retention by cohort. Use when: ‘retention’, ‘cohort analysis’, ‘D7 retention’.”`})]}),`\n`,_jsx(Heading,{level:`2`,id:`editing-skills`,children:`Editing Skills`}),`\n`,_jsxs(_components.p,{children:[`Edit an existing skill from the Skills page (click `,_jsx(_components.strong,{children:`Edit`}),` in the row menu) or type `,_jsx(_components.code,{children:`/skill edit \u003cskill_name>`}),` in a Builder chat. The agent loads the current definition and walks you through the changes. Each save creates a new version.`]}),`\n`,_jsx(Heading,{level:`2`,id:`testing-and-iterating`,children:`Testing and Iterating`}),`\n`,_jsxs(_components.p,{children:[`Before deploying a skill, test it in Ask Anything by invoking it with `,_jsx(_components.code,{children:`/skill_name`}),`. Review the agent’s output — did it follow the right steps? Did it miss anything? Did it produce the answer you expected?`]}),`\n`,_jsx(_components.p,{children:`If something is off, go back to the Builder and refine the skill. Repeat until the results are consistent and accurate. First drafts rarely come out perfect, and that’s fine — the iteration is what makes a skill reliable.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`You don’t need to have the perfect skill in mind before you start. Chat with the agent in the Builder — describe the analysis you’re trying to capture, brainstorm the steps, debate edge cases, and iterate on the content together. The agent will refine the skill with you until it’s right. The conversation `,_jsx(_components.em,{children:`is`}),` the drafting process.`]})}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`The best skills come from encoding workflows your team already runs manually. If you find yourself explaining the same analysis more than once, that’s a skill.`})}),`\n`,_jsx(Heading,{level:`2`,id:`skill-scope`,children:`Skill Scope`}),`\n`,_jsxs(_components.p,{children:[`All custom skills are scoped to the `,_jsx(_components.strong,{children:`workspace level`}),` — once deployed, they’re available to everyone working in the workspace.`]})]})}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":"Building Skills","description":"How to create and edit custom skills through the Context Builder.","href":"/context-layer/building/building-skills"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Starting a Skill","slug":"starting-a-skill","depth":2,"children":[]},{"title":"What the Agent Creates","slug":"what-the-agent-creates","depth":2,"children":[]},{"title":"Clarifications, Todo List, and References","slug":"clarifications-todo-list-and-references","depth":2,"children":[{"title":"Clarifications","slug":"clarifications","depth":3,"children":[]},{"title":"Todo List","slug":"todo-list","depth":3,"children":[]},{"title":"References","slug":"references","depth":3,"children":[]}]},{"title":"The Description Matters Most","slug":"the-description-matters-most","depth":2,"children":[]},{"title":"Editing Skills","slug":"editing-skills","depth":2,"children":[]},{"title":"Testing and Iterating","slug":"testing-and-iterating","depth":2,"children":[]},{"title":"Skill Scope","slug":"skill-scope","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"clarityq","siteName":"ClarityQ Documentation","title":"Building Skills - ClarityQ Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-16T10:16:24.132Z","originalFileLocation":"context-layer/building/building-skills.mdx"},"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=\"How to create and edit custom skills through the Context Builder.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ClarityQ Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_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/clarityq/YW4hrpKdd3h3lviU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_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/clarityq/YW4hrpKdd3h3lviU/_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/clarityq/YW4hrpKdd3h3lviU/_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/clarityq/YW4hrpKdd3h3lviU/_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/clarityq/YW4hrpKdd3h3lviU/_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/clarityq/YW4hrpKdd3h3lviU/_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/clarityq/YW4hrpKdd3h3lviU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Building Skills - ClarityQ Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"How to create and edit custom skills through the Context Builder.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ClarityQ Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.clarityq.ai/context-layer/building/building-skills\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://clarityq.mintlify.site/_mintlify/api/og/v2?division=Building+the+Context+Layer\u0026amp;title=Building+Skills\u0026amp;description=How+to+create+and+edit+custom+skills+through+the+Context+Builder.\u0026amp;theme=8a1189787dd42c7f361220a1\u0026amp;signature=8b9c60f6afa591cd218cb516f05ee9b7ea3528f086dbb411202174347964313c\">\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=\"Building Skills - ClarityQ Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How to create and edit custom skills through the Context Builder.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://clarityq.mintlify.site/_mintlify/api/og/v2?division=Building+the+Context+Layer\u0026amp;title=Building+Skills\u0026amp;description=How+to+create+and+edit+custom+skills+through+the+Context+Builder.\u0026amp;theme=8a1189787dd42c7f361220a1\u0026amp;signature=8b9c60f6afa591cd218cb516f05ee9b7ea3528f086dbb411202174347964313c\">\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/clarityq/YW4hrpKdd3h3lviU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ClarityQ Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5A57FC\">\u003cmeta data-mint-head name=\"msvalidate.01\" content=\"2653DA8E28F50109EA5130713FEE874C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.clarityq.ai/context-layer/building/building-skills\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/context-layer/building/building-skills.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.clarityq.ai/#organization\",\"name\":\"ClarityQ Documentation\",\"url\":\"https://docs.clarityq.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/clarityq/RMDLvxRyN9-VIA7h/logo/light.svg?fit=max\u0026auto=format\u0026n=RMDLvxRyN9-VIA7h\u0026q=85\u0026s=f8d4e57d3c0e50c3f720e5b6a7afef0b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.clarityq.ai#website\",\"name\":\"ClarityQ Documentation\",\"url\":\"https://docs.clarityq.ai\",\"publisher\":{\"@id\":\"https://docs.clarityq.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.clarityq.ai/context-layer/building/building-skills#webpage\",\"url\":\"https://docs.clarityq.ai/context-layer/building/building-skills\",\"name\":\"Building Skills\",\"description\":\"How to create and edit custom skills through the Context Builder.\",\"dateModified\":\"2026-09-16T10:16:24.132Z\",\"isPartOf\":{\"@id\":\"https://docs.clarityq.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.clarityq.ai/context-layer/building/building-skills#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.clarityq.ai/context-layer/building/building-skills#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Building the Context Layer\",\"item\":\"https://docs.clarityq.ai/context-layer/building/recommended-build-order\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Building Skills\",\"item\":\"https://docs.clarityq.ai/context-layer/building/building-skills\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.clarityq.ai/context-layer/building/building-skills#article\",\"headline\":\"Building Skills\",\"name\":\"Building Skills\",\"description\":\"How to create and edit custom skills through the Context Builder.\",\"url\":\"https://docs.clarityq.ai/context-layer/building/building-skills\",\"mainEntityOfPage\":{\"@id\":\"https://docs.clarityq.ai/context-layer/building/building-skills#webpage\"},\"dateModified\":\"2026-09-16T10:16:24.132Z\",\"publisher\":{\"@id\":\"https://docs.clarityq.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.clarityq.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ClarityQ Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ClarityQ Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/context-layer/building/building-skills.md","siteName":"ClarityQ Documentation","nav":{"global":null,"groups":[{"group":"Get Started","pages":[{"title":"What is ClarityQ?","href":"/get-started/what-is-clarityq"},{"title":"Connect Your Data Warehouse","href":"/get-started/connect-your-data-warehouse"},{"title":"Build Your Context Layer","href":"/get-started/build-your-context-layer"},{"title":"Your First Chat","href":"/get-started/your-first-chat"},{"title":"Best Practices","href":"/get-started/best-practices"}]},{"group":"Data Warehouse Connections","pages":[{"title":"BigQuery","href":"/data-warehouse/bigquery"},{"title":"Snowflake","href":"/data-warehouse/snowflake"},{"title":"Amazon Athena","href":"/data-warehouse/athena"},{"title":"Amazon Redshift","href":"/data-warehouse/redshift"},{"title":"PostgreSQL","href":"/data-warehouse/postgres"},{"title":"Databricks","href":"/data-warehouse/databricks"},{"title":"MaxCompute","href":"/data-warehouse/maxcompute"},{"title":"Trino","href":"/data-warehouse/trino"},{"title":"ClickHouse","href":"/data-warehouse/clickhouse"},{"title":"Azure SQL","href":"/data-warehouse/sqlserver"},{"title":"Signing In With Your Own Warehouse Account","sidebarTitle":"Signing In With Your Own Account","href":"/data-warehouse/signing-in-with-your-own-account"}]},{"group":"Context Layer","pages":[{"title":"What is the Context Layer?","href":"/context-layer/what-is-the-context-layer"},{"group":"Table Catalog","pages":[{"title":"What is the Table Catalog?","href":"/context-layer/table-catalog/what-is-the-table-catalog"},{"title":"Setting Up Your Table Catalog","href":"/context-layer/table-catalog/setting-up-your-table-catalog"},{"title":"Daily Discovery Jobs","href":"/context-layer/table-catalog/daily-discovery-jobs"}]},{"group":"Event Catalog","pages":[{"title":"What is the Event Catalog?","href":"/context-layer/event-catalog/what-is-the-event-catalog"},{"title":"Setting Up Your Event Catalog","href":"/context-layer/event-catalog/setting-up-your-event-catalog"},{"title":"Daily Discovery Jobs","href":"/context-layer/event-catalog/daily-discovery-jobs"},{"title":"Missing Description Wizard","href":"/context-layer/event-catalog/missing-description-wizard"},{"title":"Syncing Events to the Semantic Catalog","href":"/context-layer/event-catalog/syncing-events-to-the-semantic-catalog"}]},{"group":"Semantic Catalog","pages":[{"title":"What is the Semantic Catalog?","href":"/context-layer/semantic-catalog/what-is-the-semantic-catalog"},{"title":"Entities","href":"/context-layer/semantic-catalog/entities"},{"title":"Dimensions","href":"/context-layer/semantic-catalog/dimensions"},{"title":"Metrics","href":"/context-layer/semantic-catalog/metrics"},{"title":"Segments","href":"/context-layer/semantic-catalog/segments"},{"title":"Events","href":"/context-layer/semantic-catalog/events"}]},{"title":"Skills","href":"/context-layer/skills"},{"title":"Rules","href":"/context-layer/rules"},{"title":"Memory","href":"/context-layer/memory"},{"title":"Files","href":"/context-layer/files"}]},{"group":"Building the Context Layer","pages":[{"title":"Recommended Build Order","href":"/context-layer/building/recommended-build-order"},{"title":"How the Context Layer Builder works","href":"/context-layer/building/how-the-context-layer-builder-works"},{"title":"Building Entities from Tables","href":"/context-layer/building/building-entities-from-tables"},{"title":"Building Metrics","href":"/context-layer/building/building-metrics"},{"title":"Building Segments","description":"How to create and edit reusable user cohort definitions through the Context Builder.","href":"/context-layer/building/building-segments"},{"title":"Building Skills","href":"/context-layer/building/building-skills"},{"title":"Building Product Memory","description":"How to create, edit, and manage product-level memory entries through the Context Builder.","href":"/context-layer/building/building-memory"},{"title":"Context Layer Versioning","href":"/context-layer/building/context-layer-versioning"},{"title":"Inbox","href":"/context-layer/building/inbox"},{"title":"Building Events from the Event Catalog","href":"/context-layer/building/building-events-from-the-event-catalog"}]},{"group":"Ask Anything","pages":[{"title":"How Ask Anything Works","href":"/ask-anything/how-ask-anything-works"},{"title":"Asking Questions","href":"/ask-anything/asking-questions"},{"title":"Understanding Responses","href":"/ask-anything/understanding-responses"},{"title":"Diagnosing Answers","href":"/ask-anything/diagnosing-answers"},{"title":"Context Coverage","href":"/ask-anything/context-coverage"},{"title":"Sharing \u0026 Collaboration","href":"/ask-anything/sharing-and-collaboration"},{"title":"Unified Workspaces","href":"/ask-anything/unified-workspaces"},{"title":"Errors \u0026 Troubleshooting","href":"/ask-anything/errors-and-troubleshooting"}]},{"group":"Dashboards","pages":[{"title":"What are Dashboards?","href":"/dashboards/what-are-dashboards"},{"title":"Creating and Editing Dashboards","href":"/dashboards/creating-and-editing-dashboards"},{"title":"Asking About a Dashboard's Data","href":"/dashboards/asking-about-dashboard-data"},{"title":"Scheduling Dashboards","href":"/dashboards/scheduling-dashboards"},{"title":"Sharing and Managing Dashboards","href":"/dashboards/sharing-and-managing-dashboards"}]},{"group":"Automations","pages":[{"title":"What are Tasks?","href":"/automations/what-are-tasks"},{"title":"Creating \u0026 Scheduling Tasks","href":"/automations/creating-and-scheduling-tasks"},{"title":"Task Delivery \u0026 Notifications","href":"/automations/task-delivery-and-notifications"}]},{"group":"Integrations","pages":[{"group":"Embed","pages":[{"title":"Embedding ClarityQ","href":"/integrations/embed/embedding-clarityq"},{"openapi":"post /api/v1/products/{product_id}/embed/token","title":"Mint an embed token","href":"/integrations/embed/mint-embed-token"},{"openapi":"post /api/v1/products/{product_id}/conversations","title":"List conversations","href":"/integrations/embed/list-conversations"}]},{"group":"Slack","pages":[{"title":"Connecting Slack","href":"/integrations/slack/connecting-slack"},{"title":"Using ClarityQ in Slack","href":"/integrations/slack/using-clarityq-in-slack"}]},{"group":"MCP Connectors","pages":[{"title":"MCP Connectors","href":"/integrations/mcp/connecting-mcp-servers"},{"title":"Using Apps","href":"/integrations/mcp/using-mcp-servers"},{"title":"Connecting Atlassian (Jira)","href":"/integrations/mcp/connecting-atlassian"},{"title":"Connecting GitHub","href":"/integrations/mcp/connecting-github"}]},{"group":"ClarityQ MCP Server","pages":[{"title":"Connecting AI Assistants","href":"/integrations/clarityq-mcp-server/connecting-ai-assistants"},{"title":"Using ClarityQ from AI Assistants","href":"/integrations/clarityq-mcp-server/using-clarityq-from-ai-assistants"}]}]},{"group":"Administration","pages":[{"title":"Context Hub","href":"/admin/context-hub"},{"title":"User Management and Roles","href":"/admin/user-management-and-roles"},{"title":"Organization Settings","href":"/admin/organization-settings"},{"title":"Filters","href":"/admin/filters"},{"title":"Usage Dashboard","href":"/admin/usage-dashboard"},{"title":"Usage Limits and Top-Ups","href":"/admin/usage-limits-and-top-ups"},{"title":"Security and Compliance","href":"/admin/security-and-compliance"}]},{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/index"},{"openapi":"post /api/v1/products/{product_id}/ask","title":"Ask a question","href":"/api-reference/api/ask-a-question"},{"openapi":"get /api/v1/products/{product_id}/conversations/{conversation_id}/status","title":"Get conversation status","href":"/api-reference/api/get-conversation-status"},{"openapi":"get /api/v1/products/{product_id}/conversations/{conversation_id}/summary","title":"Get conversation summary","href":"/api-reference/api/get-conversation-summary"},{"title":"Submit Feedback","openapi":"put /api/v1/products/{product_id}/conversations/{conversation_id}/feedback","href":"/api-reference/api/submit-feedback"},{"openapi":"get /api/v1/products/{product_id}/tasks/{task_id}/last-run-summary","title":"Get last completed task run summary","href":"/api-reference/api/get-last-completed-task-run-summary"},{"title":"Get Prompt Usage","openapi":"get /api/v1/products/{product_id}/usage/prompts","href":"/api-reference/api/get-prompt-usage"},{"title":"Submit External Feedback","openapi":"post /api/v1/products/{product_id}/external-feedback","href":"/api-reference/api/submit-external-feedback"}]},{"group":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Building Skills - ClarityQ Documentation","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}