Skip to main content

SimpleAgentSkill

@a16njs/models

@a16njs/models / SimpleAgentSkill

Interface: SimpleAgentSkill

Defined in: types.ts:104

A simple skill that is activated by description matching. Examples: Cursor rules with description but no globs, simple SKILL.md files

For full AgentSkills.io standard skills with resources and files, use AgentSkillIO instead.

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:48

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

This is not the AgentSkills.io metadata frontmatter field — that one is author-authored and must persist. See AgentSkillSpecFields.specMetadata.

Inherited from​

AgentCustomization.metadata

license?​

optional license?: string

Defined in: types.ts:61

License name or a reference to a bundled license file. Provenance only.

Inherited from​

AgentSkillSpecFields.license

compatibility?​

optional compatibility?: string

Defined in: types.ts:63

Environment requirements, e.g. Requires Python 3.14+ and uv. Documentation only.

Inherited from​

AgentSkillSpecFields.compatibility

specMetadata?​

optional specMetadata?: Record<string, string>

Defined in: types.ts:71

The AgentSkills.io spec's metadata field: author-authored client properties, persisted to disk under the key metadata.

Distinct from AgentCustomization.metadata, which is transient and is never serialized.

Inherited from​

AgentSkillSpecFields.specMetadata

allowedTools?​

optional allowedTools?: string

Defined in: types.ts:80

Space-separated list of pre-approved tools, preserved as the authored string (e.g. Bash(git:*) Bash(jq:*) Read) rather than split, because re-joining a parsed list invites normalization bugs.

Experimental in the spec, but the only one of these fields with enforcement semantics: dropping it makes the emitted skill more permissive than authored.

Inherited from​

AgentSkillSpecFields.allowedTools

type​

type: SimpleAgentSkill

Defined in: types.ts:105

The type of customization

Overrides​

AgentCustomization.type

name​

name: string

Defined in: types.ts:107

Invocation name — the directory name (or rule filename) used for slash-command invocation (e.g., "banana" for /banana). Required for skills to invoke properly.

description​

description: string

Defined in: types.ts:109

What triggers this skill