Skip to main content

SkillSpec

Agent Runtimes

Agent Runtimes / types/skills / SkillSpec

Interface: SkillSpec

Defined in: types/skills.ts:42

Specification for a skill.

Supports three variants:

  • Variant 1 (name-based): Uses module to discover and load a skill from a Python module path (e.g. agent_skills.events).
  • Variant 2 (package-based): Uses package and method to reference a callable in an installable Python package. Attributes such as license, compatibility, allowedTools, and skillMetadata are discovered at runtime from the SKILL.md packaged inside the Python package — they should NOT be duplicated in the YAML spec.
  • Variant 3 (path-based): Uses path to load a local skill directory containing SKILL.md (relative to the configured skills folder).

Properties​

allowedTools?​

optional allowedTools?: string[]

Defined in: types/skills.ts:64

Pre-approved tools the skill may use (agentskills.io spec)

compatibility?​

optional compatibility?: string

Defined in: types/skills.ts:62

Environment requirements (agentskills.io spec)

dependencies?​

optional dependencies?: string[]

Defined in: types/skills.ts:72

Python package dependencies

description​

description: string

Defined in: types/skills.ts:50

Skill description

emoji?​

optional emoji?: string

Defined in: types/skills.ts:78

Emoji identifier

enabled​

enabled: boolean

Defined in: types/skills.ts:80

Whether the skill is enabled

icon?​

optional icon?: string

Defined in: types/skills.ts:76

Icon identifier

id​

id: string

Defined in: types/skills.ts:44

Unique skill identifier

license?​

optional license?: string

Defined in: types/skills.ts:60

License name or reference (agentskills.io spec)

method?​

optional method?: string

Defined in: types/skills.ts:56

Callable/function name in the package (variant 2)

module?​

optional module?: string

Defined in: types/skills.ts:52

Python module path for name-based discovery (variant 1)

name​

name: string

Defined in: types/skills.ts:48

Display name for the skill

optionalEnvVars?​

optional optionalEnvVars?: string[]

Defined in: types/skills.ts:70

Optional environment variables

package?​

optional package?: string

Defined in: types/skills.ts:54

Python package containing the skill implementation (variant 2)

path?​

optional path?: string

Defined in: types/skills.ts:58

Path to a local skill directory or SKILL.md file (variant 3)

requiredEnvVars​

requiredEnvVars: string[]

Defined in: types/skills.ts:68

Environment variables required by this skill

skillMetadata?​

optional skillMetadata?: Record<string, string>

Defined in: types/skills.ts:66

Arbitrary key-value metadata (agentskills.io spec)

tags​

tags: string[]

Defined in: types/skills.ts:74

Tags for categorization

version​

version: string

Defined in: types/skills.ts:46

Skill version