# Observe

Show whether the agent followed the kit''s rules in recent sessions: pages edited and...

- Repository: https://github.com/plugin87/ux-ui-agent-skills (3071 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add plugin87/ux-ui-agent-skills --skill observe -g -a claude-code -y`
Codex: `npx skills add plugin87/ux-ui-agent-skills --skill observe -g -a codex -y`
Cursor: `npx skills add plugin87/ux-ui-agent-skills --skill observe -g -a cursor -y`
Gemini CLI: `npx skills add plugin87/ux-ui-agent-skills --skill observe -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add plugin87/ux-ui-agent-skills`

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

> **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` only the skill folders were installed. Say so, point the user
> at the plugin install or `npx ux-ui-agent-skills init`, and stop.

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.

