mismagent-realize-ui

Implements a UI block as a testable presenter plus a thin view with a mandatory render check.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/lucolucus/mismagent --skill mismagent-realize-ui-lucolucus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mismagent-realize-ui
Source: https://github.com/lucolucus/mismagent/tree/main/codex/skills/mismagent-realize-ui
Command: npx skills add https://github.com/lucolucus/mismagent --skill mismagent-realize-ui-lucolucus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unit tests and a compiling view prove UI logic but never prove the screen actually renders correctly — clipped containers, overflowing text, and invisible controls slip past green test suites. This Skill closes that gap when building a ui block in the mismAgent build flow. ## Core Features & Use Cases - Presenter/view split: Separates every screen decision into a plain, unit-testable state-holder/presenter while the view only renders observable state and forwards events. - Mandatory render-check: Requires either an automated smoke/screenshot test from the side's profile gate or a recorded run-the-app check via the run-app-smoke skill, with evidence stored in render-proof/<block-id>/. - Render checklist: Enforces explicit sizing, deliberate overflow handling, contrast/visibility, empty/error/loading state rendering, and observable-state recomposition. - Use Case: When the mismAgent worker loads a block with type = ui, this Skill drives TDD on the presenter from tests_nl, then verifies the screen renders correctly before reporting PUBLIC_API and the render-check result back to the worker. ## Quick Start Ask the mismAgent worker to build the ui block defined in your building-blocks manifest so it realizes the presenter and thin view and records the render-check proof.

Frequently Asked Questions about mismagent-realize-ui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make UI screen logic unit-testable?

Move every screen decision into a plain state-holder/presenter that holds the framework's native observable state, and keep the view as a thin layer that only renders presenter state and forwards events. The tests_nl cases then run as ordinary unit tests against the presenter.

Why do green unit tests not prove a screen renders correctly?

Presenter tests and compilation prove logic, not rendering — failures like clipped containers, overflowing text, and white-on-white controls stay invisible. This Skill requires a separate render-check: a gate UI smoke/screenshot test or a recorded run-the-app verification.

What does the render checklist for a UI block cover?

It covers explicit sizing of windows and containers, deliberate overflow handling for long text and lists, contrast and visibility of every control, actual rendering of empty/error/loading states, and recomposition wired through observable state.

When is a manual re-render trigger a code smell?

A hand-rolled tick or counter-bump to force re-rendering means state lives in the wrong place. The fix is moving that state into the presenter as observable state so events re-render through the framework's native mechanism.

What happens if the target platform has no UI test capability?

The render-check falls back to a recorded run-the-app verification using the run-app-smoke skill, which launches the side via its profile run command, walks the render checklist, and stores evidence in render-proof/<block-id>/. Presenter-green alone is never accepted as done.