# Chimesdk Diagnostics

> >

- **Type:** Skill
- **Install:** `agentstack add skill-aws-samples-sample-ai-agent-skills-chimesdk-troubleshooting`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [aws-samples](https://agentstack.voostack.com/s/aws-samples)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT-0
- **Upstream author:** [aws-samples](https://github.com/aws-samples)
- **Source:** https://github.com/aws-samples/sample-ai-agent-skills/tree/main/chimesdk-troubleshooting

## Install

```sh
agentstack add skill-aws-samples-sample-ai-agent-skills-chimesdk-troubleshooting
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Chime SDK Diagnostics

## When to use

Any Amazon Chime SDK investigation — meeting creation, audio/video, messaging, SIP media, PSTN, identity, or SDK integration issues.

## Investigation workflow

### Step 1 — Collect and triage

```
aws chime-sdk-meetings list-attendees --meeting-id 
aws chime-sdk-voice list-sip-media-applications --max-results 20
aws chime-sdk-messaging list-channels --app-instance-arn 
aws cloudwatch get-metric-statistics --namespace AWS/ChimeSDK --metric-name MeetingCount --start-time  --end-time  --period 3600 --statistics Sum
```

### Step 2 — Domain deep dive

```
aws chime-sdk-meetings get-meeting --meeting-id 
aws chime-sdk-voice get-sip-media-application --sip-media-application-id 
aws chime-sdk-identity list-app-instances --max-results 20
aws chime-sdk-messaging describe-channel --channel-arn  --app-instance-user-arn 
```

### Step 3 — Detailed investigation

```
aws cloudtrail lookup-events --lookup-attributes AttributeKey=EventSource,AttributeValue=chime.amazonaws.com --max-results 10
aws chime-sdk-voice list-phone-numbers --max-results 20
aws chime-sdk-voice get-voice-connector --voice-connector-id 
```

Read `references/guardrails.md` before concluding on any Chime SDK issue.

## Gotchas: Chime SDK

- Chime SDK has separate services: Meetings, Messaging, Voice, Identity, Media Pipelines.
- Meeting attendee tokens are sensitive — generate server-side, pass to client.
- SIP media applications require Lambda functions for call control.
- PSTN audio requires phone number provisioning and SIP rules.
- Messaging uses app instances and app instance users for identity.
- Media regions affect latency — choose closest to participants.
- WebRTC is used for meetings — requires UDP connectivity.

## Anti-hallucination rules

1. Chime SDK Meetings, Messaging, and Voice are separate services with different APIs.
2. Meeting IDs and attendee tokens are ephemeral — meetings expire after inactivity.
3. SIP media applications require Lambda for call flow logic.
4. Phone numbers must be provisioned before use in PSTN audio.
5. App instance users are required for messaging — they're not IAM users.
6. Spend no more than 2 minutes on any single hypothesis. Pivot if inconclusive.

## 14 runbooks

| Category | IDs | Covers |
|----------|-----|--------|
| A — Meetings | A1-A2 | Meeting creation, attendee issues |
| B — Audio/Video | B1-B2 | Audio problems, video quality |
| C — Messaging | C1-C2 | Channel messaging, delivery |
| D — SIP | D1-D2 | SIP media apps, call routing |
| E — PSTN | E1-E2 | Phone numbers, PSTN audio |
| F — Identity | F1 | App instances, user management |
| G — SDK | G1-G2 | Client SDK, integration |
| Z — Catch-All | Z1 | General troubleshooting |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [aws-samples](https://github.com/aws-samples)
- **Source:** [aws-samples/sample-ai-agent-skills](https://github.com/aws-samples/sample-ai-agent-skills)
- **License:** MIT-0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-aws-samples-sample-ai-agent-skills-chimesdk-troubleshooting
- Seller: https://agentstack.voostack.com/s/aws-samples
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.