performance-profile

Profile system and endpoint performance bottlenecks with structured timing data.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/hpsgd/turtlestack --skill performance-profile-hpsgd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performance-profile
Source: https://github.com/hpsgd/turtlestack/tree/main/plugins/engineering/performance-engineer/skills/performance-profile
Command: npx skills add https://github.com/hpsgd/turtlestack --skill performance-profile-hpsgd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Profiling to identify performance bottlenecks in a system or endpoint, providing objective baselines and actionable targets for optimization.

Core Features & Use Cases

  • Baseline measurement: establish objective metrics (p50, p95, p99, throughput, error rate) under realistic load.
  • End-to-end timing breakdown: decompose latency across network, server processing, database queries, external calls, and serialization.
  • Layered profiling: profile databases, external services, and CPU-bound work with clear bottleneck targets.
  • Output-driven recommendations: prioritise improvements by impact and effort, with a repeatable measurement plan.
  • Use case: identify a slow API under peak load and outline concrete steps to reduce tail latency.

Quick Start

Run the performance-profile skill against your target endpoint to generate a baseline performance report.

Frequently Asked Questions about performance-profile

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

FAQPage Schema
How do I identify performance bottlenecks in a slow API endpoint?

To identify performance bottlenecks in a slow API, you profile the endpoint to collect baseline metrics like p50, p95, and p99 latency under realistic load. This establishes objective measurements to pinpoint exactly where latency occurs.

What is the best way to profile database queries and external calls affecting system latency?

Profiling system latency involves decomposing end-to-end timing across network, server processing, database queries, and external calls. This structured timing breakdown isolates specific resource bottlenecks causing delays.

How do I measure a performance baseline for server-side code under peak load?

Measuring a performance baseline for server-side code requires collecting throughput, error rate, and percentile latency metrics under realistic load. This baseline provides objective targets for subsequent optimization efforts.

Can I profile frontend timing along with backend server processing?

Yes, you can profile optional frontend timing alongside backend server processing. The profiling workflow decomposes latency across both frontend and backend layers to deliver comprehensive bottleneck targets.

How do I prioritize system optimization steps after finding bottlenecks?

Prioritizing system optimization involves ranking identified bottlenecks by their impact and effort. This profiling workflow outputs formalized recommendations and a prioritized optimization plan for actionable improvements.