gaia-research/gaia-skill-tree / .agents/skills/impeccable
impeccable
FlaggedUse when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
scripts/live/event-validation.mjs
View on GitHub/**
* Shared event validation for the live helper server.
* Extracted for unit testing (insert mode rules).
*/
import { canCreateInsert } from './insert-ui.mjs';
// The accepted visual action values come from the canonical vocabulary so the
// validator, the picker UI, and the marketing demo never drift. Imported (not
// just re-exported) so it is also in scope for the validators below.
import { VISUAL_ACTIONS } from './vocabulary.mjs';
export { VISUAL_ACTIONS };
const ID_PATTERN = /^[0-9a-f]{8}$/;
const VARIANT_ID_PATTERN = /^[0-9]{1,3}$/;
const INSERT_POSITIONS = new Set(['before', 'after']);
const FORBIDDEN_MANUAL_EDIT_TEXT_CHARS = ['<', '{', '}', '`'];
function isValidId(v) { return typeof v === 'string' && ID_PATTERN.test(v); }
function isValidVariantId(v) { return typeof v === 'string' && VARIANT_ID_PATTERN.test(v); }
function validateManualEditText(newText) {
if (typeof newText !== 'string') return null;
const hits = FORBIDDEN_MANUAL_EDIT_TEXT_CHARS.filter((char) => newText.includes(char));
return hits.length > 0 ? hits : null;
}
function validateAnnotationFields(msg) {
if (msg.screenshotPath !== undefined && typeof msg.screenshotPath !== 'string') {
return 'generate: screenshotPath must be string';
}
if (msg.comments !== undefined && !Array.isArray(msg.comments)) {
return 'generate: comments must be array';
}
if (msg.strokes !== undefined && !Array.isArray(msg.strokes)) {
return 'generate: strokes must be array';
}
return null;
}
function validateInsertGenerate(msg) {
if (!msg.insert || typeof msg.insert !== 'object') return 'generate: insert mode requires insert object';
if (!INSERT_POSITIONS.has(msg.insert.position)) return 'generate: insert.position must be before or after';
const anchor = msg.insert.anchor;
if (!anchor || typeof anchor !== 'object') return 'generate: insert.anchor required';
if (!anchor.tagName && !anchor.outerHTML && !(Array.isArray(anchor.classes) && anchor.classes.length)) {
return 'generate: insert.anchor needs tagName, classes, or outerHTML';
}
if (!msg.placeholder || typeof msg.placeholder !== 'object') return 'generate: insert mode requires placeholder dimensions';
if (!Number.isFinite(msg.placeholder.width) || !Number.isFinite(msg.placeholder.height)) {
return 'generate: placeholder width and height must be numbers';
}
if (!canCreateInsert({
prompt: msg.freeformPrompt,
comments: msg.comments,
strokes: msg.strokes,
})) {
return 'generate: insert requires freeformPrompt or annotations';
}
return validateAnnotationFields(msg);
}
function validateReplaceGenerate(msg) {
if (!msg.action || !VISUAL_ACTIONS.includes(msg.action)) return 'generate: invalid action';
if (!msg.element || !msg.element.outerHTML) return 'generate: missing element context';
return validateAnnotationFields(msg);
}
function validateManualEditEvent(msg, label) {
if (!isValidId(msg.id)) return label + ': missing or malformed id';
if (!msg.pageUrl || typeof msg.pageUrl !== 'string') return label + ': missing pageUrl';
if (!msg.element || typeof msg.element !== 'object') return label + ': missing element';
if (!Array.isArray(msg.ops) || msg.ops.length === 0) return label + ': ops must be non-empty array';
if (msg.ops.length > 100) return label + ': too many ops (max 100)';
for (const op of msg.ops) {
if (typeof op.ref !== 'string') return label + ': op.ref required';
if (typeof op.tag !== 'string') return label + ': op.tag required';
if (typeof op.originalText !== 'string') return label + ': op.originalText required';
if (op.deleted !== true && typeof op.newText !== 'string') {
return label + ': text op requires newText';
}
if (typeof op.newText === 'string') {
if (op.deleted !== true && op.newText.trim().length === 0) {
return label + ': newText cannot be empty';
}
const forbidden = validateManualEditText(op.newText);
if (forbidden) {
return label + ': newText cannot contain ' + forbidden.join(' ') + ' (plain text only; ask the AI to insert markup)';
}
}
}
return null;
}
export function validateEvent(msg) {
if (!msg || typeof msg !== 'object' || !msg.type) return 'Missing or invalid message';
switch (msg.type) {
case 'generate':
if (!isValidId(msg.id)) return 'generate: missing or malformed id';
if (!Number.isInteger(msg.count) || msg.count < 1 || msg.count > 8) return 'generate: count must be 1-8';
if (msg.mode === 'insert') return validateInsertGenerate(msg);
return validateReplaceGenerate(msg);
case 'accept':
if (!isValidId(msg.id)) return 'accept: missing or malformed id';
if (!isValidVariantId(msg.variantId)) return 'accept: missing or malformed variantId';
if (msg.paramValues !== undefined) {
if (typeof msg.paramValues !== 'object' || msg.paramValues === null || Array.isArray(msg.paramValues)) {
return 'accept: paramValues must be an object';
}
}
return null;
case 'discard':
return isValidId(msg.id) ? null : 'discard: missing or malformed id';
case 'checkpoint':
if (!isValidId(msg.id)) return 'checkpoint: missing or malformed id';
if (!Number.isInteger(msg.revision) || msg.revision < 0) return 'checkpoint: revision must be a non-negative integer';
if (msg.paramValues !== undefined && (typeof msg.paramValues !== 'object' || msg.paramValues === null || Array.isArray(msg.paramValues))) {
return 'checkpoint: paramValues must be an object';
}
return null;
case 'exit':
return null;
case 'prefetch':
if (!msg.pageUrl || typeof msg.pageUrl !== 'string') return 'prefetch: missing pageUrl';
return null;
case 'manual_edits':
return validateManualEditEvent(msg, 'manual_edits');
case 'steer':
if (!isValidId(msg.id)) return 'steer: missing or malformed id';
if (typeof msg.message !== 'string' || !msg.message.trim()) return 'steer: message required';
if (msg.message.length > 4000) return 'steer: message too long';
if (msg.pageUrl !== undefined && typeof msg.pageUrl !== 'string') return 'steer: pageUrl must be string';
return null;
default:
return 'Unknown event type: ' + msg.type;
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |