Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Skill Matching Reference

Skill matching is based on crate predicates.

Atom forms

An atom is a crate name with an optional version requirement.

Examples:

  • serde
  • serde>=1.0
  • tokio^1.40
  • regex<2.0
  • serde=1.0
  • serde==1.0.219

Semantics:

  • bare crate name: any version
  • >=, <=, >, <, ^, ~: standard semver operators
  • =1.0: compatible-version matching, equivalent to ^1.0
  • ==1.0.219: exact-version matching

Usage in matching fields

The crates field in both SKILL.md frontmatter and plugin [[skills]] groups accepts simple atom lists.

In TOML plugin manifests, crates accepts a string or array:

  • crates = "serde"
  • crates = ["serde", "tokio>=1.40"]

In SKILL.md frontmatter, crates uses comma-separated values:

  • crates: serde
  • crates: serde, tokio>=1.40