# Agent Platform Troubleshooting (agent skill)

> Agent Platform Troubleshooting is an agent skill (a SKILL.md file) from google/skills. Troubleshoots Google Cloud Gemini Enterprise Agent Platform issues (Agent Gateway, Registry, Identity, Policies, Model Armor, Identity-Aware Proxy (IAP)). It works with Claude Code, Codex and Gemini CLI and has 21,578 GitHub stars across a repository of 7 listed skills.

Troubleshoots Google Cloud Gemini Enterprise Agent Platform issues (Agent Gateway, Registry, Identity, Policies, Model Armor, Identity-Aware Proxy (IAP)). Use when agent requests fail with 403 (especially unauthorized egress), Agent Runtime queries return 500, or gateway/IAP logs show permission errors. Don't use for general Google Cloud Identity and Access Management (IAM) debugging or networking issues unrelated to the Agent Platform stack.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/google/skills |
| Skill path | skills/cloud/agent-platform-troubleshooting/SKILL.md |
| Skill name | agent-platform-troubleshooting |
| GitHub stars | 21,578 |
| Installs on skills.sh | 3 |
| License | Apache-2.0 |
| Skills in repo | 7 |
| Plugin marketplace | google-plugins |
| Official | yes |
| Works with | Claude Code, Codex, Gemini CLI |
| Category | Testing & QA |
| Last commit | Oct 25, 2026 |

## When it triggers

- Use when agent requests fail with 403 (especially unauthorized egress), Agent Runtime queries return 500, or gateway/IAP logs show permission errors.
- use for general Google Cloud Identity and Access Management (IAM) debugging or networking issues unrelated to the Agent Platform stack.

## Add this skill

### Claude Code

```sh
/plugin marketplace add google/skills
/plugin   # browse google-plugins and install the plugin that contains agent-platform-troubleshooting
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
git clone --depth 1 https://github.com/google/skills.git
cp -r skills/skills/cloud/agent-platform-troubleshooting .agents/skills/agent-platform-troubleshooting   # repo; ~/.agents/skills for all projects
```

### Cursor

```sh
git clone --depth 1 https://github.com/google/skills.git
cp -r skills/skills/cloud/agent-platform-troubleshooting .cursor/skills/agent-platform-troubleshooting   # project; ~/.cursor/skills for all projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

skills.sh listing: https://www.skills.sh/google/skills/agent-platform-troubleshooting

---

Canonical page: https://appsgit.com/skills/google-agent-platform-troubleshooting
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.