Annotation Interface SkillSpec


@Documented @Retention(RUNTIME) @Target(TYPE) public @interface SkillSpec
Marks a class as a skill with metadata for routing and discovery.

Usage


 @SkillSpec(
     name = "weather",
     description = "Check weather for any location",
     triggers = {"weather", "forecast", "temperature"}
 )
 public class WeatherSkill implements Skill { }
 
Since:
0.3.0
  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    Unique skill name (lowercase).
  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    Human-readable description used for skill selection by the router.
    int
    Priority for skill selection when multiple skills match.
    boolean
    Whether this skill requires an active agent session.
    Keywords that trigger this skill during natural language routing.
  • Element Details

    • name

      String name
      Unique skill name (lowercase).
      Returns:
      skill name
    • description

      String description
      Human-readable description used for skill selection by the router.
      Returns:
      description
      Default:
      ""
    • triggers

      String[] triggers
      Keywords that trigger this skill during natural language routing.
      Returns:
      trigger keywords
      Default:
      {}
    • priority

      int priority
      Priority for skill selection when multiple skills match. Higher values take precedence.
      Returns:
      priority (default: 0)
      Default:
      0
    • requiresSession

      boolean requiresSession
      Whether this skill requires an active agent session.
      Returns:
      true if session required (default: true)
      Default:
      true