Skip to main content
skill CX Codex

observe · plugin87 — Claude Code skill: what it does, how to install

observe — a skill for Claude Code that checks local hook events to see if the agent followed UX/UI kit rules in recent sessions. Runs manually on user request.

MIT ★ 3,216 updated 2026-11-10

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add plugin87/ux-ui-agent-skills
/plugin install ux-ui-agent-skills@ux-ui-agent-skills
Open on GitHub

What observe does

This skill inspects session records to check three specific rules. Every edited page must pass a gate before completion, no fast-gate findings can remain on the latest file version, and the agent must not exit while the Stop hook holds open pages. It does not evaluate design quality.

Under the hood it executes scripts/observe.mjs using Node.js. The skill cannot run in isolation: it requires the complete ux-ui-agent-skills kit installed via npx [email protected] init or as a Claude Code plugin. If only the skill directory is added, execution halts with a KIT_MISSING error.

What it helps with

  • verify passing gates for every edited UI page
  • identify unresolved fast-gate findings in current file versions
  • detect sessions finished while the Stop hook had pages open
  • export compliance audit results to HTML

Example prompts for the agent

  • Run observe for this project over the last 3 days
  • Inspect a failed session using observe --session <id>
  • Generate an HTML audit summary using observe --html report.html

How to install observe

1Plugin marketplace

/plugin marketplace add plugin87/ux-ui-agent-skills
/plugin install ux-ui-agent-skills@ux-ui-agent-skills

This installs the whole ux-ui-agent-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add plugin87/ux-ui-agent-skills --skill observe -a claude-code

3Manually: put the files in place

~/.claude/skills/observe/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/observe/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about observe

How to install observe in Claude Code?

Run /plugin marketplace add plugin87/ux-ui-agent-skills and then /plugin install ux-ui-agent-skills@ux-ui-agent-skills. To ensure the scripts exist, initialize the kit with npx [email protected] init.

What does observe do?

It audits recorded hook events to verify whether agent sessions followed the kit's UI rules. The model cannot trigger this skill automatically because disable-model-invocation is set to true.

What is required to run observe?

It requires Node.js and the complete ux-ui-agent-skills setup. Without the local scripts/observe.mjs script and recorded hook events, the skill stops immediately.

Source text

SKILL.md · MIT
---
name: observe
description: 'Show whether the agent followed the kit''s rules in recent sessions: pages edited and measured, Stop hook blocks, findings left open. Reads local hook events only.'
# A command the user runs, like /gate. The model never starts it.
disable-model-invocation: true
---
## Requirements

This skill needs the full UX/UI Agent Skills kit: the gates, the references and
the design-system library. Install it with `npx [email protected] init`
or as the Claude Code plugin. `npx [email protected] add` copies the skill folder and
nothing else, and this skill has no guidance-only mode: its whole job is to
read what the kit's hooks recorded, so without the kit there is nothing for it to do.

> **Step 0: is the kit here?** Check once:
> `ls ${CLAUDE_SKILL_DIR}/../../../scripts/observe.mjs >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING`
> On `KIT_MISSING`, say plainly that only the skill folder was installed, name
> the install command above, and stop. Do not guess the contents of a file you
> could not open, and do not report a result you did not produce.

Report what the hooks recorded - never a reconstruction from memory.

1. Run `node ${CLAUDE_SKILL_DIR}/../../../scripts/observe.mjs --project "$CLAUDE_PROJECT_DIR"`
   (or without `--project` when the user asks about every project, and with
   `--days N` when they name a window).
2. Quote the summary lines it prints. If it says no session edited UI, say that
   and stop: there is nothing to judge.
3. For each session marked `BROKE A RULE`, run it again with `--session <id>` and
   say which rule failed and the timeline line that shows it.
4. If the user wants the page, run it with `--html <path>` and give the path.

What it measures, and what it does not: three counted rules per session -
every edited page had a passing gate before the end, no fast-gate finding was
left on a file's latest version, and the agent never finished while the Stop
hook still had pages open. It says nothing about design quality, and an
`unfinished` session is not counted for or against.

© Thientan Soparat · MIT · plugin87/ux-ui-agent-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

observe by other authors comes first.

observe simple10 Controls the local Agents Observe server, opens session dashboards in the browser, and inspects Docker logs. CX Codex +1 ★ 738repo stars interface-auditor uxuiprinciples interface-auditor reads an interface description and flags UX antipatterns, rating severity and returning fix steps as JSON. CX Codex +1 ★ 33repo stars break-ui emilkowalski Claude Code skill break-ui stress-tests user interfaces with realistic worst-case data and reports layout breaks. CX Codex +1 121,000installs enhance-prompt official google-labs-code enhance-prompt is a Claude Code skill that turns rough UI ideas into structured prompts for Stitch. It kicks in when a prompt needs clearer details or a better response from the generator. CX Codex +1 60,600installs plan-design-review garrytan Claude Code skill plan-design-review has a senior product designer read a plan and add the decisions it lacks. It fires when someone asks for a design plan review or a UX plan review. CX Codex +1 543installs ux-designer szilu The ux-designer Claude Code skill guides interface design and reviews of screens or frontend code. It activates for usability and accessibility audits, component work, forms, navigation, and microcopy. CX Codex +1 1,900installs nielsen-heuristics-audit mastepanoski The nielsen-heuristics-audit skill walks an interface through Jakob Nielsen's 10 usability heuristics and returns a report with a severity rating for every finding. Useful when you want problems found before user testing. CX Codex +1 824installs

From the same set35

The whole set →
token-build Claude Code skill for running design token build pipelines. Converts DTCG JSON tokens into web styles, iOS catalogs, and Android themes. CX Codex +1 555installs figma-integration The figma-integration Claude Code skill connects a project’s tokens and components with Figma, syncing in either direction and checking for design-code drift. It activates for token sync, design extraction, or component parity checks. CX Codex +1 554installs governance governance — a skill for Claude Code and Codex that enforces design system evolution rules, SemVer token versioning, and component deprecation workflows. CX Codex +1 549installs accessibility Checks interactive elements against core accessibility requirements. Use it during UI audits or when completing a component. CX Codex +1 ★ 3,216repo stars frameworks frameworks directs Claude Code to generate production UI code for React with Tailwind v4, Next.js 15, and SwiftUI 6 without placeholders. CX Codex +1 ★ 3,216repo stars ship ship — a skill for Claude Code runs pre-release checks and drafts a release checklist. It starts before a release tag, checking the project before preparing version and changelog details. CX Codex +1 ★ 3,216repo stars gate Skill for Claude Code runs a UI quality gate before marking tasks complete. You trigger the command manually, preventing the model from calling it autonomously. CX Codex +1 ★ 3,216repo stars review-and-research review-and-research standardizes UI audits, usability checks, and design handoff requirements. Activates when Claude Code inspects screens or prepares components for developers. CX Codex +1 ★ 3,216repo stars

Project sponsors

Companies that keep this analytics open