# Well Formed

> Review pull request diffs for code smells, style issues, and safety problems before merging.

- Skill: `tuyv/well-formed` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add tuyv/well-formed`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tuyv/well-formed/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: tuyv (https://skillmd.com/u/tuyv)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tuyv/well-formed

---


# Well-formed corpus skill

## When to Use

- When the user asks to "review this PR" or "check the diff"
- Before merging any change larger than 10 lines

## Prerequisites

- A git repository with the target branch checked out
- Read access to the files being reviewed

## Instructions

1. Run `git diff main...HEAD` to list files
2. Read each file and check for common smells
3. Emit a markdown report summarising findings

## Example

```bash
$ asm eval ./well-formed
Overall score: 95/100
```

## Acceptance Criteria

- Produces a markdown report with sections per file
- Flags any use of `eval()` or `exec` as dangerous
- Does not modify the working tree

## Edge cases

- Empty diffs: emit a short "no changes" note
- Binary files: skip and mention the filename in the report

## Safety

See `references/safety.md` for error handling rules.
Always confirm before writing. Never run destructive commands without a dry-run.