Skip to main content

AgentSkillIO

@a16njs/models

@a16njs/models / AgentSkillIO

Interface: AgentSkillIO

Defined in: types.ts:92

Full AgentSkills.io standard skill. Supports multiple resource files in the skill directory.

NOTE: Hooks are NOT part of AgentSkills.io and are not supported. Skills with hooks should be skipped during discovery with a warning.

Use this type for skills that include:

  • Resource files (checklists, configs, scripts)
  • Multiple files in a skill directory

Extends​

Properties​

id​

id: string

Defined in: types.ts:31

Unique identifier for this item

Inherited from​

AgentCustomization.id

version​

version: string

Defined in: types.ts:35

IR version (required, e.g., 'v1beta1')

Inherited from​

AgentCustomization.version

sourcePath?​

optional sourcePath?: string

Defined in: types.ts:37

Original file path where this was discovered (optional, omitted in IR format)

Inherited from​

AgentCustomization.sourcePath

relativeDir?​

optional relativeDir?: string

Defined in: types.ts:39

Relative directory path for preserving directory structure (optional)

Inherited from​

AgentCustomization.relativeDir

content​

content: string

Defined in: types.ts:41

The actual prompt/rule content

Inherited from​

AgentCustomization.content

metadata​

metadata: Record<string, unknown>

Defined in: types.ts:43

Tool-specific extras that don't fit the standard model (transient, not serialized in IR)

Inherited from​

AgentCustomization.metadata

type​

type: AgentSkillIO

Defined in: types.ts:93

The type of customization

Overrides​

AgentCustomization.type

name​

name: string

Defined in: types.ts:96

Skill name (from frontmatter or directory name)

description​

description: string

Defined in: types.ts:99

Description for activation matching (required)

resources?​

optional resources?: string[]

Defined in: types.ts:102

Optional: Resource file paths relative to skill directory

disableModelInvocation?​

optional disableModelInvocation?: boolean

Defined in: types.ts:105

Optional: If true, only invoked via /name

files​

files: Record<string, string>

Defined in: types.ts:111

Map of additional files in the skill directory. Key: relative path, Value: file content