Skip to content

Agent Skills

Agent skills are reusable capabilities exposed to AI agents, assistants, or automation workflows. A skill packages intent, input/output contract, execution logic, and documentation so agents can discover and call it safely.

Skill Design

Each skill should define:

  • purpose and boundaries;
  • input schema;
  • output schema;
  • failure modes;
  • authorization and data access requirements;
  • telemetry and audit expectations;
  • examples and tests.

ConnectSoft Guidance

  • Keep skills small and composable.
  • Prefer typed contracts over unstructured text.
  • Validate all inputs before invoking side effects.
  • Emit telemetry for execution time, failures, and downstream calls.
  • Do not expose privileged operations without explicit authorization checks.

Template Responsibilities

BaseTemplate should document the skill registration and discovery mechanism. Bot and AI-specific Layer 3 templates should document channel-specific skill exposure, domain skill catalogs, and generated examples.