# Wallive Agent Skills

Agent skills for Wallive workflows.

## Skills

- `wallive-pet`: create, repair, validate, and package Wallive Dynamic Island Pet `.pet` packages.
- `wallive-backdrop-shader`: create and validate soft Wallive Dynamic Island ambient glow shader packages, including optional `renderQuality` tiers.
- `agent-plugin-authoring`: guide an agent through authoring valid Codex plugins.

## Install With The Skills CLI

The `skills` command is provided by the open agent skills CLI on npm. Wallive publishes this repository as a skill source, not as a replacement for that CLI.

Install all Wallive skills globally from the npm package:

```bash
npx skills add https://cdn.jsdelivr.net/npm/@wallive/agent-skills@latest --all -g -a codex -y
```

Install one skill:

```bash
npx skills add https://cdn.jsdelivr.net/npm/@wallive/agent-skills@latest --skill wallive-pet -g -a codex -y
```

List available skills without installing:

```bash
npx skills add https://cdn.jsdelivr.net/npm/@wallive/agent-skills@latest --list
```

The package also provides a helper installer for machines that do not use the `skills` CLI source flow:

```bash
npx -p @wallive/agent-skills wallive-skills install
```

## npm Package

This folder is packaged as `@wallive/agent-skills` so project users can pin it through npm and sync skills from `node_modules`:

```bash
npm install -D @wallive/agent-skills
npx skills experimental_sync -y -a codex
```

The npm package is released from `main` with a dedicated skills tag:

```bash
make release-skills VERSION=0.1.1 CONFIRM=y
```

The release script validates the generated `.well-known/agent-skills` index, checks the `wallive-pet` scripts, validates the bundled ambient glow shader example, packs `@wallive/agent-skills`, and then the `skills-vX.Y.Z` tag triggers npm publishing through GitHub Actions trusted publishing.

## Wallive Helper CLI

This package includes a helper binary for Wallive-specific local operations:

```bash
npm exec --package @wallive/agent-skills -- wallive-skills wallive-backdrop-shader validate --package ./shader-package.json
```

For local development from this repository:

```bash
node tools/wallive-skills/bin/skills.js install --target ~/.ai/skills
```