addSkill

Load and activate a skill on this agent. Skills are pluggable capability modules that register their own tools, prompts, hints, and global data. The addSkill() method takes a SkillBase instance (not a string name).

This is an async method that returns Promise<this>. Use await when calling.

addSkill() fails closed: it throws if a duplicate non-multi-instance skill is added, if required environment variables or packages are missing, if the skill’s parameter schema is empty, or if the skill’s setup() returns false. The method also registers any DataMap-style tools the skill exposes via getDataMapTools().

Check available skills with listSkills() or consult the skills catalog.

Parameters

skill

SkillBaseRequired

A skill instance to add to the agent. Skills extend SkillBase and provide tools, prompt sections, hints, and global data.

Returns

Promise<this> — Returns this for method chaining (async).

Example

1 import { AgentBase, DateTimeSkill, MathSkill } from '@signalwire/sdk';
2 
3 const agent = new AgentBase({ name: 'assistant', route: '/assistant' });
4 agent.setPromptText('You are a helpful assistant.');
5 await agent.addSkill(new DateTimeSkill());
6 await agent.addSkill(new MathSkill());
7 await agent.serve();

1	import { AgentBase, DateTimeSkill, MathSkill } from '@signalwire/sdk';
2
3	const agent = new AgentBase({ name: 'assistant', route: '/assistant' });
4	agent.setPromptText('You are a helpful assistant.');
5	await agent.addSkill(new DateTimeSkill());
6	await agent.addSkill(new MathSkill());
7	await agent.serve();