Skip to content

skill-agent ​

When skill context is "fork", agent field is required to specify which agent to use

Error

Rule Details ​

When a skill sets context: fork, it runs in a separate agent process. The agent field must be specified to tell the system which agent to use for the forked context. Without this field, the system cannot determine which agent should handle the skill execution. This rule performs cross-field validation between context and agent to catch this misconfiguration.

Incorrect ​

Fork context without agent field

yaml
---
name: deploy
description: Deploys the app to production
context: fork
---

Correct ​

Fork context with agent specified

yaml
---
name: deploy
description: Deploys the app to production
context: fork
agent: deploy-agent
---

No context field does not require agent

yaml
---
name: lint
description: Runs linting on the project
---

How To Fix ​

Add an agent field to your SKILL.md frontmatter specifying which agent to use. If you do not need a separate agent process, remove the context field entirely.

Options ​

This rule does not have any configuration options.

Resources ​

Version ​

Available since: v0.2.0