Graphorin API reference v0.15.1
Graphorin API reference / @graphorin/skills / registry / SkillRegistry
Interface: SkillRegistry
Defined in: packages/skills/src/registry/index.ts:68
Public registry surface.
Methods
activate()
activate(triggers, signal?): Promise<readonly ActivatedSkill[]>;Defined in: packages/skills/src/registry/index.ts:101
Parameters
| Parameter | Type |
|---|---|
triggers | readonly string[] |
signal? | AbortSignal |
Returns
Promise<readonly ActivatedSkill[]>
clear()
clear(): void;Defined in: packages/skills/src/registry/index.ts:122
Returns
void
getAutoActivationMetadata()
getAutoActivationMetadata(): readonly SkillMetadata[];Defined in: packages/skills/src/registry/index.ts:85
Skills surfaced into the system prompt for auto-activation. Skills with disable-model-invocation: true are excluded.
Returns
readonly SkillMetadata[]
getMetadata()
getMetadata(): readonly SkillMetadata[];Defined in: packages/skills/src/registry/index.ts:80
Returns
readonly SkillMetadata[]
getMetadataBlock()
getMetadataBlock(): string;Defined in: packages/skills/src/registry/index.ts:92
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()
getSkill(name): Skill | undefined;Defined in: packages/skills/src/registry/index.ts:77
Parameters
| Parameter | Type |
|---|---|
name | string |
Returns
Skill | undefined
has()
has(name): boolean;Defined in: packages/skills/src/registry/index.ts:78
Parameters
| Parameter | Type |
|---|---|
name | string |
Returns
boolean
list()
list(): readonly Skill[];Defined in: packages/skills/src/registry/index.ts:79
Returns
readonly Skill[]
register()
register(skill): void;Defined in: packages/skills/src/registry/index.ts:69
Parameters
| Parameter | Type |
|---|---|
skill | Skill |
Returns
void
replace()
replace(skill): void;Defined in: packages/skills/src/registry/index.ts:75
Upsert a skill by name. Unlike SkillRegistry.register, replace overwrites an existing registration instead of throwing on a name collision - the upgrade path for hot-reloading a re-loaded skill.
Parameters
| Parameter | Type |
|---|---|
skill | Skill |
Returns
void
resolveTrigger()
resolveTrigger(trigger):
| ActivationRequest
| null;Defined in: packages/skills/src/registry/index.ts:100
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
| Parameter | Type |
|---|---|
trigger | string |
Returns
| ActivationRequest | null
search()
search(triggers): readonly Skill[];Defined in: packages/skills/src/registry/index.ts:111
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
| Parameter | Type |
|---|---|
triggers | readonly string[] |
Returns
readonly Skill[]
size()
size(): number;Defined in: packages/skills/src/registry/index.ts:121
Returns
number
toolDeclarations()
toolDeclarations(): readonly RegisteredToolDeclaration[];Defined in: packages/skills/src/registry/index.ts:120
Returns
readonly RegisteredToolDeclaration[]
tools()
tools(): readonly InlineSkillTool[];Defined in: packages/skills/src/registry/index.ts:119
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()
unregister(name): boolean;Defined in: packages/skills/src/registry/index.ts:76
Parameters
| Parameter | Type |
|---|---|
name | string |
Returns
boolean