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.

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.

addSkillDirectory

getExternalPaths

Get registered external skill directories.

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

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