apigee/devrel/apigee-policy-top10

apigee-policy-top10

Use this skill when the user asks "what are the top N policies in use in my Apigee org" or any close paraphrase.

Runtime dispatch

This skill ships ONE behavioural contract that runs on two runtimes. Choose the invocation path that matches the runtime you are running in. The downstream behaviour and output contract are identical.

Steps

1. Resolve the target organization from the environment variable

APIGEE_ORG. If unset, ask the user once for the org id and then proceed.

1. Invoke the bundled enumerator using the runtime path from the

table above. The exact command is:

Command (this is what OpenCode runs automatically; in other agent runtimes you run it yourself via the bash tool):

!python3 ${SKILL_DIR}/scripts/top10.py --org "${APIGEE_ORG}"

1. The enumerator's FIRST line of stdout is a customer-facing

announcement that begins Querying your Apigee org now —. Surface this line verbatim to the user as it appears, before anything else. Do not paraphrase it. (The script is the source of truth for the announcement string; the SKILL.md does NOT contain a verbatim copy that the agent must remember.)

1. After the announcement, the script prints a markdown table with

two columns (policy_type, count) sorted descending. Reproduce the table verbatim as the answer. Add a brief preface ("Here are the top 10 policy types in use…") and stop.

1. Lines beginning [apigee-policy-top10] are log lines for

operator debugging; do NOT surface them in the answer unless they say FAILED. On any FAILED line, surface the verbatim error to the user; do not retry.