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 name, description, and canonical Cloud Drive directory of each installed skill. When a task matches a description, the agent reads that directory's SKILL.md entrypoint with the ordinary read tool before taking task-specific action, then loads linked files only as needed with read and ls.

This mechanism reduces the amount of content in the default context. The agent does not need to load every skill body on every run; skill files remain ordinary Cloud Drive files and are loaded progressively only when relevant.

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 is a directory whose entrypoint is SKILL.md. Its YAML front matter contains the name and description; the rest of the file contains its instructions. The directory may also contain linked references, scripts, templates, or assets.

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. They live under the organization's .skills Cloud Drive directory and can be installed into organization-owned agents as a read-only reference or an independent clone.

Editing Skills

Skills are managed with the same read, write, edit, ls, grep, find, copy, mkdir, delete, and tree operations as other files. Cloud Drive edits use compare-and-swap so a concurrent change produces a conflict instead of being silently overwritten. Changes to a referenced skill apply to agents using that reference; clones remain independent.

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's organization-drive directory, other cloud drive materials, and brazosd_ctrl to build business-focused expert agents.