[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ADFSRVPFJJ4WH864DJ94T1":3,"skill-same:01M7ADFSRVPFJJ4WH864DJ94T1":149},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":45,"commitSha":46,"skillDirectory":47,"forksCount":48,"repositoryHtmlUrl":49,"repositoryHomepageUrl":6,"ownerHtmlUrl":50,"ownerBlogUrl":6,"ownerDescription":51,"updatedAt":52,"install":53,"resources":66},"01M7ADFSRVPFJJ4WH864DJ94T1","transit-gateway-routing-troubleshooter",null,"Diagnoses AWS Transit Gateway routing failures through a fourteen-layer diagnostic tree: TGW route table association vs propagation (separate controls), static route priority (static beats propagated), overlapping CIDR blocks across attachments, peering attachment non-transitivity (VPC-A→TGW-A←peering→TGW-B→VPC-C requires direct peering, no transitive hop), VPN\u002FDirect Connect gateway routing, multicast domain membership, TGW flow logs gaps, VPC route table default route 0.0\u002F0 pointing at TGW, TGW attachment placed in the wrong subnet\u002FAZ, cross-VPC security group references (not supported through TGW), DNS resolution across TGW attachments, appliance mode forcing traffic through an inspection VPC, and blackhole route detection. Walks symptoms to a verified root cause with evidence-backed read-only probes; emits ROOT_CAUSE_IDENTIFIED or INSUFFICIENT_DATA.","jhkchan\u002Faws-agent-skills","jhkchan","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1083902?v=4","01M7A2SVQYP9GQTPTDXP5JKYQ4","Jacky Chan","01M7A2SVS117YWCTZABB75HZR1",4,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: transit-gateway-routing-troubleshooter\ndescription: 'Diagnoses AWS Transit Gateway routing failures through a fourteen-layer diagnostic tree: TGW route table association vs propagation (separate controls), static route priority (static beats propagated), overlapping CIDR blocks across attachments, peering attachment non-transitivity (VPC-A→TGW-A←peering→TGW-B→VPC-C requires direct peering, no transitive hop), VPN\u002FDirect Connect gateway routing, multicast domain membership, TGW flow logs gaps, VPC route table default route 0.0\u002F0 pointing at TGW, TGW attachment placed in the wrong subnet\u002FAZ, cross-VPC security group references (not supported through TGW), DNS resolution across TGW attachments, appliance mode forcing traffic through an inspection VPC, and blackhole route detection. Walks symptoms to a verified root cause with evidence-backed read-only probes; emits ROOT_CAUSE_IDENTIFIED or INSUFFICIENT_DATA.'\nlicense: Apache-2.0\ncompatibility: Agent runtime that reads SKILL.md (Claude Code, Cursor, Windsurf, Codex, Gemini). Offline symptom classification works from pasted topology and error messages. Live-account diagnosis uses aws ec2 describe-transit-gateways, describe-transit-gateway-attachments, describe-transit-gateway-route-tables, get-transit-gateway-route-table-associations, get-transit-gateway-route-table-propagations, search-transit-gateway-routes, describe-route-tables, describe-vpn-connections...\nmetadata:\n  domain: aws-cloudops\n  complexity: high\n  requires_llm: 'true'\n  phase: '2'\n  supports_pipeline: 'true'\n  entry_point: 'false'\n  family: Networking\n  task_type: troubleshoot\n  skill_class: capability\n  lifecycle_status: active\n  verdict_shape: ROOT_CAUSE_IDENTIFIED | INSUFFICIENT_DATA\n  when_to_use: Diagnosing a Transit Gateway routing failure (traffic from one attached VPC never reaches another attached VPC, traffic takes the wrong path, traffic is asymmetrically dropped, peering between two TGWs does not forward, VPN\u002FDX routing through TGW is broken, multicast traffic does not reach all members, appliance-mode inspection VPC drops cross-AZ return traffic, or a default route 0.0\u002F0 pointing at the TGW produces a blackhole). Use when the symptom is \"VPC-A cannot reach VPC-B through the transit gateway\" and the cause may be route table association\u002Fpropagation, static-route priority, overlapping CIDR, non-transitive peering, wrong-subnet attachment, missing appliance mode, or a missing TGW route table entry.\n  when_not_to_use: Provisioning a new TGW or attachment (use transit-gateway-deployer), VPC peering (non-TGW) connectivity (use vpc-peering-deployer), VPC endpoint \u002F PrivateLink connectivity inside a single VPC (use vpc-connectivity-troubleshooter), or TGW cost \u002F capacity posture audits (use networkmanager-core-network-auditor). This skill diagnoses routing failures at runtime; it does not provision or audit steady-state posture.\n  activation_triggers: VPC cannot reach VPC through transit gateway, TGW traffic blackhole, TGW route table missing entry, TGW static route overrides propagated, transit gateway peering non-transitive, TGW appliance mode cross-AZ return, TGW overlapping CIDR, TGW default route 0.0.0.0\u002F0, TGW attachment wrong subnet, TGW VPN routing, TGW Direct Connect routing, TGW multicast not received, TGW DNS resolution across attachments, TGW flow logs missing, security group cross-VPC TGW, troubleshoot transit gateway routing\n  invocation_schema: 'Input: either (a) a symptom description (\"VPC-A cannot reach VPC-B through TGW\", \"traffic exits VPC-A but never arrives at VPC-B\", \"TGW peering between two regions does not forward\"), optionally paired with the TGW topology (attachment IDs, VPC CIDRs, route table IDs), OR (b) a TGW ID plus the source\u002Fdestination VPC IDs and observed packet-flow symptom for live-account diagnosis. Output: a deterministic TARGET\u002FVERDICT\u002FREASON\u002FLAYER\u002FEVIDENCE\u002FREMEDIATION block where VERDICT ∈ {ROOT_CAUSE_IDENTIFIED, INSUFFICIENT_DATA} and LAYER ∈ {TGW_ROUTE_TABLE_ASSOCIATION, TGW_ROUTE_TABLE_PROPAGATION, TGW_STATIC_ROUTE_PRIORITY, TGW_OVERLAPPING_CIDR, TGW_PEERING_NON_TRANSITIVE, TGW_VPN_DX_ROUTING, TGW_MULTICAST_DOMAIN, TGW_FLOW_LOGS, VPC_DEFAULT_ROUTE_TGW, TGW_ATTACHMENT_WRONG_SUBNET, TGW_SG_CROSS_VPC, TGW_DNS_RESOLUTION, TGW_APPLIANCE_MODE, TGW_BLACKHOLE_ROUTE, UNKNOWN}.'\n  invocation_example: '# Minimal valid input (offline symptom classification):\n\n    Symptom: \"EC2 instance i-aaa in VPC vpc-a (10.10.0.0\u002F16, us-east-1)\n\n    cannot reach EC2 instance i-bbb in VPC vpc-b (10.20.0.0\u002F16, us-east-1)\n\n    through transit gateway tgw-aaa. The ping times out. Both VPCs are\n\n    attached to the TGW; the VPC-A route table has 10.20.0.0\u002F16 → tgw-aaa.\"\n\n    TGW: tgw-aaa\n\n    Attachment A: tgw-attach-aaa (VPC vpc-a, subnet subnet-a-aaa, AZ us-east-1a)\n\n    Attachment B: tgw-attach-bbb (VPC vpc-b, subnet subnet-b-aaa, AZ us-east-1a)\n\n    VPC-A route table: 10.20.0.0\u002F16 → tgw-aaa\n\n    VPC-B route table: (default route 0.0.0.0\u002F0 → igw-bbb; no entry for 10.10.0.0\u002F16)'\n  version: 0.1.0\n  author: Jacky Chan — AWS Community Builder\n  keywords: Transit Gateway, TGW, route table, association, propagation, static route, propagated route, overlapping CIDR, peering attachment, non-transitive, VPN, Direct Connect, multicast domain, flow logs, default route, appliance mode, inspection VPC, blackhole, security group, cross-VPC, DNS resolution, troubleshooting\n  tags: transit-gateway, networking, troubleshooting, routing, tgw, peering, vpn, direct-connect, appliance-mode, multicast\n---\n\n# Transit Gateway Routing Troubleshooter\n\n## Quick start\n\n- **Symptom → layer map (first plausible match drives the first probe):**\n  Traffic exits source VPC but never arrives at destination VPC →\n  TGW_ROUTE_TABLE_ASSOCIATION \u002F TGW_ROUTE_TABLE_PROPAGATION \u002F\n  VPC_DEFAULT_ROUTE_TGW (return path); traffic reaches the wrong VPC\n  → TGW_STATIC_ROUTE_PRIORITY \u002F TGW_OVERLAPPING_CIDR; TGW peering\n  between two TGWs forwards one way but not the other →\n  TGW_PEERING_NON_TRANSITIVE; cross-AZ return traffic through an\n  inspection VPC is dropped → TGW_APPLIANCE_MODE; VPN\u002FDX advertises\n  routes but VPC cannot reach on-prem → TGW_VPN_DX_ROUTING; multicast\n  sender works but receivers see nothing → TGW_MULTICAST_DOMAIN;\n  cross-VPC DNS hostname resolution fails → TGW_DNS_RESOLUTION;\n  TGW flow logs are empty → TGW_FLOW_LOGS.\n- **Always verify with a read-only probe, never guess.** Each layer\n  has a single command that proves or disproves it. A\n  ROOT_CAUSE_IDENTIFIED verdict requires positive evidence — a\n  failing probe that matches the symptom — not a process of\n  elimination.\n- **Route table association and propagation are SEPARATE controls.**\n  Associating an attachment with a TGW route table determines which\n  route table that attachment LOOKS UP routes in. Propagating an\n  attachment into a route table determines which route table LEARNS\n  that attachment's CIDR. An attachment can be associated with one\n  route table and propagate into many. Operators who \"added the VPC\n  to the TGW\" but never propagated the attachment into the peer's\n  route table produce a one-way blackhole.\n- **Static routes ALWAYS beat propagated routes in the same TGW route\n  table.** A `search-transit-gateway-routes` result showing a static\n  `10.20.0.0\u002F16 → tgw-attach-wrong` entry explains why the\n  auto-propagated `10.20.0.0\u002F16 → tgw-attach-correct` route never\n  wins. This is the #1 misdiagnosis in TGW incidents.\n- **TGW peering is strictly non-transitive.** If `tgw-a` peers with\n  `tgw-b`, and `tgw-b` peers with `tgw-c`, traffic from an attachment\n  on `tgw-a` CANNOT reach an attachment on `tgw-c` through `tgw-b` as\n  a hop. Each pair of TGWs that needs to exchange traffic requires a\n  direct peering attachment. There is no \"transitive peering\" feature.\n- **Appliance mode forces cross-AZ return traffic through the\n  inspection VPC.** Without appliance mode, TGW preserves the source\n  AZ. A stateful inspection appliance in `us-east-1a` never sees the\n  `us-east-1b` return traffic and drops the flow. Enabling appliance\n  mode on the inspection VPC attachment routes the return through the\n  appliance's AZ regardless of the original source AZ.\n\n## Mindset\n\nA TGW routing incident is almost always a route-table control-plane\nproblem wearing a \"network is broken\" costume. The TGW data plane\nforwards packets along the routes it has learned; the failure is\nupstream of forwarding — in association, propagation, static-route\npriority, appliance mode, or overlapping CIDR. Senior network\nengineers do not start by running packet captures; they start with\n`search-transit-gateway-routes` and the route table associations on\nboth the source and destination attachments.\n\n## Philosophy\n\nThe four Philosophy behaviours moved verbatim to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n## Quick reference — symptom triage table\n\n| Symptom phrase \u002F observation | Most likely layer | First probe |\n|---|---|---|\n| Source VPC route table has `10.20.0.0\u002F16 → tgw-aaa`, traffic leaves but never arrives | TGW_ROUTE_TABLE_ASSOCIATION \u002F TGW_ROUTE_TABLE_PROPAGATION \u002F VPC_DEFAULT_ROUTE_TGW (return path) | `get-transit-gateway-route-table-associations`, `search-transit-gateway-routes` for the destination CIDR |\n| Traffic reaches the WRONG VPC; ping returns a host that is not the intended target | TGW_STATIC_ROUTE_PRIORITY \u002F TGW_OVERLAPPING_CIDR | `search-transit-gateway-routes --filter type=static` |\n| TGW peering between two regions: one direction works, reverse does not | TGW_PEERING_NON_TRANSITIVE (or one side missing a static\u002Fpropagated route) | `describe-transit-gateway-peering-attachments` on both TGWs; route tables on both sides |\n| Cross-AZ stateful firewall \u002F inspection appliance drops flows intermittently | TGW_APPLIANCE_MODE | `describe-transit-gateway-attachments` (ApplianceMode on the inspection attachment) |\n| VPN or Direct Connect advertises routes into TGW but VPC cannot reach on-prem | TGW_VPN_DX_ROUTING | `search-transit-gateway-routes` for the on-prem CIDR; VPN CGW configuration |\n| Multicast sender succeeds; receivers see nothing | TGW_MULTICAST_DOMAIN | `describe-transit-gateway-multicast-domains`, `search-transit-gateway-multicast-groups` |\n| Cross-VPC DNS hostname (e.g. `service.vpc-b`) does not resolve from VPC-A | TGW_DNS_RESOLUTION | VPC `enableDnsHostnames` \u002F `enableDnsSupport`, Route 53 Resolver endpoints |\n| TGW flow logs are empty even though traffic is flowing | TGW_FLOW_LOGS | `describe-flow-logs --resource-type transit-gateway`, IAM role for the flow log |\n| Cross-VPC security group rule with peer-VPC SG reference does not allow traffic | TGW_SG_CROSS_VPC | `describe-security-groups` (the source reference is invalid cross-VPC) |\n| None of the above, intermittent loss | UNKNOWN | Reachability Analyzer, TGW flow logs, VPC flow logs |\n\n## Pre-flight: TGW state and gather-info gate\n\nBefore symptom-specific probes, gather the canonical TGW topology\nand short-circuit on attachment states that mimic routing failures.\n\n### Pre-flight commands\n\nThe pre-flight gather commands moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\n### Attachment-state short-circuit\n\n| `State` | Effect on diagnosis |\n|---|---|\n| `available` | Proceed with symptom-driven diagnosis. |\n| `pending` \u002F `modifying` | An attachment change is in flight. Routing may be unstable; wait for `available`. |\n| `failed` | The attachment itself failed (peering rejected, VPN tunnels down). Treat as root-cause evidence. |\n| `deleting` \u002F `deleted` | The attachment is gone; traffic to its CIDR blackholes. Often an undiscussed Terraform apply. |\n| `rejecting` \u002F `rejected` (peering) | Peer TGW rejected the peering; no traffic will ever flow. |\n\n### Malformed-input fallback\n\nIf the input is missing TGW ID, source\u002Fdestination context, or a\nsymptom description:\n\n```text\nTARGET: \u003Ctgw-id or unknown>\nVERDICT: INSUFFICIENT_DATA\nREASON: Input is missing required context — at minimum a TGW ID, a\n  source attachment (or source VPC + CIDR), a destination attachment\n  (or destination VPC + CIDR), and a symptom description.\nLAYER: UNKNOWN\nEVIDENCE:\n  - Missing: \u003Clist specific missing fields>\nREMEDIATION: Re-prompt the operator for: (1) the TGW ID, (2) the\n  source VPC ID and CIDR, (3) the destination VPC ID and CIDR, (4)\n  whether peering, VPN, or Direct Connect is involved, and (5) the\n  observed symptom.\n```\n\n## Process — Diagnostic decision tree (apply in symptom order)\n\nPick the entry point based on the symptom. Each layer ends with\neither a positive root-cause confirmation (a failing probe that\nmatches the symptom) or a pass that moves to the next layer. **Never\nemit ROOT_CAUSE_IDENTIFIED without a failing probe that matches the\nsymptom.**\n\n### Step 0: Operational gotchas that change diagnosis\n\nAll 11 operational gotchas moved verbatim to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n### Step 1: Symptom entry\n\n| Symptom | Branch |\n|---|---|\n| Source-to-destination traffic blackholes (one direction) | Step 2 |\n| Return traffic blackholes (forward path works) | Step 2c |\n| Traffic reaches the wrong target VPC | Step 3 |\n| TGW peering (cross-TGW) does not forward | Step 4 |\n| Inspection VPC drops cross-AZ flows | Step 5 |\n| VPN\u002FDX routes advertised but VPC cannot reach on-prem | Step 6 |\n| Multicast sender OK, receivers silent | Step 7 |\n| Cross-VPC DNS hostname does not resolve | Step 8 |\n| TGW flow logs empty | Step 8b |\n| Cross-VPC SG reference does not allow traffic | Step 8c |\n| None of the above | Step 9 |\n\n### Step 2: Route table association \u002F propagation\n\nSymptom: traffic leaves VPC-A but never arrives at VPC-B.\n\n#### 2a: Source attachment's associated route table\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf the source attachment has NO association, **ROOT_CAUSE_IDENTIFIED**\nwith `LAYER: TGW_ROUTE_TABLE_ASSOCIATION`. The TGW has no lookup\ntable for its outbound traffic.\n\n#### 2b: Destination CIDR in the associated route table\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf the destination CIDR is NOT present, the destination attachment\nwas not propagated. **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_ROUTE_TABLE_PROPAGATION`.\n\n#### 2c: Return path (destination → source)\n\nThe #1 missed check. The destination VPC's route table must send the\nreply back to the TGW.\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf no route exists for the source CIDR (neither specific nor default\nto the TGW), the reply goes to the IGW or is dropped.\n**ROOT_CAUSE_IDENTIFIED** with `LAYER: VPC_DEFAULT_ROUTE_TGW`.\n\n#### 2d: Default route 0.0.0.0\u002F0 pointing at TGW\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf the default route points at a TransitGatewayId (not `igw-`),\ninternet-bound traffic is blackholed unless the VPC is in a\ncentralized-egress design.\n\n### Step 3: Static route priority \u002F overlapping CIDR\n\nSymptom: traffic reaches the WRONG target VPC.\n\n#### 3a: Static routes overriding propagated\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf a static route exists for the same CIDR as a propagated route and\npoints at a DIFFERENT attachment, the static wins. Traffic goes to\nthe wrong attachment. **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_STATIC_ROUTE_PRIORITY`.\n\n#### 3b: Overlapping CIDR\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf two attachments advertise overlapping CIDRs (e.g.,\n`10.0.0.0\u002F16` and `10.0.1.0\u002F24`), the longest-prefix match wins; the\nbroader CIDR is shadowed for the overlapping portion.\n**ROOT_CAUSE_IDENTIFIED** with `LAYER: TGW_OVERLAPPING_CIDR`. Fix:\nre-CIDR one of the VPCs (no NAT-on-TGW workaround).\n\n### Step 4: TGW peering non-transitivity\n\n#### 4a: Peering attachment state\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\n`pending-acceptance` requires peer acceptance; `rejected` is dead;\n`failed` errored. Only `available` carries traffic.\n\n#### 4b: Route tables on BOTH TGWs\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nRepeat on the remote TGW. If either side lacks the route, traffic is\none-directional.\n\n#### 4c: Transitivity check\n\nIf the operator expects `tgw-a` to reach `tgw-c` through `tgw-b` as\nan intermediate hop, **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_PEERING_NON_TRANSITIVE`. TGW peering is strictly peer-to-\npeer. Establish a direct peering between `tgw-a` and `tgw-c`; there\nis no workaround.\n\n### Step 5: Appliance mode\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf `ApplianceModeSupport` is `disable`, cross-AZ stateful flows are\ndropped. **ROOT_CAUSE_IDENTIFIED** with `LAYER: TGW_APPLIANCE_MODE`.\nFix: enable appliance mode on the inspection VPC's attachment.\n\n### Step 6: VPN \u002F Direct Connect routing\n\n#### 6a: On-prem CIDR in the TGW route table\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf absent, the VPN\u002FDX attachment is not propagating. For VPN: check\n`CustomerGateway` BGP. For DX: check the DX gateway association.\n\n#### 6b: VPN attachment's association\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf the VPN attachment is associated with a different route table than\nthe VPC attachments use for outbound lookups, VPC outbound traffic\nnever finds the on-prem route.\n\n#### 6c: DX gateway association\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf the TGW is not associated with the DX gateway, or the allowed\nprefixes exclude the target CIDR, **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_VPN_DX_ROUTING`.\n\n### Step 7: Multicast domain\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf a receiver's ENI is not in the group, it does not receive. If the\nmulticast domain itself does not exist, **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_MULTICAST_DOMAIN`.\n\n### Step 8: DNS resolution across TGW attachments\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nBoth VPCs need `enableDnsSupport: true` and `enableDnsHostnames:\ntrue`. For cross-VPC resolution, deploy Route 53 Resolver inbound\nendpoints in the destination VPC and outbound endpoints in the\nsource VPC; create a forwarding rule. If absent,\n**ROOT_CAUSE_IDENTIFIED** with `LAYER: TGW_DNS_RESOLUTION`.\n\n### Step 8b: TGW flow logs\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf no flow log is configured, or the IAM role lacks\n`logs:CreateLogStream` \u002F `logs:PutLogEvents`, or the destination\nCloudWatch Logs group does not exist, **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_FLOW_LOGS`.\n\n### Step 8c: Cross-VPC security group references\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf a `UserIdGroupPairs` entry references a GroupId in a different VPC,\nthe reference is invalid for a TGW topology. Cross-VPC SG references\nwork in VPC peering (same region only), not through TGW.\n**ROOT_CAUSE_IDENTIFIED** with `LAYER: TGW_SG_CROSS_VPC`. Fix:\nreplace the cross-VPC SG reference with the peer VPC's CIDR or a\nmanaged prefix list.\n\n### Step 9: UNKNOWN \u002F INSUFFICIENT_DATA\n\n- **INSUFFICIENT_DATA** — A specific probe requires operator input\n  (the remote TGW's route table for a cross-account peering, the\n  on-prem BGP status, the destination VPC's route table). List the\n  missing pieces and the next probe to run once the info is\n  available.\n- **UNKNOWN** — All probes passed and the symptom persists. Escalate\n  to AWS Support with the TGW ID, the source\u002Fdestination attachment\n  IDs, a Reachability Analysis output, and the observed symptom.\n\n## Output format\n\n```text\nTARGET: \u003Ctgw-id, source-attachment, destination-attachment>\nVERDICT: ROOT_CAUSE_IDENTIFIED | INSUFFICIENT_DATA\nREASON: \u003C1-2 sentences naming the failed layer and the failing probe>\nLAYER: \u003CTGW_ROUTE_TABLE_ASSOCIATION | TGW_ROUTE_TABLE_PROPAGATION |\n        TGW_STATIC_ROUTE_PRIORITY | TGW_OVERLAPPING_CIDR |\n        TGW_PEERING_NON_TRANSITIVE | TGW_VPN_DX_ROUTING |\n        TGW_MULTICAST_DOMAIN | TGW_FLOW_LOGS |\n        VPC_DEFAULT_ROUTE_TGW | TGW_ATTACHMENT_WRONG_SUBNET |\n        TGW_SG_CROSS_VPC | TGW_DNS_RESOLUTION |\n        TGW_APPLIANCE_MODE | TGW_BLACKHOLE_ROUTE | UNKNOWN>\nEVIDENCE:\n  - \u003Cobserved symptom — error string or packet-flow behaviour>\n  - \u003Cfailing probe — command and its output that confirms the cause>\n  - \u003Cpassing probes — layers ruled out>\nREMEDIATION:\n  1. \u003Cspecific action with CLI command>\n  2. \u003Cverification command after the fix>\nCONFIRM: Before executing any state-changing CLI, emit and await operator\n  approval: \"CONFIRM: About to \u003Caction> on \u003Ctgw-id> in \u003Cregion>. Proceed?\n  (yes\u002Fno)\"\n```\n\n### Worked example — Static route overrides propagated route\n\n```text\nTARGET: tgw-aaa (source: tgw-attach-vpc-a, dest: tgw-attach-vpc-b)\nVERDICT: ROOT_CAUSE_IDENTIFIED\nREASON: VPC-A's associated TGW route table tgw-rtb-default contains a\n  static route for 10.20.0.0\u002F16 pointing at tgw-attach-vpc-c (a legacy\n  attachment from a prior migration), which overrides the propagated\n  route from VPC-B's attachment. VPC-A's outbound traffic for VPC-B's\n  CIDR is forwarded to VPC-C, where it is dropped (Step 3a).\nLAYER: TGW_STATIC_ROUTE_PRIORITY\nEVIDENCE:\n  - Symptom: EC2 i-aaa in VPC-A (10.10.0.0\u002F16) cannot ping EC2 i-bbb\n    in VPC-B (10.20.0.0\u002F16). ICMP \"request timeout\". i-bbb never\n    sees the packet in its VPC flow logs.\n  - Probe: aws ec2 search-transit-gateway-routes on tgw-rtb-default\n    with type=static returns:\n      10.20.0.0\u002F16 → tgw-attach-vpc-c (static, active)\n  - Probe: aws ec2 search-transit-gateway-routes with type=propagated\n    returns:\n      10.20.0.0\u002F16 → tgw-attach-vpc-b (propagated, active — but\n      shadowed by the static route)\n  - Passing: VPC-A's route table has 10.20.0.0\u002F16 → tgw-aaa; VPC-B's\n    return route table has 10.10.0.0\u002F16 → tgw-aaa; CIDRs do not\n    overlap.\nREMEDIATION:\n  1. Delete the stale static route:\n     aws ec2 delete-transit-gateway-route \\\n       --transit-gateway-route-table-id tgw-rtb-default \\\n       --destination-cidr-block 10.20.0.0\u002F16\n  2. Verify the propagated route becomes the active forwarding route:\n     aws ec2 search-transit-gateway-routes \\\n       --transit-gateway-route-table-id tgw-rtb-default \\\n       --filters Name=state,Values=active\nCONFIRM: Before deleting the route, emit and await:\n  \"CONFIRM: About to delete static route 10.20.0.0\u002F16 from\n   tgw-rtb-default. Proceed? (yes\u002Fno)\"\n```\n\n### Worked example — Appliance mode disabled\n\nFull appliance-mode-disabled worked example moved verbatim to [references\u002Fworked-examples.md](references\u002Fworked-examples.md).\n\n## Anti-Patterns — NEVER\n\n- NEVER declare ROOT_CAUSE_IDENTIFIED without a failing probe that\n  matches the symptom. A \"process of elimination\" diagnosis erodes\n  operator trust when the real cause is elsewhere.\n- NEVER diagnose only the forward path. Routing is bidirectional. A\n  one-way ping that times out is just as likely a missing return\n  route in the destination VPC as a missing forward route in the TGW.\n- NEVER assume \"both VPCs are attached to the TGW\" means traffic\n  will flow. Attachment is necessary but not sufficient — association\n  AND propagation are independent controls.\n- NEVER assume TGW peering is transitive. Each pair of TGWs that\n  needs to exchange traffic requires a direct peering attachment.\n- NEVER use a cross-VPC security group reference through a TGW. Unlike\n  VPC peering (same region), TGW does NOT support cross-VPC SG\n  references. Use a CIDR block, a managed prefix list, or a same-VPC\n  SG reference.\n- NEVER point a VPC's default route `0.0.0.0\u002F0` at the TGW unless the\n  VPC is in a centralized-egress design with a dedicated egress VPC.\n- NEVER expect multicast to \"just work\" on a TGW. Multicast requires a\n  dedicated multicast domain, members are statically added by ENI, and\n  IGMP is not supported.\n- NEVER confuse TGW flow logs with VPC flow logs. TGW flow logs show\n  the TGW's view; VPC flow logs show the VPC's view. Correlate both\n  for end-to-end debugging.\n- NEVER enable appliance mode on a non-inspection attachment. It adds\n  an unnecessary cross-AZ hop and increases latency for all flows\n  transiting that attachment.\n- NEVER assume overlapping CIDRs are routable on a TGW. TGW uses\n  longest-prefix match; the broader CIDR is shadowed. There is no\n  NAT-on-TGW. Re-CIDR one of the VPCs.\n- NEVER conclude \"the TGW is broken\" without checking AWS Health.\n  Regional TGW degradation can mimic a route-table issue; always run\n  `aws health describe-events` if multiple attachments fail\n  simultaneously with no config change.\n- NEVER perform state-changing operations as diagnostic probes. Every\n  probe in this skill is read-only. State changes are remediations,\n  gated behind CONFIRM.\n\n## Pre-flight safety checks (run before any state-changing CLI)\n\n- **MANDATORY CONFIRMATION GATE.** Before any state-changing operation\n  (`modify-transit-gateway-attachment`,\n  `delete-transit-gateway-route`, `create-transit-gateway-route`,\n  `associate-transit-gateway-route-table`,\n  `enable-transit-gateway-route-table-propagation`), emit and await\n  operator approval.\n- **Read-only first.** Every probe is read-only.\n- **Deleting a static route** is reversible (re-create with\n  `create-transit-gateway-route`). Verify the propagated route takes\n  effect immediately after the delete.\n- **Enabling appliance mode** takes effect within seconds but causes a\n  brief traffic disruption on existing flows through the inspection\n  attachment. Plan outside a traffic peak.\n- **Creating a TGW peering** requires the peer TGW's owner to accept.\n  Cross-account\u002Fcross-region peerings can take minutes to reach\n  `available`.\n- **Associating an attachment with a different route table**\n  immediately affects outbound routing for that attachment. Verify\n  the new route table has all necessary propagated routes before\n  switching.\n- **Bulk remediation batch limit.** Batch into groups of at most 5\n  attachments, emit a single CONFIRM per batch, verify between\n  batches.\n\n## Remediation guidance (command index)\n\nThe 12-entry remediation command index moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nSee `references\u002Ftgw-routing-reference.md` for the full command index\nand `references\u002Ftgw-attachment-and-appliance-mode.md` for attachment-\ntype and appliance-mode detail.\n\n## References (load on demand)\n\n- [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md) — pre-flight gather commands, every per-step probe CLI (Steps 2-8c), and the remediation command index\n- [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md) — Philosophy four behaviours and Step 0 operational gotchas\n- [references\u002Fworked-examples.md](references\u002Fworked-examples.md) — Appliance-mode-disabled worked example\n- [references\u002Ftgw-routing-reference.md](references\u002Ftgw-routing-reference.md) — full TGW routing command index\n- [references\u002Ftgw-attachment-and-appliance-mode.md](references\u002Ftgw-attachment-and-appliance-mode.md) — attachment types and appliance-mode detail\n\n## Domain\n\nAWS CloudOps \u002F Transit Gateway Networking, Routing Diagnostics,\nInter-VPC and Cross-Region Connectivity, Appliance-Mode Inspection,\nand Peering Topology.\n\n## AWS documentation\n\n- **AWS Transit Gateway User Guide** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002F\n- **TGW route tables** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Ftgw-route-tables.html\n- **TGW appliance mode** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Fappliance-mode.html\n- **TGW peering attachments** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Ftgw-peering.html\n- **TGW multicast domain** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Ftgw-multicast-overview.html\n- **TGW flow logs** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Ftgw-flow-logs.html\n- **TGW VPN attachments** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Ftgw-vpn-attachments.html\n- **TGW Direct Connect gateway associations** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fdirectconnect\u002Flatest\u002FUserGuide\u002Fdirect-connect-gateways-intro.html\n- **Route 53 Resolver** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Fresolver.html\n- **AWS Health** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fhealth\u002Flatest\u002Fug\u002F\n","# Transit Gateway Routing Troubleshooter\n\n## Quick start\n\n- **Symptom → layer map (first plausible match drives the first probe):**\n  Traffic exits source VPC but never arrives at destination VPC →\n  TGW_ROUTE_TABLE_ASSOCIATION \u002F TGW_ROUTE_TABLE_PROPAGATION \u002F\n  VPC_DEFAULT_ROUTE_TGW (return path); traffic reaches the wrong VPC\n  → TGW_STATIC_ROUTE_PRIORITY \u002F TGW_OVERLAPPING_CIDR; TGW peering\n  between two TGWs forwards one way but not the other →\n  TGW_PEERING_NON_TRANSITIVE; cross-AZ return traffic through an\n  inspection VPC is dropped → TGW_APPLIANCE_MODE; VPN\u002FDX advertises\n  routes but VPC cannot reach on-prem → TGW_VPN_DX_ROUTING; multicast\n  sender works but receivers see nothing → TGW_MULTICAST_DOMAIN;\n  cross-VPC DNS hostname resolution fails → TGW_DNS_RESOLUTION;\n  TGW flow logs are empty → TGW_FLOW_LOGS.\n- **Always verify with a read-only probe, never guess.** Each layer\n  has a single command that proves or disproves it. A\n  ROOT_CAUSE_IDENTIFIED verdict requires positive evidence — a\n  failing probe that matches the symptom — not a process of\n  elimination.\n- **Route table association and propagation are SEPARATE controls.**\n  Associating an attachment with a TGW route table determines which\n  route table that attachment LOOKS UP routes in. Propagating an\n  attachment into a route table determines which route table LEARNS\n  that attachment's CIDR. An attachment can be associated with one\n  route table and propagate into many. Operators who \"added the VPC\n  to the TGW\" but never propagated the attachment into the peer's\n  route table produce a one-way blackhole.\n- **Static routes ALWAYS beat propagated routes in the same TGW route\n  table.** A `search-transit-gateway-routes` result showing a static\n  `10.20.0.0\u002F16 → tgw-attach-wrong` entry explains why the\n  auto-propagated `10.20.0.0\u002F16 → tgw-attach-correct` route never\n  wins. This is the #1 misdiagnosis in TGW incidents.\n- **TGW peering is strictly non-transitive.** If `tgw-a` peers with\n  `tgw-b`, and `tgw-b` peers with `tgw-c`, traffic from an attachment\n  on `tgw-a` CANNOT reach an attachment on `tgw-c` through `tgw-b` as\n  a hop. Each pair of TGWs that needs to exchange traffic requires a\n  direct peering attachment. There is no \"transitive peering\" feature.\n- **Appliance mode forces cross-AZ return traffic through the\n  inspection VPC.** Without appliance mode, TGW preserves the source\n  AZ. A stateful inspection appliance in `us-east-1a` never sees the\n  `us-east-1b` return traffic and drops the flow. Enabling appliance\n  mode on the inspection VPC attachment routes the return through the\n  appliance's AZ regardless of the original source AZ.\n\n## Mindset\n\nA TGW routing incident is almost always a route-table control-plane\nproblem wearing a \"network is broken\" costume. The TGW data plane\nforwards packets along the routes it has learned; the failure is\nupstream of forwarding — in association, propagation, static-route\npriority, appliance mode, or overlapping CIDR. Senior network\nengineers do not start by running packet captures; they start with\n`search-transit-gateway-routes` and the route table associations on\nboth the source and destination attachments.\n\n## Philosophy\n\nThe four Philosophy behaviours moved verbatim to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n## Quick reference — symptom triage table\n\n| Symptom phrase \u002F observation | Most likely layer | First probe |\n|---|---|---|\n| Source VPC route table has `10.20.0.0\u002F16 → tgw-aaa`, traffic leaves but never arrives | TGW_ROUTE_TABLE_ASSOCIATION \u002F TGW_ROUTE_TABLE_PROPAGATION \u002F VPC_DEFAULT_ROUTE_TGW (return path) | `get-transit-gateway-route-table-associations`, `search-transit-gateway-routes` for the destination CIDR |\n| Traffic reaches the WRONG VPC; ping returns a host that is not the intended target | TGW_STATIC_ROUTE_PRIORITY \u002F TGW_OVERLAPPING_CIDR | `search-transit-gateway-routes --filter type=static` |\n| TGW peering between two regions: one direction works, reverse does not | TGW_PEERING_NON_TRANSITIVE (or one side missing a static\u002Fpropagated route) | `describe-transit-gateway-peering-attachments` on both TGWs; route tables on both sides |\n| Cross-AZ stateful firewall \u002F inspection appliance drops flows intermittently | TGW_APPLIANCE_MODE | `describe-transit-gateway-attachments` (ApplianceMode on the inspection attachment) |\n| VPN or Direct Connect advertises routes into TGW but VPC cannot reach on-prem | TGW_VPN_DX_ROUTING | `search-transit-gateway-routes` for the on-prem CIDR; VPN CGW configuration |\n| Multicast sender succeeds; receivers see nothing | TGW_MULTICAST_DOMAIN | `describe-transit-gateway-multicast-domains`, `search-transit-gateway-multicast-groups` |\n| Cross-VPC DNS hostname (e.g. `service.vpc-b`) does not resolve from VPC-A | TGW_DNS_RESOLUTION | VPC `enableDnsHostnames` \u002F `enableDnsSupport`, Route 53 Resolver endpoints |\n| TGW flow logs are empty even though traffic is flowing | TGW_FLOW_LOGS | `describe-flow-logs --resource-type transit-gateway`, IAM role for the flow log |\n| Cross-VPC security group rule with peer-VPC SG reference does not allow traffic | TGW_SG_CROSS_VPC | `describe-security-groups` (the source reference is invalid cross-VPC) |\n| None of the above, intermittent loss | UNKNOWN | Reachability Analyzer, TGW flow logs, VPC flow logs |\n\n## Pre-flight: TGW state and gather-info gate\n\nBefore symptom-specific probes, gather the canonical TGW topology\nand short-circuit on attachment states that mimic routing failures.\n\n### Pre-flight commands\n\nThe pre-flight gather commands moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\n### Attachment-state short-circuit\n\n| `State` | Effect on diagnosis |\n|---|---|\n| `available` | Proceed with symptom-driven diagnosis. |\n| `pending` \u002F `modifying` | An attachment change is in flight. Routing may be unstable; wait for `available`. |\n| `failed` | The attachment itself failed (peering rejected, VPN tunnels down). Treat as root-cause evidence. |\n| `deleting` \u002F `deleted` | The attachment is gone; traffic to its CIDR blackholes. Often an undiscussed Terraform apply. |\n| `rejecting` \u002F `rejected` (peering) | Peer TGW rejected the peering; no traffic will ever flow. |\n\n### Malformed-input fallback\n\nIf the input is missing TGW ID, source\u002Fdestination context, or a\nsymptom description:\n\n```text\nTARGET: \u003Ctgw-id or unknown>\nVERDICT: INSUFFICIENT_DATA\nREASON: Input is missing required context — at minimum a TGW ID, a\n  source attachment (or source VPC + CIDR), a destination attachment\n  (or destination VPC + CIDR), and a symptom description.\nLAYER: UNKNOWN\nEVIDENCE:\n  - Missing: \u003Clist specific missing fields>\nREMEDIATION: Re-prompt the operator for: (1) the TGW ID, (2) the\n  source VPC ID and CIDR, (3) the destination VPC ID and CIDR, (4)\n  whether peering, VPN, or Direct Connect is involved, and (5) the\n  observed symptom.\n```\n\n## Process — Diagnostic decision tree (apply in symptom order)\n\nPick the entry point based on the symptom. Each layer ends with\neither a positive root-cause confirmation (a failing probe that\nmatches the symptom) or a pass that moves to the next layer. **Never\nemit ROOT_CAUSE_IDENTIFIED without a failing probe that matches the\nsymptom.**\n\n### Step 0: Operational gotchas that change diagnosis\n\nAll 11 operational gotchas moved verbatim to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n### Step 1: Symptom entry\n\n| Symptom | Branch |\n|---|---|\n| Source-to-destination traffic blackholes (one direction) | Step 2 |\n| Return traffic blackholes (forward path works) | Step 2c |\n| Traffic reaches the wrong target VPC | Step 3 |\n| TGW peering (cross-TGW) does not forward | Step 4 |\n| Inspection VPC drops cross-AZ flows | Step 5 |\n| VPN\u002FDX routes advertised but VPC cannot reach on-prem | Step 6 |\n| Multicast sender OK, receivers silent | Step 7 |\n| Cross-VPC DNS hostname does not resolve | Step 8 |\n| TGW flow logs empty | Step 8b |\n| Cross-VPC SG reference does not allow traffic | Step 8c |\n| None of the above | Step 9 |\n\n### Step 2: Route table association \u002F propagation\n\nSymptom: traffic leaves VPC-A but never arrives at VPC-B.\n\n#### 2a: Source attachment's associated route table\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf the source attachment has NO association, **ROOT_CAUSE_IDENTIFIED**\nwith `LAYER: TGW_ROUTE_TABLE_ASSOCIATION`. The TGW has no lookup\ntable for its outbound traffic.\n\n#### 2b: Destination CIDR in the associated route table\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf the destination CIDR is NOT present, the destination attachment\nwas not propagated. **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_ROUTE_TABLE_PROPAGATION`.\n\n#### 2c: Return path (destination → source)\n\nThe #1 missed check. The destination VPC's route table must send the\nreply back to the TGW.\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf no route exists for the source CIDR (neither specific nor default\nto the TGW), the reply goes to the IGW or is dropped.\n**ROOT_CAUSE_IDENTIFIED** with `LAYER: VPC_DEFAULT_ROUTE_TGW`.\n\n#### 2d: Default route 0.0.0.0\u002F0 pointing at TGW\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf the default route points at a TransitGatewayId (not `igw-`),\ninternet-bound traffic is blackholed unless the VPC is in a\ncentralized-egress design.\n\n### Step 3: Static route priority \u002F overlapping CIDR\n\nSymptom: traffic reaches the WRONG target VPC.\n\n#### 3a: Static routes overriding propagated\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf a static route exists for the same CIDR as a propagated route and\npoints at a DIFFERENT attachment, the static wins. Traffic goes to\nthe wrong attachment. **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_STATIC_ROUTE_PRIORITY`.\n\n#### 3b: Overlapping CIDR\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf two attachments advertise overlapping CIDRs (e.g.,\n`10.0.0.0\u002F16` and `10.0.1.0\u002F24`), the longest-prefix match wins; the\nbroader CIDR is shadowed for the overlapping portion.\n**ROOT_CAUSE_IDENTIFIED** with `LAYER: TGW_OVERLAPPING_CIDR`. Fix:\nre-CIDR one of the VPCs (no NAT-on-TGW workaround).\n\n### Step 4: TGW peering non-transitivity\n\n#### 4a: Peering attachment state\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\n`pending-acceptance` requires peer acceptance; `rejected` is dead;\n`failed` errored. Only `available` carries traffic.\n\n#### 4b: Route tables on BOTH TGWs\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nRepeat on the remote TGW. If either side lacks the route, traffic is\none-directional.\n\n#### 4c: Transitivity check\n\nIf the operator expects `tgw-a` to reach `tgw-c` through `tgw-b` as\nan intermediate hop, **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_PEERING_NON_TRANSITIVE`. TGW peering is strictly peer-to-\npeer. Establish a direct peering between `tgw-a` and `tgw-c`; there\nis no workaround.\n\n### Step 5: Appliance mode\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf `ApplianceModeSupport` is `disable`, cross-AZ stateful flows are\ndropped. **ROOT_CAUSE_IDENTIFIED** with `LAYER: TGW_APPLIANCE_MODE`.\nFix: enable appliance mode on the inspection VPC's attachment.\n\n### Step 6: VPN \u002F Direct Connect routing\n\n#### 6a: On-prem CIDR in the TGW route table\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf absent, the VPN\u002FDX attachment is not propagating. For VPN: check\n`CustomerGateway` BGP. For DX: check the DX gateway association.\n\n#### 6b: VPN attachment's association\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf the VPN attachment is associated with a different route table than\nthe VPC attachments use for outbound lookups, VPC outbound traffic\nnever finds the on-prem route.\n\n#### 6c: DX gateway association\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf the TGW is not associated with the DX gateway, or the allowed\nprefixes exclude the target CIDR, **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_VPN_DX_ROUTING`.\n\n### Step 7: Multicast domain\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf a receiver's ENI is not in the group, it does not receive. If the\nmulticast domain itself does not exist, **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_MULTICAST_DOMAIN`.\n\n### Step 8: DNS resolution across TGW attachments\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nBoth VPCs need `enableDnsSupport: true` and `enableDnsHostnames:\ntrue`. For cross-VPC resolution, deploy Route 53 Resolver inbound\nendpoints in the destination VPC and outbound endpoints in the\nsource VPC; create a forwarding rule. If absent,\n**ROOT_CAUSE_IDENTIFIED** with `LAYER: TGW_DNS_RESOLUTION`.\n\n### Step 8b: TGW flow logs\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf no flow log is configured, or the IAM role lacks\n`logs:CreateLogStream` \u002F `logs:PutLogEvents`, or the destination\nCloudWatch Logs group does not exist, **ROOT_CAUSE_IDENTIFIED** with\n`LAYER: TGW_FLOW_LOGS`.\n\n### Step 8c: Cross-VPC security group references\n\nProbe CLI moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf a `UserIdGroupPairs` entry references a GroupId in a different VPC,\nthe reference is invalid for a TGW topology. Cross-VPC SG references\nwork in VPC peering (same region only), not through TGW.\n**ROOT_CAUSE_IDENTIFIED** with `LAYER: TGW_SG_CROSS_VPC`. Fix:\nreplace the cross-VPC SG reference with the peer VPC's CIDR or a\nmanaged prefix list.\n\n### Step 9: UNKNOWN \u002F INSUFFICIENT_DATA\n\n- **INSUFFICIENT_DATA** — A specific probe requires operator input\n  (the remote TGW's route table for a cross-account peering, the\n  on-prem BGP status, the destination VPC's route table). List the\n  missing pieces and the next probe to run once the info is\n  available.\n- **UNKNOWN** — All probes passed and the symptom persists. Escalate\n  to AWS Support with the TGW ID, the source\u002Fdestination attachment\n  IDs, a Reachability Analysis output, and the observed symptom.\n\n## Output format\n\n```text\nTARGET: \u003Ctgw-id, source-attachment, destination-attachment>\nVERDICT: ROOT_CAUSE_IDENTIFIED | INSUFFICIENT_DATA\nREASON: \u003C1-2 sentences naming the failed layer and the failing probe>\nLAYER: \u003CTGW_ROUTE_TABLE_ASSOCIATION | TGW_ROUTE_TABLE_PROPAGATION |\n        TGW_STATIC_ROUTE_PRIORITY | TGW_OVERLAPPING_CIDR |\n        TGW_PEERING_NON_TRANSITIVE | TGW_VPN_DX_ROUTING |\n        TGW_MULTICAST_DOMAIN | TGW_FLOW_LOGS |\n        VPC_DEFAULT_ROUTE_TGW | TGW_ATTACHMENT_WRONG_SUBNET |\n        TGW_SG_CROSS_VPC | TGW_DNS_RESOLUTION |\n        TGW_APPLIANCE_MODE | TGW_BLACKHOLE_ROUTE | UNKNOWN>\nEVIDENCE:\n  - \u003Cobserved symptom — error string or packet-flow behaviour>\n  - \u003Cfailing probe — command and its output that confirms the cause>\n  - \u003Cpassing probes — layers ruled out>\nREMEDIATION:\n  1. \u003Cspecific action with CLI command>\n  2. \u003Cverification command after the fix>\nCONFIRM: Before executing any state-changing CLI, emit and await operator\n  approval: \"CONFIRM: About to \u003Caction> on \u003Ctgw-id> in \u003Cregion>. Proceed?\n  (yes\u002Fno)\"\n```\n\n### Worked example — Static route overrides propagated route\n\n```text\nTARGET: tgw-aaa (source: tgw-attach-vpc-a, dest: tgw-attach-vpc-b)\nVERDICT: ROOT_CAUSE_IDENTIFIED\nREASON: VPC-A's associated TGW route table tgw-rtb-default contains a\n  static route for 10.20.0.0\u002F16 pointing at tgw-attach-vpc-c (a legacy\n  attachment from a prior migration), which overrides the propagated\n  route from VPC-B's attachment. VPC-A's outbound traffic for VPC-B's\n  CIDR is forwarded to VPC-C, where it is dropped (Step 3a).\nLAYER: TGW_STATIC_ROUTE_PRIORITY\nEVIDENCE:\n  - Symptom: EC2 i-aaa in VPC-A (10.10.0.0\u002F16) cannot ping EC2 i-bbb\n    in VPC-B (10.20.0.0\u002F16). ICMP \"request timeout\". i-bbb never\n    sees the packet in its VPC flow logs.\n  - Probe: aws ec2 search-transit-gateway-routes on tgw-rtb-default\n    with type=static returns:\n      10.20.0.0\u002F16 → tgw-attach-vpc-c (static, active)\n  - Probe: aws ec2 search-transit-gateway-routes with type=propagated\n    returns:\n      10.20.0.0\u002F16 → tgw-attach-vpc-b (propagated, active — but\n      shadowed by the static route)\n  - Passing: VPC-A's route table has 10.20.0.0\u002F16 → tgw-aaa; VPC-B's\n    return route table has 10.10.0.0\u002F16 → tgw-aaa; CIDRs do not\n    overlap.\nREMEDIATION:\n  1. Delete the stale static route:\n     aws ec2 delete-transit-gateway-route \\\n       --transit-gateway-route-table-id tgw-rtb-default \\\n       --destination-cidr-block 10.20.0.0\u002F16\n  2. Verify the propagated route becomes the active forwarding route:\n     aws ec2 search-transit-gateway-routes \\\n       --transit-gateway-route-table-id tgw-rtb-default \\\n       --filters Name=state,Values=active\nCONFIRM: Before deleting the route, emit and await:\n  \"CONFIRM: About to delete static route 10.20.0.0\u002F16 from\n   tgw-rtb-default. Proceed? (yes\u002Fno)\"\n```\n\n### Worked example — Appliance mode disabled\n\nFull appliance-mode-disabled worked example moved verbatim to [references\u002Fworked-examples.md](references\u002Fworked-examples.md).\n\n## Anti-Patterns — NEVER\n\n- NEVER declare ROOT_CAUSE_IDENTIFIED without a failing probe that\n  matches the symptom. A \"process of elimination\" diagnosis erodes\n  operator trust when the real cause is elsewhere.\n- NEVER diagnose only the forward path. Routing is bidirectional. A\n  one-way ping that times out is just as likely a missing return\n  route in the destination VPC as a missing forward route in the TGW.\n- NEVER assume \"both VPCs are attached to the TGW\" means traffic\n  will flow. Attachment is necessary but not sufficient — association\n  AND propagation are independent controls.\n- NEVER assume TGW peering is transitive. Each pair of TGWs that\n  needs to exchange traffic requires a direct peering attachment.\n- NEVER use a cross-VPC security group reference through a TGW. Unlike\n  VPC peering (same region), TGW does NOT support cross-VPC SG\n  references. Use a CIDR block, a managed prefix list, or a same-VPC\n  SG reference.\n- NEVER point a VPC's default route `0.0.0.0\u002F0` at the TGW unless the\n  VPC is in a centralized-egress design with a dedicated egress VPC.\n- NEVER expect multicast to \"just work\" on a TGW. Multicast requires a\n  dedicated multicast domain, members are statically added by ENI, and\n  IGMP is not supported.\n- NEVER confuse TGW flow logs with VPC flow logs. TGW flow logs show\n  the TGW's view; VPC flow logs show the VPC's view. Correlate both\n  for end-to-end debugging.\n- NEVER enable appliance mode on a non-inspection attachment. It adds\n  an unnecessary cross-AZ hop and increases latency for all flows\n  transiting that attachment.\n- NEVER assume overlapping CIDRs are routable on a TGW. TGW uses\n  longest-prefix match; the broader CIDR is shadowed. There is no\n  NAT-on-TGW. Re-CIDR one of the VPCs.\n- NEVER conclude \"the TGW is broken\" without checking AWS Health.\n  Regional TGW degradation can mimic a route-table issue; always run\n  `aws health describe-events` if multiple attachments fail\n  simultaneously with no config change.\n- NEVER perform state-changing operations as diagnostic probes. Every\n  probe in this skill is read-only. State changes are remediations,\n  gated behind CONFIRM.\n\n## Pre-flight safety checks (run before any state-changing CLI)\n\n- **MANDATORY CONFIRMATION GATE.** Before any state-changing operation\n  (`modify-transit-gateway-attachment`,\n  `delete-transit-gateway-route`, `create-transit-gateway-route`,\n  `associate-transit-gateway-route-table`,\n  `enable-transit-gateway-route-table-propagation`), emit and await\n  operator approval.\n- **Read-only first.** Every probe is read-only.\n- **Deleting a static route** is reversible (re-create with\n  `create-transit-gateway-route`). Verify the propagated route takes\n  effect immediately after the delete.\n- **Enabling appliance mode** takes effect within seconds but causes a\n  brief traffic disruption on existing flows through the inspection\n  attachment. Plan outside a traffic peak.\n- **Creating a TGW peering** requires the peer TGW's owner to accept.\n  Cross-account\u002Fcross-region peerings can take minutes to reach\n  `available`.\n- **Associating an attachment with a different route table**\n  immediately affects outbound routing for that attachment. Verify\n  the new route table has all necessary propagated routes before\n  switching.\n- **Bulk remediation batch limit.** Batch into groups of at most 5\n  attachments, emit a single CONFIRM per batch, verify between\n  batches.\n\n## Remediation guidance (command index)\n\nThe 12-entry remediation command index moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nSee `references\u002Ftgw-routing-reference.md` for the full command index\nand `references\u002Ftgw-attachment-and-appliance-mode.md` for attachment-\ntype and appliance-mode detail.\n\n## References (load on demand)\n\n- [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md) — pre-flight gather commands, every per-step probe CLI (Steps 2-8c), and the remediation command index\n- [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md) — Philosophy four behaviours and Step 0 operational gotchas\n- [references\u002Fworked-examples.md](references\u002Fworked-examples.md) — Appliance-mode-disabled worked example\n- [references\u002Ftgw-routing-reference.md](references\u002Ftgw-routing-reference.md) — full TGW routing command index\n- [references\u002Ftgw-attachment-and-appliance-mode.md](references\u002Ftgw-attachment-and-appliance-mode.md) — attachment types and appliance-mode detail\n\n## Domain\n\nAWS CloudOps \u002F Transit Gateway Networking, Routing Diagnostics,\nInter-VPC and Cross-Region Connectivity, Appliance-Mode Inspection,\nand Peering Topology.\n\n## AWS documentation\n\n- **AWS Transit Gateway User Guide** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002F\n- **TGW route tables** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Ftgw-route-tables.html\n- **TGW appliance mode** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Fappliance-mode.html\n- **TGW peering attachments** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Ftgw-peering.html\n- **TGW multicast domain** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Ftgw-multicast-overview.html\n- **TGW flow logs** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Ftgw-flow-logs.html\n- **TGW VPN attachments** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fvpc\u002Flatest\u002Ftgw\u002Ftgw-vpn-attachments.html\n- **TGW Direct Connect gateway associations** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fdirectconnect\u002Flatest\u002FUserGuide\u002Fdirect-connect-gateways-intro.html\n- **Route 53 Resolver** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Fresolver.html\n- **AWS Health** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fhealth\u002Flatest\u002Fug\u002F\n",{"name":5,"license":15,"metadata":24,"description":7,"compatibility":44},{"tags":25,"phase":26,"author":27,"domain":28,"family":29,"version":30,"keywords":31,"task_type":32,"complexity":33,"entry_point":34,"skill_class":35,"when_to_use":36,"requires_llm":37,"verdict_shape":38,"when_not_to_use":39,"lifecycle_status":40,"invocation_schema":41,"supports_pipeline":37,"invocation_example":42,"activation_triggers":43},"transit-gateway, networking, troubleshooting, routing, tgw, peering, vpn, direct-connect, appliance-mode, multicast","2","Jacky Chan — AWS Community Builder","aws-cloudops","Networking","0.1.0","Transit Gateway, TGW, route table, association, propagation, static route, propagated route, overlapping CIDR, peering attachment, non-transitive, VPN, Direct Connect, multicast domain, flow logs, default route, appliance mode, inspection VPC, blackhole, security group, cross-VPC, DNS resolution, troubleshooting","troubleshoot","high","false","capability","Diagnosing a Transit Gateway routing failure (traffic from one attached VPC never reaches another attached VPC, traffic takes the wrong path, traffic is asymmetrically dropped, peering between two TGWs does not forward, VPN\u002FDX routing through TGW is broken, multicast traffic does not reach all members, appliance-mode inspection VPC drops cross-AZ return traffic, or a default route 0.0\u002F0 pointing at the TGW produces a blackhole). Use when the symptom is \"VPC-A cannot reach VPC-B through the transit gateway\" and the cause may be route table association\u002Fpropagation, static-route priority, overlapping CIDR, non-transitive peering, wrong-subnet attachment, missing appliance mode, or a missing TGW route table entry.","true","ROOT_CAUSE_IDENTIFIED | INSUFFICIENT_DATA","Provisioning a new TGW or attachment (use transit-gateway-deployer), VPC peering (non-TGW) connectivity (use vpc-peering-deployer), VPC endpoint \u002F PrivateLink connectivity inside a single VPC (use vpc-connectivity-troubleshooter), or TGW cost \u002F capacity posture audits (use networkmanager-core-network-auditor). This skill diagnoses routing failures at runtime; it does not provision or audit steady-state posture.","active","Input: either (a) a symptom description (\"VPC-A cannot reach VPC-B through TGW\", \"traffic exits VPC-A but never arrives at VPC-B\", \"TGW peering between two regions does not forward\"), optionally paired with the TGW topology (attachment IDs, VPC CIDRs, route table IDs), OR (b) a TGW ID plus the source\u002Fdestination VPC IDs and observed packet-flow symptom for live-account diagnosis. Output: a deterministic TARGET\u002FVERDICT\u002FREASON\u002FLAYER\u002FEVIDENCE\u002FREMEDIATION block where VERDICT ∈ {ROOT_CAUSE_IDENTIFIED, INSUFFICIENT_DATA} and LAYER ∈ {TGW_ROUTE_TABLE_ASSOCIATION, TGW_ROUTE_TABLE_PROPAGATION, TGW_STATIC_ROUTE_PRIORITY, TGW_OVERLAPPING_CIDR, TGW_PEERING_NON_TRANSITIVE, TGW_VPN_DX_ROUTING, TGW_MULTICAST_DOMAIN, TGW_FLOW_LOGS, VPC_DEFAULT_ROUTE_TGW, TGW_ATTACHMENT_WRONG_SUBNET, TGW_SG_CROSS_VPC, TGW_DNS_RESOLUTION, TGW_APPLIANCE_MODE, TGW_BLACKHOLE_ROUTE, UNKNOWN}.","# Minimal valid input (offline symptom classification):\nSymptom: \"EC2 instance i-aaa in VPC vpc-a (10.10.0.0\u002F16, us-east-1)\ncannot reach EC2 instance i-bbb in VPC vpc-b (10.20.0.0\u002F16, us-east-1)\nthrough transit gateway tgw-aaa. The ping times out. Both VPCs are\nattached to the TGW; the VPC-A route table has 10.20.0.0\u002F16 → tgw-aaa.\"\nTGW: tgw-aaa\nAttachment A: tgw-attach-aaa (VPC vpc-a, subnet subnet-a-aaa, AZ us-east-1a)\nAttachment B: tgw-attach-bbb (VPC vpc-b, subnet subnet-b-aaa, AZ us-east-1a)\nVPC-A route table: 10.20.0.0\u002F16 → tgw-aaa\nVPC-B route table: (default route 0.0.0.0\u002F0 → igw-bbb; no entry for 10.10.0.0\u002F16)","VPC cannot reach VPC through transit gateway, TGW traffic blackhole, TGW route table missing entry, TGW static route overrides propagated, transit gateway peering non-transitive, TGW appliance mode cross-AZ return, TGW overlapping CIDR, TGW default route 0.0.0.0\u002F0, TGW attachment wrong subnet, TGW VPN routing, TGW Direct Connect routing, TGW multicast not received, TGW DNS resolution across attachments, TGW flow logs missing, security group cross-VPC TGW, troubleshoot transit gateway routing","Agent runtime that reads SKILL.md (Claude Code, Cursor, Windsurf, Codex, Gemini). Offline symptom classification works from pasted topology and error messages. Live-account diagnosis uses aws ec2 describe-transit-gateways, describe-transit-gateway-attachments, describe-transit-gateway-route-tables, get-transit-gateway-route-table-associations, get-transit-gateway-route-table-propagations, search-transit-gateway-routes, describe-route-tables, describe-vpn-connections...","main","eeace51bd5dd1db2030729d83eeab988861553aa","skills\u002Ftransit-gateway-routing-troubleshooter",0,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills","https:\u002F\u002Fgithub.com\u002Fjhkchan","CTO & Co-Founder @Beever-AI  & @votee. CAISP. AWS Community Builder. Organizer@GDGCloudHK. MongoDB Champion. Technopreneur + Infornographer.","2026-09-24 08:54:10",{"source":8,"skillName":5,"commands":54,"prompt":64,"zipAvailable":65},[55,58,61],{"tool":56,"command":57},"npx","npx skills add jhkchan\u002Faws-agent-skills --skill transit-gateway-routing-troubleshooter",{"tool":59,"command":60},"bunx","bunx skills add jhkchan\u002Faws-agent-skills --skill transit-gateway-routing-troubleshooter",{"tool":62,"command":63},"pnpm","pnpm dlx skills add jhkchan\u002Faws-agent-skills --skill transit-gateway-routing-troubleshooter","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002FSKILL.md",true,[67,73,77,81,85,89,93,97,101,105,109,113,117,121,125,129,133,137,141,145],{"path":68,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":71,"sourceHtmlUrl":72},"eval\u002Ftest-cases.yaml","REFERENCE","参考文档",10579,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Feval\u002Ftest-cases.yaml",{"path":74,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":75,"sourceHtmlUrl":76},"evals\u002Fbaselines\u002Ftgw-appliance-mode-disabled.md",537,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fbaselines\u002Ftgw-appliance-mode-disabled.md",{"path":78,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":79,"sourceHtmlUrl":80},"evals\u002Fbaselines\u002Ftgw-overlapping-cidr.md",470,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fbaselines\u002Ftgw-overlapping-cidr.md",{"path":82,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":83,"sourceHtmlUrl":84},"evals\u002Fbaselines\u002Ftgw-peering-non-transitive.md",526,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fbaselines\u002Ftgw-peering-non-transitive.md",{"path":86,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":87,"sourceHtmlUrl":88},"evals\u002Fbaselines\u002Ftgw-static-route-overrides-propagated.md",520,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fbaselines\u002Ftgw-static-route-overrides-propagated.md",{"path":90,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":91,"sourceHtmlUrl":92},"evals\u002Fbaselines\u002Ftgw-vpc-default-route-blackhole.md",436,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fbaselines\u002Ftgw-vpc-default-route-blackhole.md",{"path":94,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":95,"sourceHtmlUrl":96},"evals\u002Feval_config.yaml",2065,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Feval_config.yaml",{"path":98,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":99,"sourceHtmlUrl":100},"evals\u002Fevals.json",5120,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fevals.json",{"path":102,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":103,"sourceHtmlUrl":104},"evals\u002Fprompts\u002Ftgw-appliance-mode-disabled.md",1378,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fprompts\u002Ftgw-appliance-mode-disabled.md",{"path":106,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":107,"sourceHtmlUrl":108},"evals\u002Fprompts\u002Ftgw-overlapping-cidr.md",1449,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fprompts\u002Ftgw-overlapping-cidr.md",{"path":110,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":111,"sourceHtmlUrl":112},"evals\u002Fprompts\u002Ftgw-peering-non-transitive.md",1341,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fprompts\u002Ftgw-peering-non-transitive.md",{"path":114,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":115,"sourceHtmlUrl":116},"evals\u002Fprompts\u002Ftgw-static-route-overrides-propagated.md",1431,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fprompts\u002Ftgw-static-route-overrides-propagated.md",{"path":118,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":119,"sourceHtmlUrl":120},"evals\u002Fprompts\u002Ftgw-vpc-default-route-blackhole.md",1367,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fevals\u002Fprompts\u002Ftgw-vpc-default-route-blackhole.md",{"path":122,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":123,"sourceHtmlUrl":124},"examples\u002FREADME.md",6015,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fexamples\u002FREADME.md",{"path":126,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":127,"sourceHtmlUrl":128},"references\u002Fadvanced-patterns.md",4736,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Freferences\u002Fadvanced-patterns.md",{"path":130,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":131,"sourceHtmlUrl":132},"references\u002Fdiagnostic-commands.md",6494,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Freferences\u002Fdiagnostic-commands.md",{"path":134,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":135,"sourceHtmlUrl":136},"references\u002Ftgw-attachment-and-appliance-mode.md",8369,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Freferences\u002Ftgw-attachment-and-appliance-mode.md",{"path":138,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":139,"sourceHtmlUrl":140},"references\u002Ftgw-routing-reference.md",10232,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Freferences\u002Ftgw-routing-reference.md",{"path":142,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":143,"sourceHtmlUrl":144},"references\u002Fworked-examples.md",1453,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Freferences\u002Fworked-examples.md",{"path":146,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":147,"sourceHtmlUrl":148},"skill.usf.yaml",4660,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftransit-gateway-routing-troubleshooter\u002Fskill.usf.yaml",[150,157,164,171,178,185],{"skillNo":151,"name":152,"nameZh":6,"description":153,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":154,"categories":155,"keywords":156,"publishedAt":19},"01M7ADVD60X4PCAPKSE58P9NDC","xray-tracing-deployer","Deploys AWS X-Ray distributed tracing with production-grade configuration: X-Ray daemon deployment (EC2 systemd, ECS sidecar, EKS DaemonSet, Lambda built-in), SDK instrumentation (Java, Python, Node.js, Go, .NET) with annotations and metadata, sampling rules (default reservoir + rate vs custom rules with URL \u002F method \u002F service-name predicates), service map generation, trace query and retrieval, groups and insights, CloudWatch ServiceLens integration, IAM permissions (PutTraceSegments, GetSamplingRules), and latest features (Lambda Powertools tracing, OpenTelemetry \u002F ADOT Collector support, W3C trace context). Emits a READY_TO_DEPLOY checklist with every configuration item verified. Use when enabling X-Ray on a new application, adding tracing to ECS \u002F EKS \u002F Lambda, validating a sampling configuration, or generating daemon deployment CLI and IaC templates. Triggers: X-Ray, distributed tracing, X-Ray daemon, sampling rules, service map, X-Ray SDK, OpenTelemetry, ADOT, Lambda Powertools, CloudWatch ServiceLens.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxray-tracing-deployer\u002FSKILL.md",[],[],{"skillNo":158,"name":159,"nameZh":6,"description":160,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":161,"categories":162,"keywords":163,"publishedAt":19},"01M7ADTVJ7DCBM9CB1FY51GH7J","wellarchitected-workload-auditor","Audits AWS Well-Architected Tool workloads for review staleness, per-pillar high-risk issue counts, milestone tracking gaps, and remediation plan completeness. Emits a deterministic verdict (STALE_REVIEW | HIGH_RISK | CONFIG_GAP | OK) per workload with per-pillar risk breakdown, milestone trend analysis, and specific remediation. Use when reviewing Well-Architected workloads, checking WA review freshness, auditing high-risk issues per pillar, validating milestone coverage, or tracking remediation plans.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwellarchitected-workload-auditor\u002FSKILL.md",[],[],{"skillNo":165,"name":166,"nameZh":6,"description":167,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":168,"categories":169,"keywords":170,"publishedAt":19},"01M7ADT59G6FTTNZYHT2QRPNNP","wellarchitected-review-operator","Operates AWS Well-Architected Tool reviews end-to-end — creates workloads, runs pillar reviews (operational excellence, security, reliability, performance, cost optimization, sustainability, Prosperity), answers questions with risk-tier rationale, generates reports and improvement plans, creates milestones, and integrates with Trusted Advisor and Well-Architected Labs. Runs deterministic pre-checks (workload existence, lens availability, pillar coverage), emits the exact update-answer \u002F get-consolidated-report CLI behind a CONFIRM gate, and verifies risk-tier transitions. Emits READY | BLOCKED | COMPLETED. Use when creating a workload, answering pillar questions, generating an improvement plan, creating a milestone, or integrating with Trusted Advisor. Triggers: well-architected tool, well architected review, workload review, pillar, operational excellence, security, reliability, performance, cost optimization, sustainability, prosperity, improvement plan, milestone, trusted advisor.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwellarchitected-review-operator\u002FSKILL.md",[],[],{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":175,"categories":176,"keywords":177,"publishedAt":19},"01M7ADSH5JA9QHNPPHQCD7EVA7","wafv2-web-acl-deployer","Provisions AWS WAFv2 Web ACLs with correct production defaults: scope selection (CLOUDFRONT vs REGIONAL), managed rule groups (AWSManagedRulesCommonRuleSet, SQLiRuleSet, LinuxRuleSet, WindowsRuleSet, IPReputationList, BotControlRuleSet, AmazonIpReputationList, ATP), custom rules (byte match, IP set, regex pattern, geo match, size constraint, rate-based), rule priority ordering, logging destinations (Kinesis Firehose, CloudWatch Logs, S3), resource association (ALB, API Gateway, CloudFront), rate-based rules with aggregate keys (IP, forwarded IP), Challenge and CAPTCHA actions, and account takeover prevention. Emits a READY_TO_DEPLOY checklist. Use when creating a Web ACL, attaching managed rules, configuring rate limiting, enabling WAF logging, associating a Web ACL with an ALB\u002FAPI Gateway\u002FCloudFront, or configuring CAPTCHA\u002FChallenge actions. Triggers: create WAF Web ACL, WAFv2, managed rule groups, WAF rate limiting, WAF logging, WAF CAPTCHA, WAF Challenge action, bot control, ATP managed rules.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwafv2-web-acl-deployer\u002FSKILL.md",[],[],{"skillNo":179,"name":180,"nameZh":6,"description":181,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":182,"categories":183,"keywords":184,"publishedAt":19},"01M7ADRYFAT8R73FBNCHRC573X","wafv2-web-acl-auditor","Audits AWS WAFv2 Web ACL configurations to determine whether the ACL provides effective protection: default-action posture (Allow vs Block), managed-rule-group coverage gaps, rule effectiveness (BLOCK vs COUNT, shadow\u002Fbypass rules, stale exclusions), rate-based rule correctness, logging and visibility configuration, and text-transformation bypass vectors. Emits a deterministic verdict per Web ACL. Use when reviewing a WAFv2 Web ACL for security posture, checking managed-rule coverage, validating rate-limit configuration, auditing WAF logging, or hardening a WAF before production deployment. Triggers: WAF, WAFv2, Web ACL, managed rule group, AWSManagedRules, rate-based rule, CAPTCHA, Challenge, OverrideAction, Count mode, forwarded IP, Bot Control, ATP, text transformation, WAF logging, WAF visibility, OWASP, SQLi, XSS, RFI.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwafv2-web-acl-auditor\u002FSKILL.md",[],[],{"skillNo":186,"name":187,"nameZh":6,"description":188,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":189,"categories":190,"keywords":191,"publishedAt":19},"01M7ADR8W7G72JX4KFGN03QK8Q","waf-rule-deployer","Provisions AWS WAFv2 rule sets with production defaults: Web ACL creation (CloudFront scope in us-east-1 vs Regional scope), rule groups (managed vs custom) with capacity planning in WCU (Web ACL Capacity Units, 1500 default per ACL), managed rule groups (AWSManagedRulesCommonRuleSet, AWSManagedRulesSQLiRuleSet, AWSManagedRulesAmazonIpReputationList, AWSManagedRulesLinuxRuleSet, AWSManagedRulesWindowsRuleSet, AWSManagedRulesUnixRuleSet), custom rules (byte-match, regex pattern set, geo-match, rate-based), IP set and regex pattern set resources, rule priority ordering (lowest number evaluated first), action types (allow, block, count, CAPTCHA, Challenge), bot control managed rule group, account takeover. Triggers: create WAF rule, WAF managed rule group, WAF custom rule, WAF byte match, WAF geo match, WAF rate based rule, WAF IP set, WAF regex pattern set, WAF WCU budget, WAF CloudFront ACL, WAF logging Kinesis Firehose, WAF bot control, WAF ATP, WAF label matching, WAF Challenge action, WAF CAPTCHA.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwaf-rule-deployer\u002FSKILL.md",[],[]]