SkillManager

SkillManager handles loading, unloading, validation, and aggregation of skill tools, hints, global data, and prompt sections. You rarely interact with SkillManager directly — AgentBase delegates to it internally. Import it when you need direct control over skill lifecycle outside an agent.

import { SkillManager } from '@signalwire/sdk';

Most users should use AgentBase.addSkill(), AgentBase.removeSkill(), and AgentBase.listSkills() instead of interacting with SkillManager directly.

Properties

size

number

The number of currently loaded skill instances (getter).

Methods

addSkill

Add and initialize a skill instance (fails closed).

loadSkill

Instantiate a skill class and add it; returns [ok, error].

loadSkillByName

Look up a skill by name in the global registry and add it.

removeSkill

Remove a skill by key or ID.

removeSkillByName

Remove all instances of a named skill.

hasSkill

Check if any skill with the given name is loaded.

hasSkillByKey

Check if a skill with the given instance key is loaded.

listSkillKeys

List instance keys of all loaded skills.

getSkill

Get a skill instance by key or ID.

listSkills

List all loaded skill instances.

getAllTools

Aggregate tool definitions from all skills.

getAllPromptSections

Aggregate prompt sections from all skills.

getAllHints

Aggregate speech recognition hints.

getMergedGlobalData

Merge global data from all skills.

getLoadedSkillEntries

Get metadata for all loaded skills.

clear

Remove all skills.

loadedSkills

Read-only map of loaded skill instances (getter).

Example

import { SkillManager, DateTimeSkill, MathSkill } from '@signalwire/sdk';
const manager = new SkillManager();
await manager.addSkill(new DateTimeSkill());
await manager.addSkill(new MathSkill());
console.log(`${manager.size} skills loaded`);
console.log(manager.listSkills());