Agent Skills
› NeverSight/learn-skills.dev
› project-observability-analyzer
project-observability-analyzer
GitHub分析项目结构、框架及现有日志，推荐可观测性集成方案。生成OTEL配置、Prometheus指标、Docker Compose文件及说明文档，支持Express、Next.js等主流框架。
Trigger Scenarios
需要为项目添加可观测性功能
询问如何集成OpenTelemetry或APM工具
请求生成可观测性相关的配置文件
Install
npx skills add NeverSight/learn-skills.dev --skill project-observability-analyzer -g -y
SKILL.md
Frontmatter
{
"name": "project-observability-analyzer",
"description": "Analyze projects and recommend observability integration. Use when adding observability to projects Claude Code works on."
}
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
Version History
- e0220ca Current 2026-07-05 23:12
