Platform tools Agent Plugin

This repository packages portable Agent Skills for safe, CLI-first Akua onboarding and first-app delivery. It follows the Agent Plugins 1.0.0 Working Draft with root plugin.json, optional root mcp.json, and immediate child skills under skills/.

The portable components are:

• skills/akua: CLI discovery, device login, explicit workspace context, public-contract lookup, approval boundaries, idempotency, and Operation completion.
• skills/first-app: no-infrastructure, existing-cluster, managed-worker, BYOM, direct-install, and SSH/bootstrap decisions.
• mcp.json: optional platform-docs and platform Streamable HTTP connections. Clients own authorization discovery, interaction, and credential storage; this repository contains no credentials or authentication configuration.

Installation, enablement, updates, and client UI are client-managed and outside the portable Agent Plugins format. MCP is non-blocking: onboarding remains usable through the akua CLI if a client declines MCP, cannot authenticate, or needs a restart or new conversation.

Validate locally

Use the pinned Bun toolchain and committed scripts:

bun install --frozen-lockfile
bun run test
bun run validate
bun run typecheck
bun run build

Validation uses committed snapshots of the official 1.0.0 schemas and performs no runtime dependency or schema fetching. Their immutable upstream revisions and SHA-256 checksums are recorded in schemas/provenance.json and verified offline. The normative specification remains authoritative if it differs from a schema snapshot.

Specifications

• Agent Plugins specification
• Agent Plugins author guide
• Agent Skills specification

Repository-authored work is licensed under the MIT License. The vendored Agent Plugins schemas are Apache-2.0 material; see THIRD_PARTY_NOTICES.md and schemas/LICENSE-APACHE-2.0.txt.