К основному содержанию
скилл CX Codex

linkerd-expert — скилл для Claude Code: что делает и как установить

Скилл linkerd-expert по Linkerd для Kubernetes: агент ставит меш, включает инъекцию прокси, снимает метрики через linkerd viz и настраивает политики доступа.

Apache-2.0 162 установок ★ 45 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add personamanagmentlayer/pcl --skill linkerd-expert -a claude-code
Открыть на GitHub

Что делает linkerd-expert

Скилл даёт агенту роль инженера по Linkerd: он проводит установку в кластер, включает инъекцию прокси, разбирает трафик и наблюдаемость. Внутри — последовательности команд linkerd и kubectl: linkerd check --pre перед установкой, linkerd install | kubectl apply -f -, linkerd upgrade, linkerd viz stat, tap, routes, edges, а для разбора прокси — linkerd diagnostics proxy-metrics.

Дальше идут практики: аннотация linkerd.io/inject: enabled на namespace, лимиты прокси через config.linkerd.io/proxy-cpu-limit и config.linkerd.io/proxy-memory-limit, ретраи фильтром HTTPRoute, ServiceProfile из OpenAPI командой linkerd viz profile myapp -n production --open-api swagger.json, политики ServerAuthorization по схеме «запрещено всё, кроме разрешённого». Скилл отдельно перечисляет антипаттерны: пустые лимиты и skip-inbound-ports: "1-65535".

Рассчитан на Linkerd 2.14 и Kubernetes 1.28 или новее. На более старых версиях примеры команд расходятся с тем, что отдаёт CLI. Bash ограничен kubectl и linkerd, файлы агент читает и правит через Read, Write, Edit, Glob и Grep. Подробный разбор архитектуры лежит в references/CORE_CONCEPTS.md, его скилл открывает по запросу.

Какие задачи решает

  • поставить Linkerd в кластер и проверить установку через linkerd check
  • включить инъекцию прокси для namespace production
  • посмотреть живые запросы между myapp и api через linkerd viz tap
  • сгенерировать ServiceProfile из файла OpenAPI
  • закрыть сервис политиками ServerAuthorization

Примеры запросов агенту

  • Проверь, готов ли кластер к Linkerd: прогони linkerd check --pre и объясни, что мешает установке.
  • Включи инъекцию для namespace production и покажи статистику по деплойментам.
  • Разберись, почему запросы к deployment/api идут медленно — посмотри маршруты и живые запросы.

Как установить linkerd-expert

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill linkerd-expert -a claude-code

2Вручную: положить файлы

~/.claude/skills/linkerd-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/linkerd-expert/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о linkerd-expert

Как установить linkerd-expert в Claude Code?

Выполните npx skills add personamanagmentlayer/pcl --skill linkerd-expert -a claude-code. После этого скилл лежит в ~/.claude/skills/linkerd-expert/SKILL.md.

Что делает linkerd-expert?

Ведёт агента по работе с Linkerd в Kubernetes: установка меша, инъекция прокси, метрики и живые запросы через linkerd viz, ретраи и политики доступа.

Какие версии Linkerd и Kubernetes нужны?

Скилл рассчитан на Linkerd 2.14 и Kubernetes 1.28 или новее. Команды он выполняет через kubectl и linkerd.

Исходный текст

SKILL.md · Apache-2.0
---
name: linkerd-expert
version: 1.1.0
description: >-
  Expert-level Linkerd service mesh management, traffic control, reliability, and
  production operations. Use when the user mentions service mesh, Kubernetes,
  microservices, mTLS, or observability, or when the task involves Linkerd Architecture,
  Mesh Injection, Traffic Management, or Reliability Features.
category: devops
author: PCL Team
license: Apache-2.0
tags:
  - linkerd
  - service-mesh
  - kubernetes
  - microservices
  - mtls
  - observability
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash(kubectl:*, linkerd:*)
  - Glob
  - Grep
requirements:
  linkerd: '>=2.14'
  kubernetes: '>=1.28'
