project-observability-analyzer

Analyze projects and recommend observability integration. Use when adding observability to projects Claude Code works on.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/project-observability-analyzer

SKILL.md

Project Observability Analyzer

Analyze project structure and recommend observability strategy for applications.

Workflow

Scan Project Structure (files, dependencies, framework)
Detect Framework (Express, Next.js, FastAPI, Spring Boot, etc.)
Identify Existing Logging (Winston, Pino, Python logging, etc.)
Detect Existing Observability (Prometheus exporters, OTEL, APM agents)
Analyze API Endpoints (if web framework detected)
Generate Recommendations:
- OTEL instrumentation points
- Logging library configurations
- Prometheus metrics to add
- Docker compose integration
Generate Integration Files:
- Updated docker-compose.yml (app + observability)
- OTEL instrumentation code
- Logger configuration
- README with setup instructions

Example Output

markdown

## Project: Express.js REST API

**Framework**: Express.js 4.18.2
**Logging**: Winston (JSON format) ✅
**Observability**: None ❌

**Recommendations**:
1. Add express-prom-bundle for Prometheus metrics
2. Configure Winston → Loki (via Alloy)
3. Add OTEL auto-instrumentation for tracing
4. Integrate with LGTM stack

**Files Generated**:
- docker-compose-with-app.yml
- otel-instrumentation.js
- winston-loki-config.js

Framework Templates

Express.js integration
Next.js integration
FastAPI integration
Spring Boot integration