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

Examples

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-3.5-flash-lite
      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-3.5-flash-lite
      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

skills *array

Skill definitions

Structured instruction sets the agent can activate on demand. Each skill needs a name, a description, and either inline content or a contentUri pointing to Kestra internal storage. No default: this property is required.

Definitions

A skill definition

description*string

Skill description

Natural-language summary of what the skill does, used by the LLM to decide when to activate it. No default: this property is required.

name*string

Skill name

Identifier the LLM uses to activate the skill. No default: this property is required.

contentstring

Inline skill content

Instructions making up the skill, written inline. Mutually exclusive with contentUri; exactly one of the two must be set.

contentUristring

Skill content URI

Kestra internal storage URI of a file holding the skill instructions. Mutually exclusive with content; exactly one of the two must be set.

resourcesarray

Skill resources

Extra files attached to the skill, which the agent reads on demand through the read_skill_resource tool rather than receiving them upfront. Not set by default.

A skill resource definition

content*string

Resource content

Body of the resource file, returned verbatim when the agent reads it. No default: this property is required.

relativePath*string

Resource relative path

Path identifying the resource within the skill, as the agent refers to it when reading the file. No default: this property is required.

Huggingface

Tasks that call Hugging Face Inference APIs.

Gemini

Tasks that call Google Gemini models for text, chat, structured outputs, multimodal prompts, and video generation.

AI SkillCertifiedProvide skills to an AI agent

More Plugins in this Category

Huggingface

Gemini

AI Skill
Certified
Provide skills to an AI agent