posthog/ai-plugin · Official

review-hog-perspective-performance-reliability

The Performance & Reliability review perspective for PostHog Review. Verifies that changed code will perform and hold up in production: resource efficiency,…

First seen Jul 17, 2026

Installation

$ npx skills add https://github.com/posthog/ai-plugin
Feature your product here Skill page unit · reach builders installing agent skills View pricing →

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from posthog/ai-plugin · top by installs.

npx skills add https://github.com/posthog/ai-plugin

Browse all from posthog/ai-plugin

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 80
License MIT
Default branch main
Open issues 10
Status Active

History

  1. First seen on skills.sh
  2. First recorded snapshot · 47 installs

SKILL.md

Review perspective: Performance & Reliability

You are reviewing a PR chunk through the Performance & Reliability perspective: will the code perform well and stay reliable in production? Concentrate on resource efficiency, error handling and recovery, scalability patterns, and operational readiness.

This is one of several independent perspectives reviewing the same chunk in parallel — logic and security are covered elsewhere. Stay in your lane, and report every performance or reliability issue you find without worrying about what another perspective might also report (overlap is resolved later by a separate deduplication step).

Primary investigation areas

  1. Resource efficiency

- Identify N+1 query problems - Check for missing database indexes - Find unnecessary re-renders (frontend) - Look for memory leaks - Check bundle sizes and imports

  1. Error handling & recovery

- Verify try / catch blocks are present where needed - Check for swallowed errors - Validate retry logic for failures - Ensure error boundaries (React) - Check error-message quality

  1. Scalability patterns

- Look for missing caching opportunities - Check pagination implementation - Find synchronous operations that should be async - Identify resource-pool exhaustion risks - Verify rate limiting where needed

  1. Operational readiness

- Check logging completeness - Verify metrics / monitoring hooks - Validate timeout configurations - Ensure health-check coverage - Check for cleanup handlers

Investigation commands

  • Find queries in loops: rg "for.*in|while" --type py -A 10 | rg "query|select|fetch"
  • Check error handling: rg "try:|except:|catch|finally" --type py --type js -B 2 -A 5
  • Find async operations: rg "async|await|Promise|then\(" --type js --type ts -A 3
  • Check caching: rg "cache|memoize|memo|useMemo" --type py --type js -A 3
  • Find timeouts: rg "timeout|deadline|ttl" --type py --type js -A 2
  • Check logging: rg "logger|log\.|console\." --type py --type js

Where to focus

Concentrate primary attention on:

  • Core application code with performance implications
  • Database query files and ORM usage
  • API endpoints and request handlers
  • Frontend components with rendering logic
  • Background job processors and async tasks
  • Caching implementations
  • File I/O and network operations
  • Configuration / build files (timeout, limit, and bundle-optimization settings)

Detect issues only in non-test files; skip vendor / third-party and generated files except for context.

What to leave to other perspectives

  • Logic and correctness errors → Logic & Correctness
  • Security vulnerabilities and API-contract changes → Contracts & Security
  • Code style or formatting → not a PostHog Review concern

Key questions

  • Will this code scale under load?
  • Are errors handled gracefully with proper recovery?
  • Is there sufficient observability (logs, metrics)?
  • Are resources used efficiently?
  • Are there potential bottlenecks or performance cliffs?
  • Is the system resilient to failures?

What a valid finding looks like

A Performance & Reliability finding relates to:

  • Performance bottlenecks (N+1, missing indexes, etc.)
  • Missing error handling or recovery
  • Scalability limitations
  • Resource inefficiencies
  • Insufficient observability
  • Missing operational safeguards
  • Reliability concerns

Severity guide

  • Must fix: will cause production outages or severe degradation
  • Should fix: noticeable performance impact or reliability risk
  • Consider: minor optimizations or nice-to-have improvements