> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Canvas Skills

> Extend what Canvas can do or what Canvas knows with skills.

export const HnyIcon = ({alias, path, size = 16, iconColor}) => {
  const iconMap = {
    "home": "house.svg",
    "marker": "caretFilledDown.svg",
    "show-marker-options": "chatTextLeft.svg",
    "download": "arrowLineDown.svg",
    "trace-waterfall": "trace.svg",
    "show-query-details": "listDashes.svg",
    "table": "table.svg",
    "log-lines": "logLines.svg",
    "chart": "chartLine.svg",
    "show-settings": "gear.svg",
    "add": "plus.svg",
    "remove": "delete.svg",
    "persist": "caretDown.svg",
    "close": "close.svg",
    "copy": "copy.svg",
    "zoom-in": "magnifyingGlassPlus.svg",
    "zoom-out": "magnifyingGlassMinus.svg",
    "color-assignment": "drop.svg",
    "drag": "dots-six-vertical.svg",
    "drawer": "drawer.svg",
    "show-actions": "dotsThree.svg",
    "edit": "pencil.svg",
    "delete": "trash.svg",
    "move": "arrowsOutCardinal.svg",
    "show-legend": "circleInfo.svg",
    "usage-ok": "usageGood.svg",
    "usage-warning": "usageWarning.svg",
    "usage-danger": "usageDanger.svg",
    "open-query-builder": "query.svg",
    "home-menu": "house.svg",
    "query-menu": "query.svg",
    "boards-menu": "board.svg",
    "triggers-menu": "bell.svg",
    "slos-menu": "handshake.svg",
    "service-map-menu": "serviceMap.svg",
    "history-menu": "clockCounterClockwise.svg",
    "manage-data-menu": "cube.svg",
    "usage-menu": "usageGood.svg",
    "canvas-menu": "sparkle.svg",
    "anomalies-menu": "anomalies.svg",
    "show-details": "dotsThreeVertical.svg",
    "resize-handle": "board-panel-resize-handle.png",
    "standard-dataset": "cube.svg",
    "trace-dataset": "cubeChat.svg",
    "all-datasets": "linkedSquares.svg",
    "share": "arrowBentRight.svg",
    "run-in-query-builder": "arrowSquareUpRight.svg",
    "link": "link.svg",
    "text": "text.svg",
    "receive": "arrowLineDown.svg",
    "process": "lightning.svg",
    "sample": "drop.svg",
    "send": "arrowLineUp.svg",
    "submit": "arrowUp.svg",
    "canvas-menu": "sparkle.svg",
    "canvas": "sparkle.svg",
    "chat-about-this-page": "sparkle.svg",
    "private": "lockKey.svg",
    "shared": "people.svg",
    "expand": "caretDown.svg",
    "previous": "caretLeft.svg",
    "next": "caretRight.svg",
    "expand-chat": "caretLeft.svg",
    "minimize-chat": "caretRight.svg",
    "open-in-canvas": "arrowSquareUpRight.svg",
    "send-test": "EnvelopeSimple.svg"
  };
  const iconBasePath = "/_assets/icons/";
  const iconPath = path || (alias ? `${iconBasePath}${iconMap[alias]}` : undefined);
  return <span className="hny-icon" style={{
    display: "inline-block",
    width: `${size}px`,
    height: `${size}px`,
    maskImage: `url(${iconPath})`,
    maskSize: "contain",
    maskRepeat: "no-repeat",
    maskPosition: "center",
    WebkitMaskImage: `url(${iconPath})`,
    WebkitMaskSize: "contain",
    WebkitMaskRepeat: "no-repeat",
    WebkitMaskPosition: "center",
    backgroundColor: iconColor || "var(--hny-icon-color)",
    verticalAlign: "middle"
  }} />;
};

Use skills to add instructions or context to your Canvas investigations.
Skills help Canvas remember important details about your applications, your team, or preferred ways of working.

