Improve integration-review skill and add per-skill usage READMEs

.agents/skills/adk-bot-review/README.md

@@ -0,0 +1,29 @@
+# adk-bot-review skill
+
+Usage guide for the `adk-bot-review` skill.
+
+**What it does:** Reviews adk-bot-authored pull requests for technical accuracy
+against ADK source code, checks PR state and formatting, and applies ADK docs
+style conventions.
+
+**Audience:** Maintainers.
+
+## How to invoke
+
+Ask the agent naturally, for example:
+
+- "Review bot PR #<n>"
+- "Check bot changes for issue #<n>"
+- "Verify bot issue #<n>"
+
+## What you get back
+
+- Findings ordered blockers first, then required edits, then nits.
+- A recommended outcome for the bot PR(s).
+
+## Follow-up actions
+
+- Close the bot PR(s).
+- Approve as-is.
+- Edit in place, then approve.
+- Open a new consolidating PR and close the superseded bot PR(s).

.agents/skills/integration-create/README.md

@@ -0,0 +1,34 @@
+# integration-create skill
+
+Usage guide for the `integration-create` skill.
+
+**What it does:** Drafts a new integration page under `docs/integrations/`,
+picking the right category template (MCP tool, observability, plugin, etc.) and
+following the catalog conventions.
+
+**Audience:** Contributors.
+
+## How to invoke
+
+Ask the agent naturally, for example:
+
+- "Create an integration page for <tool>"
+- "Add an integration for <product>"
+- "Write an integration page for <service>"
+
+## What you get back
+
+- A drafted `docs/integrations/<name>.md` with frontmatter and the
+  category-appropriate sections.
+- A hand-off note reminding you to add the icon asset at
+  `docs/integrations/assets/<slug>.png` (and any screenshots).
+
+## Follow-up actions
+
+- Provide the inputs it gathers: product name, category, language support,
+  package name and install command, the tools or methods it exposes, and links
+  (docs, repo, PyPI/npm, API key).
+- Iterate on the draft.
+- Run the `integration-review` skill before submitting.
+- Run `mkdocs serve` to confirm the card renders and the icon loads.
+- Open a pull request.

.agents/skills/integration-review/README.md

@@ -0,0 +1,37 @@
+# integration-review skill
+
+Usage guide for the `integration-review` skill.
+
+**What it does:** Reviews an integration page or pull request under
+`docs/integrations/` for correctness, structure, style, working code, valid
+links, and catalog conventions.
+
+**Audience:** Contributors and maintainers.
+
+## How to invoke
+
+Ask the agent naturally, for example:
+
+- "Review integration PR #1959"
+- "Run integration-review on `docs/integrations/bigquery.md`"
+- "Review this integration"
+
+## What you get back
+
+- A prioritized report with all four tiers listed (🔴 Critical, 🟠 Quality,
+  🟡 Style, 🔵 Nits), each finding tagged with `file:line`.
+- A developer value and maturity assessment.
+- A recommended decision: approve, request changes, or close PR.
+- A top-level review response.
+- Draft line-anchored comments, one per finding.
+
+Everything is a draft. Nothing is posted to GitHub and no files are changed
+unless you explicitly ask.
+
+## Follow-up actions
+
+- Act on the decision: approve, request changes, or close the PR.
+- Edit the drafted review response and comments before sending them to the
+  author.
+- Ask the agent to apply fixes (for example, "apply the fixes"); it edits files
+  only when explicitly asked.