<!--
SPDX-FileCopyrightText: (C) 2026 Intel Corporation
SPDX-License-Identifier: Apache-2.0
-->

# AI Agent Integration and Developer Experience

The Edge Node Infrastructure Blueprint ships a set of agent skills that let you run platform workflows through natural language, using GitHub Copilot or Claude Code. Instead of manually running scripts and commands, describe the outcome you want and the agent takes care of the rest.

## Available Skills

| Skill | What it does |
|---|---|
| `create-image` | Builds a host OS image using the Image Composer Tool or ISO based curation |
| `create-usb-installation-files` | Packages a complete bootable USB artifact (`usb-installation-files.tar.gz`), optionally running `create-image` first |
| `validate-platform-config` | Validates a provisioned edge node over SSH — checks k3s pod health, binary paths, cloud-init state, network/proxy settings, and device readiness (GPU VFs, NPU) |
| `tune-platform-power` | Applies a CPU and/or GPU power profile (`battery`, `balanced`, `performance`, `graphical`) on a provisioned node over SSH |
| `update-install-packages` | Updates Ubuntu package configuration and installs required packages on a provisioned system |

## How to Use Skills

Open GitHub Copilot Chat or Claude Code in the repository workspace and describe what you want in natural language. The agent matches your request to the appropriate skill, asks for any missing inputs, then runs the workflow. These skill have been verified by running them from the developer system and pointing to the provisioned target system whereever applicable.

Note that few skills like `validate-platform-config` and `tune-platform-power` run commands on the target system, hence it is expected that during configuration, a user has seeded a public key for passwordless access.

### Example Prompts

```text
Build an OS image for my Intel Core Ultra system.
```

```text
Create a bootable USB artifact using the ICT image at /path/to/image.raw.gz.
```

```text
Validate the provisioned node at 192.168.1.10 — check pods, drivers, proxy settings, and GPU VFs.
```

```text
Switch the node at 192.168.1.10 to the balanced power profile.
```

```text
Add sysbench and stress-ng to ict-template only for a debug image variant.
```

### What the Agent Does

For every skill invocation the agent follows this fixed sequence:

1. **Collects required inputs** — prompts for anything not provided in the request
2. **Runs preconditions** — verifies the environment is ready before making any changes
3. **Executes steps** — runs the workflow, pausing for confirmation before any privileged or destructive action
4. **Validates results** — confirms the expected artifacts or system state are present
5. **Reports outcome** — returns artifact paths, validation status, and troubleshooting notes on failure

> **Note:** The agent will never proceed past a failed precondition or skip the validation step.

## Providing Required Inputs

Each skill declares specific required inputs. If you omit them, the agent will ask before proceeding. Common inputs include:

| Input | Used by |
|---|---|
| Image template path (`.yml`) | `create-image` |
| ICT image path (`.raw.gz`) | `create-usb-installation-files` |
| Target node SSH address and credentials | `validate-platform-config`, `tune-platform-power`, `update-install-packages` |
| Power profile (`battery` / `balanced` / `performance` / `graphical`) | `tune-platform-power` |
| Target (`cpu` / `gpu` / `both`) | `tune-platform-power` |