Skills

AI-Powered Automation Skills

Skills are AI-driven automation units that define how Akmatori investigates and responds to incidents. Each skill contains instructions, context, and tool configurations.

What is a Skill?

A skill is defined by a SKILL.md file that contains YAML frontmatter with metadata and markdown content with instructions for the AI agent. Skills can be triggered manually or automatically when alerts match certain criteria.

Skills follow the open Agent Skills specification, making them portable across compatible AI platforms.

SKILL.md Format

Here's an example skill definition:

SKILL.md

---
name: investigate-high-cpu
description: Investigate and diagnose high CPU usage alerts
version: 1.0.0
tools:
  - ssh-production
  - zabbix-api
---

# Investigation Instructions

When receiving a high CPU alert, follow these steps:

1. SSH into the affected server using the provided credentials
2. Run `top -bn1 | head -20` to identify processes
3. Check for memory pressure with `free -h`
4. Review recent deployments or changes
5. Summarize findings and recommend next steps

## Expected Output

Provide a structured report with:
- Root cause analysis
- Affected services
- Recommended remediation steps

Skill Properties

nameRequired

Unique identifier for the skill

descriptionRequired

Brief description of what the skill does

versionOptional

Semantic version number (default: 1.0.0)

toolsOptional

List of tool IDs that this skill can use

Best Practices

Be Specific

Write clear, specific instructions for the AI agent. Avoid ambiguity.

Add Context Files

Upload runbooks and documentation as context files for better analysis.

Test Thoroughly

Run skills manually before enabling automatic triggers.