# fraimz

Generates a step-by-step fraimz.html demo with voiceover and screenshots to prove app behavior over CDP.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 7523 repo stars
- Author: Devin-AXIS
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Devin-AXIS/iPolloWork/tree/HEAD/.opencode/skills/fraimz/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/fraimz

## What it does

fraimz drives the end-to-end verification loop for Electron apps. Instead of raw test logs, the runner outputs `fraimz.html` in `evals/results/<run-id>/`. Every frame pairs a user action with a claim, an assertion check, narration text, and a validated screenshot.

Each run enforces an approved script from `evals/voiceovers/<flow-id>.md`. Running `pnpm fraimz scaffold <flow-id>` builds the flow skeleton, and the executor fails whenever spoken narration drifts from the spec. App driving runs over Chrome DevTools Protocol target ports such as `:9826` or `:9825`.

A live Electron window or Daytona environment exposing CDP is mandatory for running visual flows.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Devin-AXIS/iPolloWork --skill fraimz -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Devin-AXIS/iPolloWork --skill fraimz -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Devin-AXIS/iPolloWork --skill fraimz -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Devin-AXIS/iPolloWork .opencode/skills/fraimz
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Devin-AXIS/iPolloWork --skill fraimz -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Devin-AXIS/iPolloWork --path .opencode/skills/fraimz
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/fraimz/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/Devin-AXIS/iPolloWork/tree/HEAD/.opencode/skills/fraimz/SKILL.md

## When to use it
- Generate an HTML proof artifact with screenshots for a PR
- Drive an Electron application through CDP assertions
- Keep UI test steps synchronized with an approved narration script

## Example prompts
- Run the core-flow evaluation against CDP on port 9826 and build fraimz.html
- Scaffold a new fraimz flow from the voiceover script
- Validate the latest UI changes and publish the fraimz verdict to the PR

## Similar
- [flow-next-drive](https://affpapa.org/en/nevibecode/skills/flow-next-drive.md) — skill · ★ 730 repo stars
- [playwright-typescript](https://affpapa.org/en/nevibecode/rules/playwright-typescript.md) — rule · ★ 41430 repo stars
- [selector-drift-recovery](https://affpapa.org/en/nevibecode/skills/selector-drift-recovery.md) — skill · 1300 installs
- [qa-game](https://affpapa.org/en/nevibecode/skills/qa-game.md) — skill · 1000 installs
- [playwright-cursor-rules](https://affpapa.org/en/nevibecode/skills/playwright-cursor-rules.md) — skill · 738 installs
- [cdp-ext-pilot](https://affpapa.org/en/nevibecode/skills/cdp-ext-pilot.md) — skill · 282 installs

From the same set: [devin-axis/ipollowork](https://affpapa.org/en/nevibecode/by/devin-axis/ipollowork.md) — 42 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