Create a new skill whenever you find yourself repeating the same steps in a Canvas investigation or want to share a multi-step investigation workflow with your team.
Canvas skills follow the [Agent Skills standard](https://agentskills.io/home).

Canvas only uses skills during relevant investigations or you can invoke skills<br /> by typing `/skill-name` in the chat.

You can access your team's Canvas skills in two ways:

* Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Skills and Knowledge**
* In a Canvas chat, select the <HnyIcon alias="add" /> plus (`+`) button then choose **Skills** > <HnyIcon alias="show-settings" /> **Manage Skills**

## Creating skills

To create a new skill, navigate to <HnyIcon alias="canvas" /> **Canvas** > **Skills and Knowledge** and select **New Skill**.

<Steps titleSize="h3">
  <Step title="Make a private skill or team skill" id="creating-skills-1">
    Use the **Keep private** toggle at the top to switch between creating a private/personal skill or a skill for your team.
  </Step>

  <Step title="Give your skill a name" id="creating-skills-2">
    * 1-64 characters
    * Can only use lowercase alphanumeric characters (`a-z`, `0-9`) and hyphens (`-`)
    * Cannot start or end with a hyphen (`-`)
  </Step>

  <Step title="Add a description" id="creating-skills-3">
    Describe what your skill does and when the Canvas agent should use it.

    You can include trigger phrases in your skill's description to help Canvas better understand when to run your skill.

    ```text theme={}
    Trigger phrases: "which users are getting rate limited",
    "debug errors at checkout","who is using my feature","traffic trends"
    ```
  </Step>

  <Step title="Add your instructions and context" id="creating-skills-4">
    Write instructions for the Canvas agent to follow when your skill activates.

    Skill content can be provided as plain text or Markdown.

    ```md theme={}
    # Investigate API Latency

    When this skill is activated:
    - Identify affected services
    - Check recent deploys
    - Compare current latency to baseline
    - Suggest likely root causes

    Be concise and focus on actionable insights.
    ```
  </Step>
</Steps>

## Editing and managing skills

You can access your team's Canvas skills in two ways:

* Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Skills and Knowledge**
* In a Canvas chat, select the <HnyIcon alias="add" /> plus (`+`) button then choose **Skills** > <HnyIcon alias="show-settings" /> **Manage Skills**

From the **Skills and Knowledge** page you can:

* Create a new skill by selecting **New Skill**.
* Edit skills using the edit <HnyIcon alias="edit" /> button.
* Delete skills using the delete <HnyIcon alias="delete" /> (trash can) button.

## Sharing skills with your team

To share personal skills with the rest of your team:

1. Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Skills and Knowledge**.
2. Under **Your Skills**, find the skill you want to share.
3. Select the <HnyIcon alias="show-actions" /> skill actions button.
4. Choose **Share with team** from the dropdown.
5. Select **Share with team** to confirm.

## Enabling and disabling skills

To enable or disable a skill in your own investigations:

1. Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Skills and Knowledge**.
2. Enable or disable skills using the toggle button for each skill.

## Enabling and disabling skills for your team

Team owners can enable or disable team skills and built-in skills for everyone on their team.
To enable or disable a skill for your team:

1. Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Skills and Knowledge**.
2. Find the team skill or built-in skill you want to enable/disable for your team.
3. Select the <HnyIcon alias="show-actions" /> skill actions button.
4. Choose **Disable for team**/**Enable for team** from the dropdown.

## Built-in skills

Canvas includes the following skills by default.
These skills cannot be removed or modified.

* `agent-instrumentation-audit`: Check an AI agent's telemetry coverage and flag instrumentation gaps.
* `conversation-investigation`: Debug AI sessions, conversations, or AI workflows captured via OpenTelemetry GenAI semantic conventions using Honeycomb's Agent Timeline.
* `metrics-queries`: How to query metrics datasets in Honeycomb.
* `observability-fundamentals`: Answers conceptual questions about observability and gives tool-agnostic guidance.
* `production-investigation`: Debug production issues using the core analysis loop and Honeycomb features.
* `query-patterns`: How to write effective Honeycomb queries.
* `slos-and-triggers`: How to design SLOs, when to use SLOs or triggers, and how to interpret an SLO status.
* `summarize`: Summarize a Canvas so you can quickly get up to speed.