# fuyu-plugin

fuyu-plugin is a Claude Code skill that builds and tests plugins for the Fuyu Windows desktop island. Runs when editing fuyu-plugin.json or requesting Fuyu extensions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 503 repo stars
- Author: TixXin
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TixXin/Fuyu/tree/HEAD/packages/create-fuyu-plugin/ai/skill/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/fuyu-plugin

## What it does

The skill manages plugin development for the Fuyu desktop application on Windows. Extensions run as subprocesses exchanging JSON-RPC 2.0 lines across stdin and stdout. Fuyu renders all interface pages, status items, and notifications on its own, so the plugin emits only raw data. Writing arbitrary output to stdout disrupts the transport: developers must use `Write-FuyuLog` inside PowerShell or `plugin.log()` under Node.js.

Projects start via `npm create fuyu-plugin@latest`, utilizing either default Windows PowerShell 5.1 or TypeScript with Node.js. The skill guides the workflow through mock runs via `npx fuyu-plugin test`, live reloading via `npx fuyu-plugin dev`, manifest validation, and final archive generation inside `.package/<id>-<version>.zip`.

The host environment caps view models at 256 KB, list views at 500 items, and collapsed status indicators at 24 characters. Persistent plugin state must reside in the directory designated by `FUYU_PLUGIN_DATA_DIR`, because version updates replace the extension folder completely.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add TixXin/Fuyu --skill fuyu-plugin -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add TixXin/Fuyu --skill fuyu-plugin -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add TixXin/Fuyu --skill fuyu-plugin -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install TixXin/Fuyu packages/create-fuyu-plugin/ai/skill
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add TixXin/Fuyu --skill fuyu-plugin -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/TixXin/Fuyu --path packages/create-fuyu-plugin/ai/skill
```

### Windsurf (Devin Desktop)

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

### 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/TixXin/Fuyu/tree/HEAD/packages/create-fuyu-plugin/ai/skill/SKILL.md

## When to use it
- scaffold a Fuyu desktop plugin in PowerShell or TypeScript
- run mock tests across plugin commands and interface views
- audit and validate declared permissions in fuyu-plugin.json
- package and cryptographically sign releases for the Fuyu market

## Example prompts
- Create a new Fuyu status plugin using PowerShell
- Validate permissions in fuyu-plugin.json and pack the release
- Add mock tests for my Fuyu plugin views

## Similar
- [powershell-windows](https://affpapa.org/en/nevibecode/skills/powershell-windows.md) — skill · 169 installs
- [powershell-5.1-expert](https://affpapa.org/en/nevibecode/agents/voltagent-powershell-51-expert.md) — subagent · ★ 6505 repo stars
- [windows-ui-automation](https://affpapa.org/en/nevibecode/skills/windows-ui-automation.md) — skill · 1300 installs
- [windows-vm](https://affpapa.org/en/nevibecode/skills/windows-vm.md) — skill · 285 installs
- [DesktopManager Windows Verification](https://affpapa.org/en/nevibecode/mcp/desktopmanager-windows-verification.md) — MCP server · ★ 108 repo stars
- [bun-uia](https://affpapa.org/en/nevibecode/mcp/bun-uia.md) — MCP server · ★ 21 repo stars

---
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
