Skill Development

Skills are reusable agent capability units in Brazosd. A skill usually describes the business knowledge, operating steps, tool usage rules, and risk boundaries for a class of tasks. Users can link skills to agents so the agent can load the matching skill content when handling a relevant task.

Skills are useful for preserving expert knowledge inside an organization. Instead of putting every rule into an agent prompt, skills can be split by business topic, maintained independently, and reused across multiple agents.

How Skills Affect Agents

At runtime, an agent sees the list of linked skills, including each skill ID, name, and description. When a task matches a skill description, the agent can use the built-in read_skill tool to read the full skill body.

This mechanism reduces the amount of content in the default context. The agent does not need to load every skill body on every run. It can read the relevant content by skill ID only when needed.

Linking a skill changes how the agent behaves in later runs. Before adding a skill to an agent, confirm that the skill's scope, authorization boundaries, and tool usage rules match the agent's responsibilities.

Skill Content

A skill contains a name, description, and body.

The name should clearly describe the skill topic. The description should help the agent decide when it needs to read the skill. The body should define the concrete task flow, input and output conventions, tools that should be called, actions that require user confirmation, and business boundaries that must not be crossed.

The skill body should not contain only abstract principles. For enterprise-grade expert agents, it is more valuable to break business workflows into executable steps and explain what to do when exceptions, insufficient permissions, missing information, or external system failures occur.

System Skills And Organization Skills

Brazosd provides system skills that describe built-in platform capabilities and basic operating flows. System skills are managed by the Brazosd initializer, and users should not edit or delete them in the console.

Organizations can also create their own skills. Organization skills are suitable for internal processes, industry knowledge, customer project experience, and private tool usage rules. Organization skills can be linked to agents owned by the organization, including organization-owned system agents.

Editing Skills

Skills are edited directly. Changes apply to agents that link to the skill after their configuration is refreshed, so keep the skill's scope and behavior stable before using it in production agents.

Publishing And Reuse

Skills can be reused as internal organization assets. Before linking a skill broadly, avoid including information that only applies to one customer, one temporary project, or content that should not be exposed to every agent using the skill.

For capabilities that strongly depend on private enterprise data, keep them as organization-internal skills and combine them with the agent drive, cloud drive materials, and brazosd_ctrl to build business-focused expert agents.