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
- Run
git diff main...HEADto list files - Read each file and check for common smells
- Emit a markdown report summarising findings
Example
$ asm eval ./well-formed
Overall score: 95/100
Acceptance Criteria
- Produces a markdown report with sections per file
- Flags any use of
eval()orexecas 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.