# wendy-device-interop

This skill sets out how wendy-agent devices receive and verify changes from the SaaS stack. Use it when working on signed requests, device polling, or image delivery.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 62
- Author: wendylabsinc
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/wendylabsinc/claude-skills/tree/HEAD/wendy-device-interop/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/wendy-device-interop

## What it does

The skill guides changes to the way wendy-agent communicates with the cloud queue and decides whether to apply an update. A device checks the operator’s signature, request freshness, and device binding itself; the cloud cannot push a state-changing command. Verification and apply results are recorded with a `correlation_id` for audit tracing.

When SaaS cannot be reached, the agent keeps its current state. It rejects artifacts or signatures it cannot verify. The device uses its own mTLS certificate, and images are meant to pass through `wendy-proxy` rather than come directly from a registry. The proxy is planned, not live, so image delivery through it is not ready. The skill also requires the stack to retain a self-hosted path and points to `references/postbox-verification.md` and `references/image-pull.md`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add wendylabsinc/claude-skills --skill wendy-device-interop -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/wendy-device-interop/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/wendy-device-interop/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add wendylabsinc/claude-skills --skill wendy-device-interop -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/wendy-device-interop/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add wendylabsinc/claude-skills --skill wendy-device-interop -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/wendy-device-interop/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install wendylabsinc/claude-skills wendy-device-interop
```

2. **Manually: put the files in place**
- File: `.github/skills/wendy-device-interop/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add wendylabsinc/claude-skills --skill wendy-device-interop -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/wendylabsinc/claude-skills --path wendy-device-interop
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/wendy-device-interop/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add wendylabsinc/claude-skills --skill wendy-device-interop -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/wendylabsinc/claude-skills/tree/HEAD/wendy-device-interop/SKILL.md

## When to use it
- verify a change request before applying it
- design device polling for the cloud postbox
- handle stale checkpoints or SaaS outages
- define image delivery through `wendy-proxy`

## Example prompts
- Check whether our device polling follows `wendy-device-interop`.
- Explain how the device should validate a signed change request.
- What should the agent do when SaaS is unreachable or a checkpoint is stale?

## Similar
- [git-guardrails-claude-code](https://affpapa.org/en/nevibecode/skills/git-guardrails-claude-code.md) — skill · 499069 installs
- [ponytail-review](https://affpapa.org/en/nevibecode/skills/ponytail-review.md) — skill · 57000 installs
- [ponytail-audit](https://affpapa.org/en/nevibecode/skills/ponytail-audit.md) — skill · 45400 installs
- [security-audit](https://affpapa.org/en/nevibecode/skills/cloudflare-security-audit.md) — skill · 54800 installs
- [security-and-hardening](https://affpapa.org/en/nevibecode/skills/security-and-hardening.md) — skill · 70200 installs
- [supabase](https://affpapa.org/en/nevibecode/skills/supabase.md) — skill · 8 installs

From the same set: [wendylabsinc/claude-skills](https://affpapa.org/en/nevibecode/by/wendylabsinc/claude-skills.md) — 25 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md