SkillRegistry

SkillRegistry is a global singleton for registering, discovering, and instantiating skills by class reference. Skills can be registered programmatically by passing the class itself (the registry reads metadata from static class properties like SKILL_NAME), or auto-discovered from directories via the SIGNALWIRE_SKILL_PATHS environment variable.

1 import { SkillRegistry } from '@signalwire/sdk';

Methods

getInstance

Get the global singleton instance.

create

Create a skill instance from the registry.

has

Check if a skill name is registered.

unregister

Remove a skill registration.

lock

Lock skill names to prevent overwriting.

listRegistered

List all registered skill names.

addSearchPath

Add a directory for skill discovery.

getSearchPaths

Get all skill search paths.

discoverFromDirectory

Discover skills from a directory.

discoverAll

Discover skills from all search paths.

getSkillSchema

Get a skill’s parameter schema.

getAllSkillsSchema

Get schemas for all registered skills.

listAllSkillSources

List skills grouped by source.

clear

Remove all registrations.

getSkillClass

Look up a registered skill class by name.

listSkills

List all registered skills with full metadata.

resetInstance

Reset the global singleton (test helper).

Properties

size

number

The number of currently registered skills (getter).

Example

1 import { SkillRegistry, SkillBase } from '@signalwire/sdk';
2 
3 const registry = SkillRegistry.getInstance();
4 registry.register(MySkill); // class reference — name read from MySkill.SKILL_NAME
5 console.log(registry.listRegistered()); // ['my-skill', ...]
6 
7 // Create an instance from the registry
8 const skill = registry.create('my-skill', { apiKey: 'abc' });

1	import { SkillRegistry, SkillBase } from '@signalwire/sdk';
2
3	const registry = SkillRegistry.getInstance();
4	registry.register(MySkill); // class reference — name read from MySkill.SKILL_NAME
5	console.log(registry.listRegistered()); // ['my-skill', ...]
6
7	// Create an instance from the registry
8	const skill = registry.create('my-skill', { apiKey: 'abc' });