Skip to main content

Overview

Skills can declare dependencies on other skills. The Skills system validates these at load time — detecting missing dependencies and circular references.

Declaring Dependencies

Add a dependencies list in your SKILL.md frontmatter:

Validation Behavior

Default Mode (Warnings)

By default, missing or circular dependencies produce warnings but don’t block loading:

Strict Mode (Errors)

Enable strict_deps=True to raise a SkillValidationError on dependency issues:

Circular Dependencies

The system uses DFS-based cycle detection. If skill A depends on B and B depends on A:
  • Default mode: Logs a warning with the cycle path
  • Strict mode: Raises SkillValidationError with cycle details

Inline Skills with Dependencies

Parameters