well-formed

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

IndexedMIT★ 959

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/luongnv89-well-formed

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

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

Use cases: code-review

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools: No tools found
Secrets: None asked for
Install scripts: None found

Network hosts it talks to 1

codeload.github.com · found in install command

Files it touches

~/.claude/skills/well-formed

Tools it pre-approves 2

From allowed-tools in SKILL.md: the agent may use these without asking you each time.

Read
Grep

What's inside

Skill name: well-formed
Description: Review pull request diffs for code smells, style issues, and safety problems before merging.
License: MIT
Compatibility: Claude Code
Allowed tools: Read, Grep
Instructions: 42 lines in SKILL.md · view on GitHub

Agent Skills spec issues

files: referenced but missing: references/safety.md

Files (1)

SKILL.md

SKILL.md (first lines)

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

From luongnv89/asm, MIT.

Compare and alternatives

Featured in

Signals

Stars: 959
Forks: 83
Open issues: 17
Last commit (this folder): Apr 18, 2026 (6 months ago)
Last release: Oct 20, 2026 (6 days ago)

From GitHub (fetched Oct 24, 2026).

Details

License: MIT
Repository: github.com/luongnv89/asm
Website: luongnv.com/asm
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: GitHub github-graphql

More from luongnv89

Cite this page

well-formed skill. Agent Mart. https://agentmart.dev/skills/luongnv89-well-formed (last updated 2026-10-24)