Skip to content

Agent Skills

Give your agents domain expertise with markdown-based knowledge documents that inject into their prompts at task time.

Overview

Skills are knowledge documents that you assign to agents. When an agent receives a task, its active skills are injected into the prompt, giving it specialized knowledge without bloating the system prompt. Think of skills as "reference manuals" your agents can access.

How Skills Work

  1. Create a skill — write a markdown document with the knowledge you want the agent to have
  2. Assign to agents — attach the skill to one or more agents
  3. Set activation mode — choose when the skill activates
  4. Agent executes — at task dispatch time, active skills are injected into the agent's prompt

Activation Modes

ModeWhen Active
Always ActiveInjected into every task the agent handles
Board-SpecificOnly active for tasks on a specific board
Tag-SpecificOnly active when the task has a matching tag

Creating Skills

Write your skill content in markdown. Skills can include:

  • Instructions and guidelines
  • Reference data and specifications
  • Templates and formats
  • Best practices and rules
  • File attachments for additional context

Installing from Marketplace

You can also install pre-built skills from the Marketplace and assign them to your agents.

Use Cases

  1. Brand guidelines — create a skill with your tone of voice, visual standards, and messaging framework, then assign it to all marketing agents
  2. Code standards — write a skill with your team's coding conventions, PR review checklist, and architecture guidelines for dev agents
  3. Product knowledge — compile FAQs, feature descriptions, and troubleshooting guides into a skill for your customer support agent

Tips

  • Keep skills focused on one topic — it's better to have multiple targeted skills than one massive document
  • Use tag-specific activation to load heavy reference material only when relevant
  • Review which skills are assigned to each agent periodically — outdated skills can confuse agents
  • Attach files to skills when agents need access to documents, spreadsheets, or other resources

Built by HelixNode