# Loopx Change Quality

Qualify the exact final diff for a LoopX-managed goal.

- Repository: https://github.com/loopx-project/loopx (6526 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add loopx-project/loopx --skill loopx-change-quality -g -a claude-code -y`
Codex: `npx skills add loopx-project/loopx --skill loopx-change-quality -g -a codex -y`
Cursor: `npx skills add loopx-project/loopx --skill loopx-change-quality -g -a cursor -y`
Gemini CLI: `npx skills add loopx-project/loopx --skill loopx-change-quality -g -a gemini-cli -y`

## Description

Qualify the exact final diff for a LoopX-managed goal. Use when goal policy enables change_quality_qualification, before a non-trivial delivery or merge, and when producing or repairing an exact-scope quality receipt. The workflow is language-neutral, permits at most one policy-authorized safe-fix pass, and never grants merge or repository authority.

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

# LoopX Change Quality

Use this skill only when the selected goal's
`change_quality_qualification.enabled` policy is true. LoopX owns the canonical
source but does not install it globally. Install a managed copy in a connected
project for the relevant host:

```bash
loopx project-skill install \
  --project . \
  --skill loopx-change-quality \
  --surface codex \
  --execute
```

Use `--surface claude-code` or `--surface opencode` for those hosts. Skill
discovery does not activate the capability; product behavior remains
default-off until goal policy enables it.

The CLI is the contract authority. This skill supplies a host-neutral review
workflow. Repository instructions, tests, linters, type checkers, and security
checks remain the project's quality oracles.

## Prepare The Exact Scope

From the repository worktree, run:

```bash
loopx --format json change-quality prepare \
  --goal-id <goal-id> \
  --repo-path . \
  --base-ref origin/main
```

Stop when the packet says `disabled` or `no_changes`. When it says
`review_required`, review only the files and exact fingerprint in the packet.
Read repository-local instructions before judging the change.

Run `loopx project-skill status --project . --skill loopx-change-quality` when
the host depends on skill discovery. If the managed copy is absent or stale,
preview an explicit project install; do not fall back to a global copy.

## Review Rules

## Simplify First

Spend the review budget on simplification before broad quality analysis:

The rest: https://github.com/loopx-project/loopx/blob/HEAD/skills/loopx-change-quality/SKILL.md