AI Skill

AI Skill

Certified

Provide skills to an AI agent

Exposes langchain4j skills as tools for an AI agent. Skills are structured instructions that the agent can activate on demand. Each skill has a name, description, and content that gets returned when the agent activates it. Skills can also include resources that the agent can read separately.

yaml
type: io.kestra.plugin.ai.tool.Skill

Use skills to provide structured instructions to an AI agent

yaml
id: agent_with_skills
namespace: company.ai

tasks:
  - id: agent
    type: io.kestra.plugin.ai.agent.AIAgent
    prompt: Translate the following text to French - "Hello, how are you today?"
    provider:
      type: io.kestra.plugin.ai.provider.GoogleGemini
      modelName: gemini-2.5-flash
      apiKey: "{{ secret('GEMINI_API_KEY') }}"
    tools:
      - type: io.kestra.plugin.ai.tool.Skill
        skills:
          - name: translation_expert
            description: Expert translator for multiple languages
            content: |
              You are an expert translator. When translating text:
              1. Preserve the original meaning and tone
              2. Use natural phrasing in the target language
              3. Keep proper nouns unchanged

Load skill content from Kestra internal storage

yaml
    id: agent_with_skill_from_storage
    namespace: company.ai

    tasks:
      - id: write_instructions
        type: io.kestra.plugin.core.storage.Write
        content: |
          You are a senior code reviewer. When reviewing code:
          1. Check for security vulnerabilities
          2. Ensure proper error handling
          3. Verify naming conventions are followed
          4. Flag any code duplication

      - id: agent
        type: io.kestra.plugin.ai.agent.AIAgent
        prompt: Review this Python function - "def add(a, b): return a + b"
        provider:
          type: io.kestra.plugin.ai.provider.GoogleGemini
          modelName: gemini-2.5-flash
          apiKey: "{{ secret('GEMINI_API_KEY') }}"
        tools:
          - type: io.kestra.plugin.ai.tool.Skill
            skills:
              - name: code_review_expert
                description: Expert code reviewer with strict guidelines
                contentUri: "{{ outputs.write_instructions.uri }}"
Properties

List of skill definitions

Each skill defines a set of structured instructions that the agent can activate. A skill must have a name, description, and either inline content or a content URI pointing to Kestra internal storage.

Definitions
description*Requiredstring

Description of the skill used by the LLM to decide when to activate it

name*Requiredstring

Name of the skill

contentstring

Inline content of the skill

Mutually exclusive with 'contentUri'. At least one of 'content' or 'contentUri' must be set.

contentUristring

URI to the skill content in Kestra internal storage

Mutually exclusive with 'content'. At least one of 'content' or 'contentUri' must be set.

resourcesarray

Additional resources attached to this skill

Resources the agent can read separately using the 'read_skill_resource' tool.

content*Requiredstring

Content of the resource

relativePath*Requiredstring

Relative path of the resource within the skill