# SkillDefinition

[**PromptScript API**](https://getpromptscript.dev/api-reference/index.md)

***

# Interface: SkillDefinition

Defined in: [core/src/types/ast.ts:766](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L766)

Typed representation of a skill in the

## Skills

block.

Currently skills are stored as Record<string, Value> in ObjectContent.
This interface provides typed access for skill-specific properties.

## Properties

### agent?

> `optional` **agent?**: `string`

Defined in: [core/src/types/ast.ts:784](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L784)

Agent to use

***

### allowedTools?

> `optional` **allowedTools?**: `string`[]

Defined in: [core/src/types/ast.ts:778](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L778)

Allowed tools

***

### composedFrom?

> `optional` **composedFrom?**: [`ComposedPhase`](https://getpromptscript.dev/api-reference/core/src/interfaces/ComposedPhase/index.md)[]

Defined in: [core/src/types/ast.ts:796](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L796)

Metadata about composed phases (set by resolver, not by user)

***

### content?

> `optional` **content?**: `string` \| [`TextContent`](https://getpromptscript.dev/api-reference/core/src/interfaces/TextContent/index.md)

Defined in: [core/src/types/ast.ts:770](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L770)

Skill content/instructions

***

### context?

> `optional` **context?**: `string`

Defined in: [core/src/types/ast.ts:782](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L782)

Context mode

***

### description

> **description**: `string`

Defined in: [core/src/types/ast.ts:768](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L768)

Skill description (required)

***

### disableModelInvocation?

> `optional` **disableModelInvocation?**: `boolean`

Defined in: [core/src/types/ast.ts:780](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L780)

Disable model invocation

***

### examples?

> `optional` **examples?**: `Record`\<`string`, [`ExampleDefinition`](https://getpromptscript.dev/api-reference/core/src/interfaces/ExampleDefinition/index.md)\>

Defined in: [core/src/types/ast.ts:792](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L792)

Structured examples for few-shot prompting

***

### inputs?

> `optional` **inputs?**: `Record`\<`string`, [`SkillContractField`](https://getpromptscript.dev/api-reference/core/src/interfaces/SkillContractField/index.md)\>

Defined in: [core/src/types/ast.ts:788](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L788)

Runtime inputs the skill expects

***

### outputs?

> `optional` **outputs?**: `Record`\<`string`, [`SkillContractField`](https://getpromptscript.dev/api-reference/core/src/interfaces/SkillContractField/index.md)\>

Defined in: [core/src/types/ast.ts:790](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L790)

Outputs the skill produces

***

### params?

> `optional` **params?**: [`ParamDefinition`](https://getpromptscript.dev/api-reference/core/src/interfaces/ParamDefinition/index.md)[]

Defined in: [core/src/types/ast.ts:772](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L772)

Template parameters for parameterization

***

### references?

> `optional` **references?**: `string`[]

Defined in: [core/src/types/ast.ts:794](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L794)

Reference files attached to skill context (paths resolved by resolver)

***

### requires?

> `optional` **requires?**: `string`[]

Defined in: [core/src/types/ast.ts:786](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L786)

Skills that must exist for this skill to work

***

### trigger?

> `optional` **trigger?**: `string`

Defined in: [core/src/types/ast.ts:774](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L774)

Trigger phrases

***

### userInvocable?

> `optional` **userInvocable?**: `boolean`

Defined in: [core/src/types/ast.ts:776](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/core/src/types/ast.ts#L776)

Whether user can invoke directly