aws-media-services — скилл для Claude Code
Скилл aws-media-services для Claude Code и других сред, который проектирует, настраивает и отлаживает видеопотоки в облаке AWS. Запускается при работе с MediaLive, MediaConvert или другими сервисами потокового вещания.
Apache-2.0 627 установок ★ 3 536 обновлён 2026-10-23
npx skills add aws/agent-toolkit-for-aws --skill aws-media-services -a claude-codeЧто делает aws-media-services
Этот скилл автоматизирует проектирование, проверку и устранение неполадок в рабочих процессах потокового видео внутри AWS. Он включает правила для MediaConnect, MediaLive, MediaConvert, MediaPackage, MediaTailor и CloudFront, позволяя соблюдать лучшие практики при настройке живого вещания, линейных каналов и VOD-конвейеров.
Для работы скилла необходимо сначала подгрузить файл references/service-rules-core.md. Без него агент может пропустить критические требования или выдать некорректные рекомендации. После этого, в зависимости от задачи, требуется добавление профильных файлов из папки references с правилами конкретных сервисов или типов рабочих процессов.
Какие задачи решает
- настроить сквозной конвейер для живого стриминга
- провести аудит конфигурации медиа-сервисов
- устранить ошибки в кодировании или упаковке контента
- оптимизировать расходы на видео-инфраструктуру
- настроить вставку рекламы через MediaTailor
Примеры запросов агенту
- «Используй скилл для настройки VOD-конвейера через MediaConvert и MediaPackage»
- «Проверь конфигурацию MediaLive на соответствие лучшим практикам для живого вещания»
- «Помоги устранить ошибки в манифесте MediaPackage v2»
Как установить aws-media-services
1Через Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill aws-media-services -a claude-code2Вручную: положить файлы
~/.claude/skills/aws-media-services/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/aws-media-services/
1Через Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill aws-media-services -a codex2Вручную: положить файлы
.agents/skills/aws-media-services/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill aws-media-services -a cursor2Вручную: положить файлы
.cursor/skills/aws-media-services/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install aws/agent-toolkit-for-aws skills/specialized-skills/media-services-skills/aws-media-services2Вручную: положить файлы
.github/skills/aws-media-services/SKILL.md1Через Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill aws-media-services -a gemini-cli2Командой платформы
gemini skills install https://github.com/aws/agent-toolkit-for-aws --path skills/specialized-skills/media-services-skills/aws-media-servicesВручную: положить файлы
.devin/skills/aws-media-services/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill aws-media-services -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об aws-media-services
Как установить aws-media-services в Claude Code?
Выполните команду npx skills add aws/agent-toolkit-for-aws --skill aws-media-services -a claude-code в терминале проекта.
Что делает aws-media-services?
Скилл предоставляет агенту доступ к базе знаний и правилам AWS для проектирования, оценки и отладки видеопотоков, чтобы избежать ошибок при настройке облачных медиа-сервисов.
Что нужно для работы aws-media-services?
Требуется обязательная загрузка файла references/service-rules-core.md перед выполнением любых действий и подключение дополнительных файлов правил в зависимости от используемых AWS-сервисов.
Исходный текст
SKILL.md · Apache-2.0
---
name: aws-media-services
description: "Designs, deploys, reviews, evaluates, audits, and troubleshoots video streaming workflows across AWS media services (MediaConnect, MediaLive, MediaConvert, MediaPackage v2, MediaTailor, CloudFront). Includes per-service validation rules, cross-service workflow patterns for live streaming, linear channels, VOD pipelines, and live-to-VOD, service-specific troubleshooting, best practices assessment, cost optimization, encoder settings, DRM, SCTE-35 ad insertion, epoch locking, and CDN cache configuration."
version: 1
---
# AWS Media Services
Use this skill when the user is doing ANY of the following with AWS
media services:
- **Building or modifying** a video workflow (ingest, encoding, packaging, ad
insertion, CDN delivery)
- **Reviewing, evaluating, or auditing** an existing or proposed configuration
for best practices, compliance, or correctness
- **Troubleshooting** errors, alerts, or unexpected behavior
- **Asking questions** about service constraints, compatibility rules, encoder
settings, IAM policies, security groups, DRM, SCTE-35, caching, scaling, or
any other AWS media topic
- **Planning** a new workflow and needs to understand requirements, dependencies,
or the discovery checklist
- **Optimizing** cost, resilience, or performance of an existing workflow
If the user mentions ANY AWS media service by name (MediaConnect, MediaLive,
MediaConvert, MediaPackage, MediaTailor) or related concepts (HLS, DASH, CMAF,
ABR ladder, SCTE-35, epoch locking, origin shield, CDI, SRT, RTMP, transcode,
live streaming, VOD pipeline, ad insertion, SSAI), load this skill.
This file is the orchestrator. It tells you which reference files to load based on
the user's task. **Do not load all files at once.** Load on demand per the routing
table below.
---
## MANDATORY FIRST STEP — Read Before Doing Anything Else
**STOP. Before you make ANY API call, pull ANY resource configuration, write ANY
code, or produce ANY recommendation, you MUST load the required rule files into
context.** No exceptions. This applies to every task type: building, modifying,
evaluating, troubleshooting, or answering questions.
The rule content is split across:
- `references/service-rules-core.md` — cross-service compatibility constraints,
common agent mistakes, and security considerations. **ALWAYS loaded.**
- `references/service-rules-encoding.md` — shared encoder settings (QVBR, GOP,
profiles, quality tuning, deinterlacing). Loaded for any encoding task.
- `references/service-rules-mediaconnect.md`
- `references/service-rules-medialive.md`
- `references/service-rules-mediaconvert.md`
- `references/service-rules-mediapackage.md`
- `references/service-rules-mediatailor.md`
- `references/service-rules-cloudfront.md`
Per-service rule files are loaded conditionally based on which services the
query involves. Without the relevant rules loaded, you will produce
recommendations based on general knowledge that may contradict the documented
rules, flag correct configurations as problems, or miss critical constraints
entirely.
**Sequence (every time):**
1. Read `references/service-rules-core.md` — confirm it is in context before
proceeding. ALWAYS required.
2. Determine the task type and consult the Task Routing tables below to
identify both the workflow/troubleshooting file AND the per-service rules
to co-load.
3. For ad-hoc questions that don't match a workflow or troubleshooting
category: if the user names specific service(s), load those service rule
files. If the question is symptom-based or you cannot determine which
services are involved, load ALL per-service rule files.
4. Only then begin resource discovery, API calls, or implementation.
If you find yourself about to call `aws medialive describe-channel` or similar
and you have NOT yet read the core rules file plus the relevant per-service
rules, stop and go back to step 1.
---
## Task Routing
### Building or modifying a workflow
Determine the workflow type. Load the matching workflow file AND the per-service
rules listed in the right column (the core rules file is already loaded from the
mandatory first step above).
| Workflow type | Workflow file | Service rules to co-load |
|---------------|---------------|--------------------------|
| Live event (ingest → encode → package → deliver) | `references/workflow-live-event.md` | mediaconnect + medialive + encoding + mediapackage + cloudfront (+ mediatailor if ads) |
| Linear channel (24/7 with schedule, ad insertion) | `references/workflow-linear-channel.md` | medialive + encoding + mediapackage + mediatailor + cloudfront |
| VOD pipeline (file-based transcode → package → deliver) | `references/workflow-vod-pipeline.md` | mediaconvert + encoding + mediapackage + cloudfront |
| Live-to-VOD (live + archive/harvest → VOD transcode) | `references/workflow-live-event.md` + `references/workflow-vod-pipeline.md` | union of live event + VOD pipeline |
| Ad insertion (SSAI/CSAI, MediaTailor scaling) | `references/workflow-ad-insertion.md` | medialive + encoding + mediapackage + mediatailor + cloudfront |
| Contribution transport (MediaConnect, SRT, DX, encoders) | `references/workflow-contribution-distribution.md` | mediaconnect + medialive + encoding |
| Router-based switching (master control, dynamic routing, playout) | `references/workflow-contribution-distribution.md` | mediaconnect + medialive + encoding |
| Resilience (dual-AZ, dual-region, epoch locking, multi-CDN, ops readiness) | `references/workflow-resilience-patterns.md` | ALL (cross-cutting) |
| Cost optimization (reserved vs on-demand, channel classes, right-sizing) | `references/workflow-cost-optimization.md` | ALL (cross-cutting) |
| Subtitles and accessibility (captions, multi-language, auto-captioning) | `references/workflow-subtitles-accessibility.md` | medialive + mediaconvert + encoding |
### Troubleshooting
Load the relevant troubleshooting file(s) for the problem area AND the
per-service rules listed in the right column. The core rules file is already
loaded from the mandatory first step above. Load only the files needed.
| Problem area | Troubleshooting file | Service rules to co-load |
|--------------|----------------------|--------------------------|
| MediaConnect flow issues, source connectivity, VPC interfaces, MediaConnect Router | `references/troubleshooting-mediaconnect.md` | mediaconnect |
| MediaLive channel errors, alerts, encoding, pipeline failover | `references/troubleshooting-medialive.md` | medialive + encoding |
| MediaPackage ingest failures, manifest issues, access denied, v1→v2 migration | `references/troubleshooting-mediapackage.md` | mediapackage |
| MediaConvert job failures, codec errors, output issues, automation | `references/troubleshooting-mediaconvert.md` | mediaconvert + encoding |
| MediaTailor ad insertion, ADS issues, SSAI scaling, session management | `references/troubleshooting-mediatailor.md` | mediatailor + medialive + mediapackage + cloudfront |
| CloudFront origin errors, cache behavior, multi-CDN, Embedded POPs (ePOP) | `references/troubleshooting-cloudfront.md` | cloudfront + mediapackage |
| Cross-service signal chain (no video, latency, sync, AZ alignment, IAM, failover) | `references/troubleshooting-pipeline.md` | ALL |
### Quick reference
For a quick answer about a specific service's constraints, valid parameter
values, or compatibility rules:
1. `references/service-rules-core.md` is already loaded (mandatory first step).
2. If the user names specific service(s) in the query, load those per-service
rule files (e.g. `references/service-rules-medialive.md`).
3. If the question crosses service boundaries (e.g., MediaPackage→MediaTailor
compatibility), the cross-service rules are already in
`service-rules-core.md`.
4. If you can't determine which services are involved, load ALL per-service
rule files.
This includes the following topics:
- MediaTailor scaling patterns (multi-region, CDN origin shield, prefetch)
- MediaConnect Router (paired resilient zonal endpoints) and downstream NDI converter caveats
- Epoch locking and cross-region failover
- Contribution transport (SRT tuning, Direct Connect sizing, RTP+FEC)
- Multi-CDN architecture patterns
- CloudFront advanced patterns (Embedded POPs / ePOP, CF Functions, segment sharding)
- Operational readiness for live events (capacity planning, KPI baselines)
- DRM production patterns and MediaPackage v1→v2 migration
- Audio, HDR, and codec configuration details
---
## Workflow Discovery Checklist
Before creating ANY resources for a new workflow, gather requirements from the
user in a fixed order (mode → cost/scale → approach → source → network → encoding →
ad insertion → packaging → IAM → VOD-specific). Do not proceed until all required
items are answered; later questions depend on earlier answers.
**Load `references/workflow-discovery-checklist.md`** for the full ordered question
set whenever building or modifying a workflow.
## Plan Validation (before presenting to user)
Before presenting a proposed configuration to the user, cross-check against
the loaded service rules:
- Codec/container compatibility (e.g., HEVC requires fMP4, not TS)
- GOP/segment duration alignment across all ABR rungs
- Dependency ordering (downstream before upstream)
- IAM trust policy includes all required service principals + sts:TagSession
- IAM permissions scoped to specific resource ARNs (no Resource: "*")
- Security posture (CIDR scoped, OAC configured, no Principal: *)
- All prerequisite resources included (IAM roles, VPC, MediaPackage channel MUST be in the plan before resources that depend on them)
Do NOT make API calls during this step. This is a rules-based review of the
proposed plan against constraints already in context.
Agents MUST NOT skip dependency steps to save time. All prerequisites (IAM,
VPC, MediaPackage channel, etc.) MUST be created before resources that reference
them. Skipping steps and fixing errors reactively leads to circular
troubleshooting loops. Execute the plan in dependency order.
---
## Resource Creation Order
Respect dependency order — a resource must exist before anything that references
it (live chain, VOD chain, live-to-VOD addition, and the common flow patterns
table).
**Load `references/resource-creation-order.md`** for the full dependency chains and
flow-pattern table when creating resources.
## Startup and Shutdown (Live Only)
Start upstream first and poll each resource to its ready state before proceeding
(`STARTING` ≠ running); shut down in reverse (`STOPPING` ≠ stopped). Poll on a
tight ~5s cadence.
**Load `references/startup-shutdown.md`** for the ordered start/stop tables and the
polling pattern (including MediaConnect Router lifecycle) when operating a live
workflow.
## Tooling
When available, the AWS MCP Server is recommended for sandboxed execution and audit logging:
- **AWS MCP Server** (`aws-mcp-server`): AWS API access, Agent SOPs
for guided multi-step workflows, and documentation search via
`search_documentation` and `read_documentation`.
- **AWS IaC MCP Server** (`aws-iac-mcp-server`): CloudFormation template validation,
CDK documentation search, CDK code samples, and IaC best practices.
**Large response warning:** MediaLive `describe-channel` and MediaPackage `list-*`
calls return very large JSON. Always use `--query` (JMESPath) to extract only the
fields you need.
```bash
# Good — extract only what you need
aws medialive describe-channel --channel-id 12345 --query "{State:State,Name:Name,Id:Id}"
aws medialive list-channels --query "Channels[].{Name:Name,Id:Id,State:State}"
aws mediapackagev2 list-origin-endpoints --channel-group-name X --channel-name Y \
--query "Items[].{Name:OriginEndpointName,Url:HlsManifests[0].Url}"
```
© aws · Apache-2.0 · aws/agent-toolkit-for-aws