---

# Linkerd Expert

You are an expert in Linkerd service mesh with deep knowledge of traffic management, reliability features, security, observability, and production operations. You design and manage lightweight, secure microservices architectures using Linkerd's ultra-fast data plane.

## linkerd CLI Commands

**Installation and Status:**

```bash
# Pre-installation check
linkerd check --pre

# Install
linkerd install | kubectl apply -f -

# Check installation
linkerd check

# Upgrade
linkerd upgrade | kubectl apply -f -

# Uninstall
linkerd uninstall | kubectl delete -f -
```

**Mesh Operations:**

```bash
# Inject deployment
kubectl get deployment myapp -o yaml | linkerd inject - | kubectl apply -f -

# Inject namespace
linkerd inject deployment.yaml | kubectl apply -f -

# Uninject
linkerd uninject deployment.yaml | kubectl apply -f -
```

**Observability:**

```bash
# Stats
linkerd viz stat deployments -n production
linkerd viz stat pods -n production

# Routes
linkerd viz routes deployment/myapp -n production

# Top
linkerd viz top deployment/myapp -n production

# Tap (live traffic)
linkerd viz tap deployment/myapp -n production
linkerd viz tap deployment/myapp -n production --to deployment/api

# Edges (traffic graph)
linkerd viz edges deployment -n production
```

**Diagnostics:**

```bash
# Get proxy logs
linkerd viz logs deployment/myapp -n production

# Proxy metrics
linkerd viz metrics deployment/myapp -n production

# Diagnostics
linkerd diagnostics proxy-metrics pod/myapp-xxx -n production
```

## Best Practices

### 1. Use Automatic Injection

```yaml
# Enable at namespace level
annotations:
  linkerd.io/inject: enabled
```

### 2. Set Resource Limits

```yaml
annotations:
  config.linkerd.io/proxy-cpu-limit: '1000m'
  config.linkerd.io/proxy-memory-limit: '256Mi'
```

### 3. Configure Retries and Timeouts

```yaml
# Use HTTPRoute for reliability
filters:
  - type: RequestHeaderModifier
    requestHeaderModifier:
      set:
        - name: l5d-retry-limit
          value: '3'
```

### 4. Monitor Golden Metrics

```
- Success Rate (requests/sec)
- Request Volume (RPS)
- Latency (P50, P95, P99)
```

### 5. Use ServiceProfiles

```bash
# Generate from OpenAPI
linkerd viz profile myapp -n production --open-api swagger.json
```

### 6. Implement Zero Trust

```yaml
# Default deny, explicit allow
kind: ServerAuthorization
```

### 7. Multi-Cluster for HA

```bash
# Export critical services
mirror.linkerd.io/exported: "true"
```

## Anti-Patterns

**1. No Resource Limits:**

```yaml
# BAD: No proxy limits
# GOOD: Set explicit limits
config.linkerd.io/proxy-cpu-limit: '1000m'
```

**2. Skip Ports Unnecessarily:**

```yaml
# BAD: Skip all ports
config.linkerd.io/skip-inbound-ports: "1-65535"

# GOOD: Only skip specific ports (metrics, health)
config.linkerd.io/skip-inbound-ports: "9090"
```

**3. No Authorization Policies:**

```yaml
# GOOD: Always implement Server + ServerAuthorization
```

**4. Ignoring Metrics:**

```bash
# GOOD: Monitor success rate, latency, RPS
linkerd viz stat deployments -n production
```

## Approach

When implementing Linkerd:

1. **Start Simple**: Inject one service first
2. **Enable Namespace Injection**: Scale gradually
3. **Monitor**: Use viz dashboard and CLI
4. **Reliability**: Add retries and timeouts
5. **Security**: Implement authorization policies
6. **Profile Services**: Generate ServiceProfiles
7. **Multi-Cluster**: For high availability
8. **Tune**: Adjust proxy resources based on load

Always design service mesh configurations that are lightweight, secure, and observable following cloud-native principles.

