# Discuss Code

> Discuss code critically before or instead of editing. Use when user asks for a compact opinion on code, a diff, snippet, design, naming, logic, simplicity, structure, or maintainability, and wants findings plus smallest useful fixes. For formal risk-ranked pull request review use code-reviewer; for architecture candidates use architecture-review; for actual cleanup edits use code-simplifier or refactoring.

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

---


# Discuss Code

Review code critically.
Focus on real issues.
Keep output compact.

## Goal

- Find concrete problems.
- Explain impact plainly.
- Suggest smallest useful fix.
- Avoid praise unless there are no findings.

## Rules

- Findings first.
- Highest impact first.
- Max 5 findings.
- No speculative issues without evidence.
- Reference file and line when possible.
- Show code only when it clarifies fix.

## Check

- Correctness.
- Unneeded logic.
- Duplication.
- Weak abstraction.
- Nesting and complexity.
- Naming.
- Dead code.
- Missed simple pattern.

## Flow

1. Read user-provided code or target.
2. Identify behavior and intent.
3. Check for bugs and maintainability risks.
4. Rank findings by impact.
5. Suggest minimal fixes.

## Output

```md
Verdict: good | mixed | bad

## Finding N: short title
What: concrete issue
Why: impact or risk
Suggestion: smallest useful fix
Reference: `file:line` or snippet
```

If no findings:

```md
Verdict: good
No findings.
Residual risk: [missing context or test gap]
```

## Related skills

- `code-architecture-wrong-abstraction`
- `typescript-best-practices`
- `react-useeffect-avoid`
- `naming-cheatsheet`