> ## 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",
    "private": "lockKey.svg",
    "shared": "people.svg",
    "expand": "caretDown.svg",
    "previous": "caretLeft.svg",
    "next": "caretRight.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 particular 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**
* Enter forward slash (`/`) in a Canvas chat and select <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** in the top right.

<Steps titleSize="h3">
  <Step title="Give your skill a name" id="creating-skills-1">
    * 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-2">
    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-3">
    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**
* Enter a forward slash (`/`) in the chat and select <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.

## Built-in skills

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

* `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.