backend-latency-profiler-helper — скилл для Claude Code
Скилл backend-latency-profiler-helper разбирает медленные эндпоинты API: находит узкие места, перечисляет возможные причины и раскладывает исправления по приоритетам.
MIT 275 установок ★ 64 обновлён 2026-01-12
npx skills add patricio0312rev/skills --skill backend-latency-profiler-helper -a claude-codeЧто делает backend-latency-profiler-helper
Скилл разбирает, почему API отвечает медленно. Внутри четыре блока: middleware для Express, который замеряет время запроса и пишет в лог предупреждение, если запрос идёт дольше 1000 мс; SQL-запрос по таблице request_logs — десять самых медленных эндпоинтов за сутки; TypeScript-интерфейс PerformanceBottleneck для причин и приоритета правки; markdown-дорожная карта на три недели.
Порядок такой: включить замер, посмотреть топ эндпоинтов, заполнить список гипотез (N+1, отсутствующий индекс на user_id, дорогая сериализация JSON) и разложить правки от индексов и кеша до разбиения сервиса и CDN. В конце чек-лист: эндпоинты найдены, причины разобраны, план есть, мониторинг настроен.
SQL-запрос жёстко привязан к таблице request_logs с полями endpoint, duration_ms, created_at. Если логи лежат в другом месте или в другом формате, запрос придётся переписать под свою схему: сам он ничего не найдёт.
Какие задачи решает
- найти эндпоинты, которые отвечают дольше секунды
- посчитать среднее и максимальное время ответа по каждому маршруту
- собрать список гипотез, почему конкретный обработчик тормозит
- разложить правки производительности на быстрые и долгие
- добавить в Express замер времени запроса с записью в лог
Примеры запросов агенту
- Разбери, почему бэкенд тормозит: покажи десять самых медленных эндпоинтов за сутки.
- Добавь middleware, который логирует запросы дольше 1000 мс вместе с путём и методом.
- Составь дорожную карту исправлений для
GET /api/users/:idс приоритетами.
Как установить backend-latency-profiler-helper
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill backend-latency-profiler-helper -a claude-code2Вручную: положить файлы
~/.claude/skills/backend-latency-profiler-helper/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/backend-latency-profiler-helper/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill backend-latency-profiler-helper -a codex2Вручную: положить файлы
.agents/skills/backend-latency-profiler-helper/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill backend-latency-profiler-helper -a cursor2Вручную: положить файлы
.cursor/skills/backend-latency-profiler-helper/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install patricio0312rev/skills performance/backend-latency-profiler-helper/SKILL.md2Вручную: положить файлы
.github/skills/backend-latency-profiler-helper/SKILL.md1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill backend-latency-profiler-helper -a gemini-cli2Командой платформы
gemini skills install https://github.com/patricio0312rev/skills --path performance/backend-latency-profiler-helperВручную: положить файлы
.devin/skills/backend-latency-profiler-helper/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill backend-latency-profiler-helper -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о backend-latency-profiler-helper
Как установить backend-latency-profiler-helper в Claude Code?
Выполните npx skills add patricio0312rev/skills --skill backend-latency-profiler-helper -a claude-code, после чего скилл окажется по пути ~/.claude/skills/backend-latency-profiler-helper/SKILL.md.
Что делает backend-latency-profiler-helper?
Ищет медленные эндпоинты API, предлагает вероятные причины торможения и собирает план исправлений по неделям вместе с чек-листом проверки.
Откуда скилл берёт статистику по медленным эндпоинтам?
Из таблицы request_logs: запрос группирует строки по endpoint и считает среднее и максимальное время из duration_ms за последние сутки. Под другую схему логов его надо переписать.
Исходный текст
SKILL.md · MIT
---
name: backend-latency-profiler-helper
description: Identifies API latency hotspots and bottlenecks with profiling tools, slow endpoint detection, suspected causes, and fix roadmap. Use for "latency profiling", "performance bottlenecks", "slow APIs", or "backend performance".
---
# Backend Latency Profiler Helper
Find and fix API performance bottlenecks.
## Slow Endpoint Detection
```typescript
// Middleware to track latency
app.use((req, res, next) => {
const start = Date.now();
res.on("finish", () => {
const duration = Date.now() - start;
if (duration > 1000) {
logger.warn(
{
endpoint: req.path,
method: req.method,
duration_ms: duration,
userId: req.user?.id,
},
"Slow request detected"
);
}
});
next();
});
```
## Top Slow Endpoints
```sql
-- Query from logs
SELECT
endpoint,
AVG(duration_ms) as avg_ms,
MAX(duration_ms) as max_ms,
COUNT(*) as requests
FROM request_logs
WHERE created_at > NOW() - INTERVAL '1 day'
GROUP BY endpoint
HAVING AVG(duration_ms) > 500
ORDER BY avg_ms DESC
LIMIT 10;
```
## Suspected Causes
```typescript
interface PerformanceBottleneck {
endpoint: string;
avgLatency: number;
suspectedCauses: string[];
fixPriority: "high" | "medium" | "low";
}
const bottlenecks: PerformanceBottleneck[] = [
{
endpoint: "GET /api/users/:id",
avgLatency: 2500,
suspectedCauses: [
"N+1 query fetching user orders",
"No database index on user_id",
"Expensive JSON serialization",
],
fixPriority: "high",
},
];
```
## Fix Roadmap
```markdown
# Performance Fix Roadmap
## Week 1: Quick Wins
- [ ] Add database indexes
- [ ] Enable response caching
- [ ] Fix N+1 queries
## Week 2: Medium Effort
- [ ] Optimize slow database queries
- [ ] Implement Redis caching
- [ ] Add connection pooling
## Week 3: Long-term
- [ ] Database query optimization
- [ ] Service decomposition
- [ ] CDN integration
```
## Output Checklist
- [ ] Slow endpoints identified
- [ ] Causes analyzed
- [ ] Fix roadmap created
- [ ] Monitoring configured
ENDFILE
© patricio0312rev · MIT · patricio0312rev/skills