Skip to content

plugin: add Android dev skills#89

Merged
gaelic-ghost merged 3 commits into
mainfrom
plugin/android-dev-skills
Jun 28, 2026
Merged

plugin: add Android dev skills#89
gaelic-ghost merged 3 commits into
mainfrom
plugin/android-dev-skills

Conversation

@gaelic-ghost

@gaelic-ghost gaelic-ghost commented Jun 28, 2026

Copy link
Copy Markdown
Owner

Summary

  • add the Socket-owned Android Dev Skills plugin skill tranche
  • expose six Android workflows for project shape, Gradle/AGP, Kotlin UI/platform work, Java interop, testing/lint, and release readiness
  • switch the Socket marketplace entry to installable and align root docs/roadmap

Verification

  • uv run mypy
  • uv run scripts/validate_socket_metadata.py
  • skill frontmatter validation for all six Android skills
  • isolated CODEX_HOME local marketplace add/remove smoke test

Summary by CodeRabbit

  • New Features

    • Added the Android Dev Skills plugin to the available catalog.
    • Expanded Android guidance for Kotlin/Java development, Gradle/AGP workflows, testing, linting, UI implementation, and release-readiness checks.
  • Documentation

    • Updated contributor and maintainer docs with clearer Android plugin scope, usage, and workflow guidance.
    • Added new skill docs covering project shape selection, build workflows, testing/lint, Java interoperability, and release readiness.

@gaelic-ghost gaelic-ghost added the enhancement New feature or request label Jun 28, 2026
@coderabbitai

coderabbitai Bot commented Jun 28, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@gaelic-ghost, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 53 minutes and 41 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 5f39b27f-741e-4073-ac37-6cf6daf85f02

📥 Commits

Reviewing files that changed from the base of the PR and between 854c56a and 37ca90d.

📒 Files selected for processing (6)
  • plugins/android-dev-skills/skills/build-kotlin-android/SKILL.md
  • plugins/android-dev-skills/skills/choose-project-shape/SKILL.md
  • plugins/android-dev-skills/skills/gradle-agp-workflow/SKILL.md
  • plugins/android-dev-skills/skills/java-android-workflow/SKILL.md
  • plugins/android-dev-skills/skills/release-readiness-workflow/SKILL.md
  • plugins/android-dev-skills/skills/testing-lint-workflow/SKILL.md
📝 Walkthrough

Walkthrough

The android-dev-skills plugin is marked as implemented: six new skill documents are added (choose-project-shape, build-kotlin-android, gradle-agp-workflow, java-android-workflow, testing-lint-workflow, release-readiness-workflow), plugin metadata and agent guidance are updated, the marketplace installation policy changes from NOT_AVAILABLE to AVAILABLE, and all tracking files (README, ROADMAP, TODO, CONTRIBUTING) reflect the completed status.

Changes

Android Dev Skills Plugin Implementation

Layer / File(s) Summary
Six new Android skill documents
plugins/android-dev-skills/skills/choose-project-shape/SKILL.md, plugins/android-dev-skills/skills/build-kotlin-android/SKILL.md, plugins/android-dev-skills/skills/gradle-agp-workflow/SKILL.md, plugins/android-dev-skills/skills/java-android-workflow/SKILL.md, plugins/android-dev-skills/skills/testing-lint-workflow/SKILL.md, plugins/android-dev-skills/skills/release-readiness-workflow/SKILL.md
Adds all six skill specifications covering Android project shape routing, Kotlin-first builds (Compose/XML), Gradle/AGP maintenance, Java interop, testing/lint workflow, and release-readiness checks with publish guardrails.
Plugin metadata and agent guidance
plugins/android-dev-skills/.codex-plugin/plugin.json, plugins/android-dev-skills/AGENTS.md, docs/maintainers/android-dev-skills-plugin-plan.md
Updates plugin.json description, shortDescription, longDescription, and defaultPrompt to reflect the full Android skill surface; rewrites AGENTS.md local rules with Kotlin/Java/Compose/release guidance; expands maintainer plan with tranche scoping and doc authority rules.
Marketplace availability and project tracking
.agents/plugins/marketplace.json, README.md, CONTRIBUTING.md, ROADMAP.md, TODO.md
Flips android-dev-skills installation policy to AVAILABLE; adds the plugin to the README usage and catalog sections; updates CONTRIBUTING plugin list; marks Milestone 15 and related backlog items as implemented/complete.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested labels

