Skip to content

Skills

Skills provide the agent with specialized knowledge for specific topics. When a user asks a question related to a skill, the agent loads that skill to provide expert-level guidance with detailed examples and best practices.

The agent automatically discovers available skills at startup and proactively loads relevant skills based on user questions.

Custom Skills

Custom skills are markdown files you create and store in the Splunk app's skills directory. They allow you to extend the agent with domain-specific knowledge tailored to your organization's needs.

Skill File Format

Skills use markdown format with YAML frontmatter:

---
name: Index Optimization
description: Best practices for optimizing Splunk index performance
---

# Index Optimization Best Practices

Your skill content here...

Required frontmatter fields:

  • name: The skill's display name.
    Used by the agent to load the skill.

  • description: Brief description of what the skill covers.
    Used by the agent to decide when it should load the skill.

Creating Custom Skills

  1. Create a .md file in the app's skills/ directory: 

    $SPLUNK_HOME/etc/apps/lynx_ai_agent/skills/my-skill.md

  2. Add frontmatter with name and description fields.

  3. Write your content using markdown syntax.

Tip

Skills names are loaded on app startup. No Splunk restart or reload is required when editing existing skills, but a refresh of the browser tab might be necessary to load new skills.

Validation

Validate your skills using the lynt.sh script:

cd $SPLUNK_HOME/etc/apps/lynx_ai_agent
./bin/lynt.sh

The validator checks for:

  • Proper frontmatter structure
  • Required name and description fields
  • Correct markdown syntax

Built-in Skills

Coming soon!