# Lookagain Output Format

> Defines the standard output format for code review findings. Use when performing code reviews to ensure consistent, parseable output. Use when this capability is needed.

- Skill: `tomevault-io/lookagain-output-format` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/lookagain-output-format`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/lookagain-output-format/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/lookagain-output-format

---


# Code Review Output Format

When performing code reviews, output findings in this exact JSON structure:

```json
{
  "pass_summary": "string - Brief summary of review scope and key findings",
  "issues": [
    {
      "severity": "must_fix | should_fix | suggestion",
      "title": "string - Brief title (max 100 chars)",
      "description": "string - Detailed explanation of the issue",
      "file": "string - Relative file path",
      "line": "number | null - Line number if applicable",
      "suggested_fix": "string - How to fix it"
    }
  ]
}
```

## Severity Definitions

**must_fix**:
- Security vulnerabilities
- Bugs causing runtime errors
- Data loss/corruption risks
- Breaking API changes

**should_fix**:
- Performance issues
- Poor error handling
- Missing edge cases
- Maintainability concerns

**suggestion**:
- Minor refactoring
- Documentation gaps
- Style improvements

## Rules

- Output ONLY valid JSON (no markdown wrapper)
- Include all fields for each issue
- Use `null` for optional fields (like `line`) when not applicable
- Keep titles concise and descriptive
- Make suggested_fix actionable

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/hartbrook) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->