Skip to content
2 min read · 381 words

Interface: SkillDescriptor ​

Defined in: src/batteries/skills/types.ts:25

Live, source-owned definition resolved when a catalog entry is loaded.

Properties ​

PropertyModifierTypeDescriptionDefined in
artifactKind?readonlystringAdvisory default artifact kind; an explicit registry binding takes precedence.src/batteries/skills/types.ts:41
channel?readonlySkillLoadChannelPer-skill override of the manager's body projection channel.src/batteries/skills/types.ts:35
compatibility?readonlystringFree-form compatibility note surfaced to consumers, never enforced by the battery.src/batteries/skills/types.ts:58
descriptionreadonlystringResident routing text; the body remains unloaded until explicitly requested.src/batteries/skills/types.ts:31
idreadonlystringMust match the discovered ref; descriptors cannot rename a catalog entry.src/batteries/skills/types.ts:27
isolatedTools?readonlyreadonly SkillIsolatedTool[]Tier-2 source tools executed through the configured guest runtime.src/batteries/skills/types.ts:52
license?readonlystringagentskills.io license passthrough surfaced for audit.src/batteries/skills/types.ts:54
metadata?readonlyReadonly<Record<string, string>>Client-specific agentskills.io properties carried without interpretation.src/batteries/skills/types.ts:56
namereadonlystringDisplay name paired with the routing description.src/batteries/skills/types.ts:29
scripts?readonlyreadonly SkillScriptSpec[]Tier-3 scripts; their declared paths are materialized and their argv is battery-built.src/batteries/skills/types.ts:50
toolOutputs?readonlyReadonly<Record<string, SkillOutputKind>>Optional per-tool declaration of the output shape a module tool produces ('text', 'binary', 'media', or 'retrievable'). When set, a runtime return whose sniffed shape disagrees fails E_SKILL_TOOL_BAD_RESPONSE rather than being silently reinterpreted; when omitted, the wrapper sniffs the returned shape. Keyed by the tool's own name.src/batteries/skills/types.ts:48
tools?readonlyreadonly Tool<SpooledArtifact>[]First-party live tools to gate, rewrap, and register on load.src/batteries/skills/types.ts:39
trustTier?readonlyRetrievableTrustTierTrust envelope applied when the body is projected into context.src/batteries/skills/types.ts:37
versionreadonlystringVersion checked against discovery to prevent loading stale or mismatched data.src/batteries/skills/types.ts:33