Skip to main content

Skills

Skills are reusable capability bundles that agents can call during execution. They package instructions, scripts, and domain-specific logic so teams can scale behavior safely and consistently.

Skill Selection Per Agent

Each agent can be configured with its own skill set. This enables role-specific behavior:

  • Product agents with planning and roadmap skills.
  • Support agents with triage and troubleshooting skills.
  • Engineering agents with code, test, and deploy skills.

Agent-level skill selection keeps behavior focused and reduces accidental tool usage.

Custom Skills for Teams

Teams can create custom skills for internal workflows and share them across agents. Typical pattern:

  1. Author a custom skill with clear input and output contracts.
  2. Validate it in a sandbox or staging runtime.
  3. Publish it to your team catalog.
  4. Enable it in selected agent specs.
  5. Track usage and update versions over time.

This approach creates a shared capability layer instead of duplicating logic in prompts.

Why Skills Matter

  • Consistency: same operation style across multiple agents.
  • Governance: reviewable units instead of hidden prompt behavior.
  • Speed: faster onboarding by reusing proven automation blocks.
  • Safety: easier to audit and constrain compared to broad free-form actions.

Best Practices

  • Keep each skill narrowly scoped to one job.
  • Version skills and document compatibility expectations.
  • Combine with guardrails for sensitive actions.
  • Prefer composition of small skills over one large monolith.

Next Steps

See also