Назад към всички

lgtm

// Launch lgtm TUI to review a markdown file with line-by-line commenting

$ git log --oneline --stat
stars:4
forks:1
updated:February 6, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namelgtm
descriptionLaunch lgtm TUI to review a markdown file with line-by-line commenting
argument-hint<file-path> [--stdin]
allowed-toolsBash(bun run *), Bash(bunx *), Bash(tmux *), Read

Launch lgtm to review the specified markdown file or piped content.

Usage

/lgtm path/to/plan.md # Opens TUI for review (auto-spawns in tmux pane) /lgtm @CLAUDE.md # @ prefix is stripped automatically /lgtm --stdin # Review content piped from stdin

What it does

Opens an interactive TUI for reviewing markdown documents with:

  • Line-by-line navigation (j/k)
  • Comment types: Blocker, Concern, Question, Suggestion, Praise, Acknowledge
  • Syntax highlighting for code blocks
  • Export to markdown (E) or clipboard (y)
  • Summary view (v)

Instructions

When this skill is invoked, follow these steps:

  1. Parse arguments: Extract the file path from $ARGUMENTS. If it starts with @, strip that prefix. Ignore --tmux if present (it's automatic).
  2. Resolve path: Convert the file path to an absolute path if it isn't already.
  3. Read the file: Use the Read tool to load the full file content into context. This is essential so you can correlate the user's line-level comments with actual file content.
  4. Create export path: Generate /tmp/lgtm-export-{basename-without-extension}.md
  5. Run the TUI: Check if ${CLAUDE_PLUGIN_ROOT}/node_modules exists to determine the run command. The --export-on-quit flag automatically enables tmux mode and waits for the user to quit.
    • If ${CLAUDE_PLUGIN_ROOT}/node_modules exists (local dev): 
      bun run ${CLAUDE_PLUGIN_ROOT}/src/cli.ts "<resolved-file-path>" --export-on-quit "<export-path>"
    • If node_modules does not exist (marketplace install): 
      bunx @hapticdata/lgtm "<resolved-file-path>" --export-on-quit "<export-path>"
  6. Read the export: After the command returns (user has quit the TUI), use the Read tool to read the export file.
  7. Respond in review mode: This is a collaborative review workflow. After reading the export:
    • Correlate each comment with the corresponding line(s) from the original file content you read in step 3.
    • Summarize the user's feedback, grouping by comment type (Blockers, Concerns, Questions, Suggestions, Praise).
    • Proactively address blockers and concerns first — propose concrete code or content changes to resolve them.
    • Answer any questions the user raised.
    • Acknowledge suggestions and praise.
    • Offer to iterate on the file by applying the proposed changes.