documentation

Poem

🐇 Hop hop, the Android skills are here!
Six scrolls of wisdom, crisp and clear—
Kotlin-first, with Compose in tow,
Gradle aligned, release set to go.
From NOT_AVAILABLE to AVAILABLE at last,
The rabbit ships fast! 🚀

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly matches the main change: adding the Android dev skills plugin and related skill tranche.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch plugin/android-dev-skills

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 854c56ad4a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

owner: gaelic-ghost
repo: socket
category: android-planning
allowed-tools: Read Bash(rg:*) Bash(git:*) Bash(java:*) Bash(./gradlew:*) Bash(gradle:*) Bash(adb:*) Bash(aapt:*) Bash(aapt2:*)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Remove unrestricted adb from guidance-only Android skills

When this planning/routing skill is selected, it grants unrestricted adb even though the new Android guidance says emulator/device validation should be handed off instead of run from these skills. The official Android adb docs describe adb as a device-communication tool that can install/debug apps and provide a Unix shell, so Bash(adb:*) lets an ordinary project-shape request directly inspect or mutate a connected device instead of routing to the owned testing surface; please remove adb from these guidance skills or narrow it to a read-only status command. See: https://developer.android.com/tools/adb

Useful? React with 👍 / 👎.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 6

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/android-dev-skills/skills/build-kotlin-android/SKILL.md`:
- Around line 1-10: The SKILL.md frontmatter for build-kotlin-android is missing
the required compatibility metadata field, so update the YAML header to include
it alongside name, description, license, and metadata. Keep the existing
structure intact and make sure the new field matches the repo’s expected format
used by validate_repo_metadata.py so this skill passes validation like the other
skill definitions.

In `@plugins/android-dev-skills/skills/choose-project-shape/SKILL.md`:
- Around line 1-10: The SKILL.md frontmatter for choose-project-shape is missing
the required compatibility field, which will break metadata validation. Update
the frontmatter in this skill file to include compatibility alongside name,
description, license, metadata, and allowed-tools, matching the
REQUIRED_FRONTMATTER_FIELDS contract used by validate_repo_metadata.py.

In `@plugins/android-dev-skills/skills/gradle-agp-workflow/SKILL.md`:
- Around line 1-10: The SKILL.md frontmatter for gradle-agp-workflow is missing
the required compatibility field, which causes metadata validation to fail.
Update the YAML header to include compatibility alongside the existing name,
description, license, and metadata fields, and make sure the value matches the
repository’s expected Android build support constraints. Use the existing
frontmatter block in SKILL.md as the place to add it.

In `@plugins/android-dev-skills/skills/java-android-workflow/SKILL.md`:
- Around line 1-10: The SKILL.md frontmatter for java-android-workflow is
missing the required compatibility field, which must be added to satisfy
validate_repo_metadata.py. Update the frontmatter in the java-android-workflow
skill metadata alongside name, description, license, and metadata, and include a
compatibility value that matches the skill’s Android/Java support scope.

In `@plugins/android-dev-skills/skills/testing-lint-workflow/SKILL.md`:
- Around line 1-10: The SKILL.md frontmatter is missing the required
compatibility metadata field, so add it alongside the existing
name/description/license/metadata block to satisfy validate_repo_metadata.py.
Update the frontmatter in testing-lint-workflow to include compatibility with
the appropriate value for this skill, keeping the rest of the metadata
unchanged.

In `@ROADMAP.md`:
- Line 424: The completed validation claim in ROADMAP.md is inconsistent with
the current validator contract because the referenced
`validate_socket_metadata.py` would flag missing `compatibility` frontmatter in
the provided `SKILL.md` files. Update the ROADMAP entry to reflect the actual
validation outcome, or add the missing `compatibility` field in the affected
SKILL metadata and rerun the validation so the claim matches the checked state.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: cc40cdd9-5dc3-4842-85bd-393a37eb4e73

📥 Commits

Reviewing files that changed from the base of the PR and between 3a85bee and 854c56a.

📒 Files selected for processing (14)
  • .agents/plugins/marketplace.json
  • CONTRIBUTING.md
  • README.md
  • ROADMAP.md
  • TODO.md
  • docs/maintainers/android-dev-skills-plugin-plan.md
  • plugins/android-dev-skills/.codex-plugin/plugin.json
  • plugins/android-dev-skills/AGENTS.md
  • plugins/android-dev-skills/skills/build-kotlin-android/SKILL.md
  • plugins/android-dev-skills/skills/choose-project-shape/SKILL.md
  • plugins/android-dev-skills/skills/gradle-agp-workflow/SKILL.md
  • plugins/android-dev-skills/skills/java-android-workflow/SKILL.md
  • plugins/android-dev-skills/skills/release-readiness-workflow/SKILL.md
  • plugins/android-dev-skills/skills/testing-lint-workflow/SKILL.md

Comment thread plugins/android-dev-skills/skills/build-kotlin-android/SKILL.md
Comment thread plugins/android-dev-skills/skills/choose-project-shape/SKILL.md
Comment thread plugins/android-dev-skills/skills/gradle-agp-workflow/SKILL.md
Comment thread plugins/android-dev-skills/skills/java-android-workflow/SKILL.md
Comment thread plugins/android-dev-skills/skills/testing-lint-workflow/SKILL.md
Comment thread ROADMAP.md
- [x] Add `android-dev:release-readiness-workflow` for versioning, signing, release builds, R8/ProGuard, app bundles, APKs, Play delivery handoffs, permissions, privacy checks, and release automation routing.
- [x] Update plugin metadata after real skills land, including `skills`, keywords, prompts, and accurate installable descriptions.
- [x] Switch the root marketplace entry to installable only after real skill content exists.
- [x] Run root metadata validation with `uv run scripts/validate_socket_metadata.py`.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

Validation claim discrepancy: validate_socket_metadata.py would fail on missing compatibility fields.

The ROADMAP claims "Run root metadata validation with uv run scripts/validate_socket_metadata.py" as completed, but all five provided SKILL.md files are missing the required compatibility frontmatter field. Per the validator contract (REQUIRED_FRONTMATTER_FIELDS), this should produce findings. Either the validation script run was a different version, the field was removed after validation, or the validation claim needs correction.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@ROADMAP.md` at line 424, The completed validation claim in ROADMAP.md is
inconsistent with the current validator contract because the referenced
`validate_socket_metadata.py` would flag missing `compatibility` frontmatter in
the provided `SKILL.md` files. Update the ROADMAP entry to reflect the actual
validation outcome, or add the missing `compatibility` field in the affected
SKILL metadata and rerun the validation so the claim matches the checked state.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@gaelic-ghost

gaelic-ghost commented Jun 28, 2026

Copy link
Copy Markdown
Owner Author

Addressed the compatibility metadata review comments in 37ca90d by adding compatibility to all six Android skill frontmatters. Revalidated with uv run mypy, uv run scripts/validate_socket_metadata.py, git diff --check, and the isolated local Socket marketplace smoke test.

@gaelic-ghost gaelic-ghost merged commit 76d0555 into main Jun 28, 2026
2 checks passed
@gaelic-ghost gaelic-ghost deleted the plugin/android-dev-skills branch June 28, 2026 13:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant