debug-pipeline-log

Analyze TeaRAGs pipeline debug logs to detect performance bottlenecks and timing anomalies.

11|3|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill debug-pipeline-log
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-pipeline-log
Source: https://github.com/artk0de/TeaRAGs-MCP/tree/main/.claude/skills/debug-pipeline-log
Command: npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill debug-pipeline-log

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves performance bottlenecks and timing anomalies in the TeaRAGs pipeline by parsing complex debug logs into actionable insights.

Core Features & Use Cases

  • Performance Profiling: Automatically calculates wall times for embedding, git prefetching, and chunking phases.
  • Bottleneck Detection: Identifies specific issues like GPU thermal throttling, git log latency, or queue starvation using predefined diagnostic rules.
  • Use Case: When your indexing process feels sluggish or hangs, use this skill to determine if the issue is caused by slow git operations or GPU backpressure.

Quick Start

Analyze the most recent pipeline log file to generate a performance report and identify potential bottlenecks.

Frequently Asked Questions about debug-pipeline-log

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose RAG pipeline performance bottlenecks from debug logs?

To diagnose RAG pipeline performance bottlenecks, you can parse debug logs to calculate wall times for embedding, git prefetching, and chunking phases. This identifies timing anomalies and specific issues like git log latency or GPU backpressure.

Why does my RAG indexing process hang during git enrichment?

Your RAG indexing process may hang during git enrichment due to git log latency or queue starvation. Analyzing pipeline debug logs identifies these specific timing anomalies and bottlenecks within the git prefetching phase.

What is the best way to identify GPU thermal throttling in RAG pipelines?

The best way to identify GPU thermal throttling in RAG pipelines is by evaluating metrics across embedding throughput and concurrency utilization. Parsing debug logs detects this backpressure using predefined diagnostic rules.

Can I use debug logs to optimize embedding throughput and concurrency utilization?

Yes, you can use debug logs to optimize embedding throughput and concurrency utilization. The logs contain stage profiling tables that calculate wall times and provide specific tuning recommendations to resolve queue starvation.