OpenParable
Skip to content
← Back to skills

Well Formed

Testing & Quality
well-formed

Well Formed is an Agent Skill for testing & quality published in the luongnv89/asm repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/luongnv89/asm/blob/HEAD/tests/fixtures/skills/well-formed/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/well-formed, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

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