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.