Skip to main content

Class: SkillRegistry

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:55

Skill Registry for managing loaded skills at runtime.

Constructors​

Constructor​

new SkillRegistry(config?): SkillRegistry

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:60

Parameters​

config?​

SkillsConfig

Returns​

SkillRegistry

Accessors​

size​

Get Signature​

get size(): number

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:143

Get the count of registered skills.

Returns​

number

Methods​

buildCommandSpecs()​

buildCommandSpecs(options?): SkillCommandSpec[]

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:347

Build command specifications for all skills.

Parameters​

options?​
eligibility?​

SkillEligibilityContext

platform?​

string

reservedNames?​

Set<string>

Returns​

SkillCommandSpec[]


buildPrompt()​

buildPrompt(entries): string

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:322

Format skills into a prompt for LLM context.

Parameters​

entries​

SkillEntry[]

Returns​

string


buildSnapshot()​

buildSnapshot(options?): SkillSnapshot

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:262

Build a skill snapshot for agent context.

Parameters​

options?​
eligibility?​

SkillEligibilityContext

filter?​

string[]

platform?​

string

runtimeConfig?​

Record<string, unknown>

Optional config object used to evaluate requires.config paths.

strict?​

boolean

If true, apply OpenClaw-style eligibility gating (OS/bins/anyBins/env/config). This is useful for "only show runnable skills" behavior.

Returns​

SkillSnapshot


checkAllRequirements()​

checkAllRequirements(hasBin): Map<string, { met: boolean; missing: string[]; }>

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:388

Check requirements for all registered skills.

Parameters​

hasBin​

(bin) => boolean

Returns​

Map<string, { met: boolean; missing: string[]; }>


clear()​

clear(): void

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:117

Clear all registered skills.

Returns​

void


filterByEligibility()​

filterByEligibility(context): SkillEntry[]

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:237

Get skills filtered by eligibility context.

Parameters​

context​

SkillEligibilityContext

Returns​

SkillEntry[]


filterByPlatform()​

filterByPlatform(platform): SkillEntry[]

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:230

Get skills filtered by platform.

Parameters​

platform​

string

Returns​

SkillEntry[]


getByName()​

getByName(name): SkillEntry | undefined

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:129

Get a skill by name.

Parameters​

name​

string

Returns​

SkillEntry | undefined


getModelInvocableSkills()​

getModelInvocableSkills(): SkillEntry[]

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:251

Get skills that can be invoked by the model.

Returns​

SkillEntry[]


getSkillsWithMissingRequirements()​

getSkillsWithMissingRequirements(hasBin): object[]

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:401

Get skills with unmet requirements.

Parameters​

hasBin​

(bin) => boolean

Returns​

object[]


getUserInvocableSkills()​

getUserInvocableSkills(): SkillEntry[]

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:244

Get skills that can be invoked by users.

Returns​

SkillEntry[]


has()​

has(name): boolean

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:150

Check if a skill is registered.

Parameters​

name​

string

Returns​

boolean


listAll()​

listAll(): SkillEntry[]

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:136

List all registered skills.

Returns​

SkillEntry[]


loadFromDir()​

loadFromDir(dir, options?): Promise<number>

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:174

Load skills from a single directory, optionally tagging the source.

Parameters​

dir​

string

options?​
source?​

string

Returns​

Promise<number>


loadFromDirs()​

loadFromDirs(dirs): Promise<number>

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:161

Load skills from one or more directories.

Parameters​

dirs​

string[]

Returns​

Promise<number>


register()​

register(entry): boolean

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:73

Register a skill entry.

Parameters​

entry​

SkillEntry

Returns​

boolean

Whether the skill was registered (false if already exists)


reload()​

reload(options): Promise<number>

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:191

Reload all skills from configured directories.

Parameters​

options​

SkillRegistryOptions

Returns​

Promise<number>


unregister()​

unregister(name): boolean

Defined in: packages/agentos/src/cognition/skills/SkillRegistry.ts:106

Unregister a skill by name.

Parameters​

name​

string

Returns​

boolean