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
## 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