## Reference Documentation

Detailed material lives alongside this skill and is read on demand:

- [Core Expertise](references/CORE_CONCEPTS.md) — Linkerd Architecture, Installation, Mesh Injection, Traffic Management, Reliability Features, Authorization Policies, Multi-Cluster, Observability

## Resources

- Linkerd Documentation: https://linkerd.io/docs/
- Linkerd Best Practices: https://linkerd.io/2/tasks/
- BuoyantCloud: https://buoyant.io/cloud
- Service Mesh Interface (SMI): https://smi-spec.io/

© PCL Team · Apache-2.0 · personamanagmentlayer/pcl

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
linkerd-patterns Seth Hobson Скилл linkerd-patterns для Claude Code и Codex. Помогает настроить Linkerd в Kubernetes: от mTLS и политик трафика до canary-развёртываний и связи между кластерами. CX Codex +1 10 200установок service-mesh-expert Seth Hobson Субагент service-mesh-expert для Claude Code разбирает маршрутизацию, mTLS и мультикластерные конфигурации в Kubernetes. Настраивает Istio и Linkerd, управляет сертификатами и федерацией кластеров. CX Codex ★ 42 780звёзд репо ai-inference-service-mesh devops-skills Скилл ai-inference-service-mesh для Claude Code, Codex, Cursor и других платформ управляет трафиком AI-инференса через Istio или Linkerd: mTLS, canary-релизы, политики доступа и circuit breaker. CX Codex +1 344установок microservices-patterns manutej Скилл microservices-patterns для Claude Code и Codex: service mesh, circuit breakers, маршрутизация трафика и Istio. Закрывает каскадные падения сервисов и канареечные релизы. CX Codex +1 447установок cilium-expert martinholovsky Скилл cilium-expert помогает настраивать CNI Cilium на базе eBPF, писать сетевые политики L3–L7 и отлаживать трафик в Kubernetes через Hubble без сайдкаров. CX Codex +1 253установок microservices-architect https://github.com/Jeffallan Скилл microservices-architect для Claude Code проектирует распределённые системы, выделяет границы сервисов и рекомендует паттерны устойчивости. Проектирует микросервисную архитектуру с DDD и отказоустойчивостью. CX Codex +1 5 300установок

Из того же набора104

Весь набор →
codeql-expert Скилл codeql-expert помогает писать и запускать запросы CodeQL, искать уязвимости и подключать анализ к GitHub Code Scanning. Работает с несколькими языками. CX Codex +1 174установок skill-creator-expert Скилл skill-creator-expert помогает проектировать, писать и проверять скиллы PCL: разбирает предметную область, собирает структуру и прогоняет готовый файл по чек-листу качества. CX Codex +1 173установок django-expert Скилл django-expert помогает проектировать веб-приложения на Django: модели ORM, представления, формы, маршруты и API на Django REST Framework. CX Codex +1 172установок graphql-expert Скилл graphql-expert помогает проектировать GraphQL-схемы, писать резолверы и разбирать подписки. Пригодится при работе с Apollo Server, федерацией и проблемой N+1. CX Codex +1 169установок data-mesh-expert Скилл data-mesh-expert помогает агенту проектировать data mesh: домены владеют своими данными, дата-продукты идут с контрактами, управление федеративное, платформа самообслуживания. CX Codex +1 168установок swift-expert Скилл swift-expert для Claude Code помогает писать и разбирать код на Swift для iOS и macOS. Охватывает задачи со SwiftUI, Combine и современным синтаксисом Swift. CX Codex +1 163установок pcl-expert Скилл pcl-expert для Claude Code описывает Persona Control Language: объявления persona, team и workflow, компилятор, LSP и MCP. Помогает агенту править .pcl-файлы и компилятор. CX Codex +1 160установок sql-expert Скилл sql-expert для экспертной работы с SQL: проектирование схем, написание эффективных запросов, оптимизация индексов и администрирование PostgreSQL, MySQL и SQL Server. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой