Skip to content

Graphorin API reference v0.1.0


Graphorin API reference / @graphorin/skills / registry / SkillRegistry

Interface: SkillRegistry

Defined in: packages/skills/src/registry/index.ts:51

Public registry surface.

Methods

activate()

ts
activate(triggers, signal?): Promise<readonly ActivatedSkill[]>;

Defined in: packages/skills/src/registry/index.ts:78

Parameters

ParameterType
triggersreadonly string[]
signal?AbortSignal

Returns

Promise&lt;readonly ActivatedSkill[]&gt;


clear()

ts
clear(): void;

Defined in: packages/skills/src/registry/index.ts:99

Returns

void


getAutoActivationMetadata()

ts
getAutoActivationMetadata(): readonly SkillMetadata[];

Defined in: packages/skills/src/registry/index.ts:62

Skills surfaced into the system prompt for auto-activation. Skills with disable-model-invocation: true are excluded.

Returns

readonly SkillMetadata[]


getMetadata()

ts
getMetadata(): readonly SkillMetadata[];

Defined in: packages/skills/src/registry/index.ts:57

Returns

readonly SkillMetadata[]


getMetadataBlock()

ts
getMetadataBlock(): string;

Defined in: packages/skills/src/registry/index.ts:69

Render the auto-activation metadata as a string suitable for the system prompt. The format is bytes-stable and consumed verbatim by the ContextEngine layered template (Phase 10d). Skills with disable-model-invocation: true are excluded.

Returns

string


getSkill()

ts
getSkill(name): Skill | undefined;

Defined in: packages/skills/src/registry/index.ts:54

Parameters

ParameterType
namestring

Returns

Skill | undefined


has()

ts
has(name): boolean;

Defined in: packages/skills/src/registry/index.ts:55

Parameters

ParameterType
namestring

Returns

boolean


list()

ts
list(): readonly Skill[];

Defined in: packages/skills/src/registry/index.ts:56

Returns

readonly Skill[]


register()

ts
register(skill): void;

Defined in: packages/skills/src/registry/index.ts:52

Parameters

ParameterType
skillSkill

Returns

void


resolveTrigger()

ts
resolveTrigger(trigger): 
  | ActivationRequest
  | null;

Defined in: packages/skills/src/registry/index.ts:77

Resolve a single trigger (model-emitted skill name OR the raw /skill:<name> slash-command body) into an ActivationRequest. Returns null when no skill matches and the trigger looked like a slash command — callers that want a strict mode should call parseActivationTrigger themselves.

Parameters

ParameterType
triggerstring

Returns

| ActivationRequest | null


ts
search(triggers): readonly Skill[];

Defined in: packages/skills/src/registry/index.ts:88

Best-effort match: returns every skill whose name OR description contains all of the supplied trigger tokens (case-insensitive). The agent runtime uses this when the model emits a trigger phrase that does not directly map to a skill name.

Parameters

ParameterType
triggersreadonly string[]

Returns

readonly Skill[]


size()

ts
size(): number;

Defined in: packages/skills/src/registry/index.ts:98

Returns

number


toolDeclarations()

ts
toolDeclarations(): readonly RegisteredToolDeclaration[];

Defined in: packages/skills/src/registry/index.ts:97

Returns

readonly RegisteredToolDeclaration[]


tools()

ts
tools(): readonly InlineSkillTool[];

Defined in: packages/skills/src/registry/index.ts:96

Flat, deduplicated list of every pre-built tool shipped by the registered skills. The first registration wins on a tool.name collision; later collisions surface a one-time WARN through the console so operators can resolve the conflict (Phase 12 will route these through the audit emitter).

Returns

readonly InlineSkillTool[]


unregister()

ts
unregister(name): boolean;

Defined in: packages/skills/src/registry/index.ts:53

Parameters

ParameterType
namestring

Returns

boolean