v1.6.0

What's Changed

• Android 17 currency, Android CLI v1.0 + Navigation 3 adoption, five new skills, and a CI skill validator (v1.6.0) by @GuillemRoca in #7

Full Changelog: v1.5.2...v1.6.0

v1.5.2

Patch release. Fixes agent registration that was silently broken in v1.5.0 → v1.5.1.

What changed

• Manifest — removed the "agents": [ ... ] array from .claude-plugin/plugin.json. As an explicit array, that entry is silently ignored by the current Claude Code plugin loader; agents must be auto-discovered from the standard ./agents/*.md path (the same convention as hooks, fixed in v1.5.1).
• Persona catalogue moved — agents/README.md → docs/agent-personas.md. Without manifest.agents, the loader walks agents/ and would pick up README.md (which has no YAML frontmatter) as a phantom fourth agent. Moving it out of the directory eliminates the noise. Internal sibling links rewritten; four references updated (AGENTS.md / CLAUDE.md symlink + each persona's "See …" footer).

Why this matters

On v1.5.1 the plugin loaded successfully but reported Agents (0) in claude plugin details — the three persona files (code-reviewer, security-auditor, test-engineer) were never registered. v1.5.2 restores Agents (3) and slash commands / parallel fan-out in /ship can now resolve the personas correctly.

Empirical verification

Verified by patching the cached 1.5.1 manifest in place before shipping:

State	manifest.agents	agents/README.md	plugin details
v1.5.1 baseline	array of 3 paths	present	Agents (0)
Test 1	removed	present	Agents (4) (3 real + README phantom)
Test 2 = v1.5.2	removed	moved to docs/	Agents (3)

Upgrade

• /plugin → agent-skills-android → Update (or claude plugin update agent-skills-android@guillemroca) to refresh the local cache to 1.5.2, then start a new Claude Code session.

PR: #6

v1.5.1

Patch release. Fixes a regression in v1.5.0 that prevented the SessionStart hook from registering.

What changed

• Manifest — removed the "hooks": "./hooks/hooks.json" entry from .claude-plugin/plugin.json. The plugin loader auto-discovers hooks/hooks.json at the standard path, so declaring it again caused the loader to attempt to load the same file twice and abort with Duplicate hooks file detected. With the redundant entry removed, the auto-load registers the hook cleanly.

Why this matters

On v1.5.0, consumers saw Failed to load hooks from .../hooks/hooks.json: Duplicate hooks file detected ... at session start and the using-agent-skills meta-skill was never injected. v1.5.1 restores the intended behavior.

Upgrade

• /plugin → agent-skills-android → Update (or uninstall + reinstall) to refresh the local cache to 1.5.1, then start a new Claude Code session.

PR: #5

v1.5.0

Wires the previously-undeclared component categories into .claude-plugin/plugin.json so plugin consumers actually load them.

What changed

• Commands — declared ./.claude/commands so the seven slash commands register: /build, /code-simplify, /plan, /review, /ship, /spec, /test. The directory is non-default, so without this entry the loader silently skipped them.
• Agents — listed the three concrete agent files explicitly (code-reviewer, security-auditor, test-engineer) so agents/README.md no longer loads as a phantom agent.
• Hooks — wired ./hooks/hooks.json so the SessionStart hook (hooks/session-start.sh) fires for consumers; the hook injects the using-agent-skills meta-skill into every new session.
• Keywords preserved — android, kotlin, jetpack-compose, tdd, etc. retained for marketplace discoverability and fork differentiation from upstream addyosmani/agent-skills.

Verification

• claude plugin validate . passes in CI (Anthropic's own validator).
• All declared paths resolve in the tree.
• hooks/session-start.sh handles missing jq gracefully.

PR: #4

v1.4.0

Highlights

The marketplace manifest has moved out of this repo into a dedicated registry: GuillemRoca/claude-plugins under the guillemroca namespace. This lets future plugins (e.g. additional language-specific skill packs) join the same marketplace cleanly without coupling their lifecycle to this repo.

Breaking change for existing users

The marketplace pointer changed. If you installed before v1.4.0, swap the marketplace once:

```bash
claude plugin marketplace remove agent-skills-android
claude plugin marketplace add GuillemRoca/claude-plugins
claude plugin install agent-skills-android@guillemroca
```

New installs use:

```bash
claude plugin marketplace add GuillemRoca/claude-plugins
claude plugin install agent-skills-android@guillemroca
```

Changes

• Removed in-tree .claude-plugin/marketplace.json; only plugin.json remains in this repo
• Updated README.md and docs/getting-started.md install snippets to point at the new marketplace
• Simplified CI workflow: validates the plugin manifest only (install testing now belongs in the marketplace repo)
• Bumped `version` in `plugin.json` to `1.4.0`

Plugin contents

No changes to skills, slash commands, agents, hooks, or references. The 24 skills and 7 slash commands are unchanged from v1.3.0.

Full changelog: v1.3.0...v1.4.0

v1.3.0

Highlights

• android CLI prescriptions across four skills — instead of vendoring a standalone android-cli skill (a command catalog with heavy overlap), this release hardens the skills that genuinely benefit from CLI affordances:
  • android-accessibility — jq-driven scans of android layout JSON for unlabeled controls and sub-48dp touch targets, with annotated-screenshot fallback for WebView/animation cases.
  • android-device-testing — new Step 6 prescribing android run / emulator / describe as a one-shot deploy pipeline, plus android layout --diff for state-change assertions during test authoring.
  • debugging-and-error-recovery — android info + android screen capture + android layout as pre-debugger triage capture (env, screen, full UI tree in <5s).
  • ci-cd-and-automation — android sdk install as a leaner alternative to setup-android for platform provisioning, with explicit guidance to keep reactivecircus/android-emulator-runner for the emulator itself (android emulator is disabled on Windows).
  • source-driven-development already prescribed android docs + kb:// at priority 1 — left untouched.
• android skills catalog discovery — references/android-cli-reference.md now documents android skills find|list|add, the per-harness install dirs (~/.claude/skills/, ~/.gemini/skills/, ~/.codex/skills/, ~/.copilot/skills/, ~/.junie/skills/, ~/.config/opencode/skills/), and the vendor-into-repo flow for adopting catalog skills.

Changes

• 4b23c7d Harden existing skills with android CLI prescriptions (v1.3.0) (#2)

Full changelog: v1.2.0...v1.3.0

v1.2.0

Highlights

• Orchestration patterns — new references/orchestration-patterns.md and agents/README.md documenting the parallel fan-out + merge pattern used by /ship, plus the composition rule that personas don't invoke other personas (Junie orchestrates).
• Hardened SDD cache hook — full hooks/sdd-cache-*.sh suite (pre/post/purge/selftest) with documentation in hooks/SDD-CACHE.md. Replaces the prior single-script cache flow with a safer, testable pipeline.
• Agent persona frontmatter — code-reviewer, security-auditor, and test-engineer now ship with frontmatter so they can be invoked as proper subagents.
• /ship rewrite — the ship command now drives the parallel fan-out pattern across the three personas and synthesizes a single go/no-go report.
• Docs — AGENTS.md updated to describe the orchestration model; README and plugin metadata bumped to 1.2.0; .gitignore cleanup; SSH/plugin-update troubleshooting notes.

Changes

• 67e4396 Orchestration patterns + hardened SDD cache hook (v1.2.0) (#1)
• 9424706 Document plugin update command and SSH troubleshooting

Full changelog: v1.1.0...v1.2.0

v1.1.0

Highlights

Minimal Android CLI integration focused on the two capabilities that are genuinely new — not convenience wrappers over existing adb/gradlew workflows.

Added

• references/android-cli-reference.md — cite-able reference covering:
  • android layout --pretty — structured JSON UI tree (resource-id, content-desc, role, bounds per node) for deterministic UI inspection.
  • android docs search + android docs fetch kb://... — stable, cite-able KB URIs for framework documentation.

Updated

• source-driven-development — kb:// URIs accepted as a priority-1 source alongside developer.android.com. Step 2 shows how to obtain them; Verification checklist accepts them.
• android-accessibility — Step 6 tip on using android layout --pretty JSON for programmatic assertions (unlabeled buttons, touch targets < 48dp).
• android-ui-engineering — Verification checklist line for on-device hierarchy inspection alongside @Preview.

Unchanged

No new skills, no meta-skill bumps, no callout convention. Existing adb, gradlew, sdkmanager, Accessibility Scanner, and TalkBack workflows remain canonical. The android CLI is preferred where its output is structured and cite-able; it's never a hard requirement.

Full changelog: v1.0.0...v1.1.0

v1.0.0

What's Included

24 Skills organized by lifecycle phase

DEFINE

• idea-refine — Divergent-convergent thinking to sharpen vague ideas into actionable directions
• spec-driven-development — Structured SPEC.md before any code is written
• context-engineering — Rules files and context hierarchy for AI-assisted development

PLAN

• planning-and-task-breakdown — Vertical slicing with acceptance criteria and verification steps
• android-architecture — MVVM/MVI, Clean Architecture, Hilt DI, module structure, Coroutines/Flow

BUILD

• incremental-implementation — Small, verifiable increments with feature flags
• test-driven-development — Red-Green-Refactor with JUnit5, MockK, and Compose test rules
• android-ui-engineering — Jetpack Compose, Material 3, state hoisting, Navigation, previews, XML interop
• android-data-persistence — Room, DataStore, migrations, Paging3, offline-first, repository pattern
• api-and-interface-design — Retrofit interfaces, Room DAOs, sealed types, contract-first design
• source-driven-development — Every framework API backed by official documentation
• code-simplification — Incremental simplification preserving behavior with Kotlin idioms
• documentation-and-adrs — Architecture Decision Records and KDoc

VERIFY

• android-device-testing — Espresso, UI Automator, Compose test rules, ADB, emulator management
• android-accessibility — TalkBack, Compose semantics, touch targets (48dp), Accessibility Scanner
• debugging-and-error-recovery — Logcat, Android Studio debugger, LeakCanary, Crashlytics, six-step triage
• performance-optimization — Android Vitals, Macrobenchmark, Baseline Profiles, APK size, recomposition

REVIEW

• code-review-and-quality — Five-axis review (Correctness, Readability, Architecture, Security, Performance)
• security-and-hardening — OWASP Mobile Top 10, Network Security Config, cert pinning, EncryptedSharedPreferences

SHIP

• ci-cd-and-automation — GitHub Actions, Gradle caching, emulator testing in CI, Play Store deploy
• git-workflow-and-versioning — Trunk-based development, atomic commits, versionCode/versionName, signing
• shipping-and-launch — Pre-launch checklist, staged rollout, Play Store requirements, rollback plans
• deprecation-and-migration — @ Deprecated with replaceWith, minSdk bumps, strangler pattern

META

• using-agent-skills — Five core agent behaviors and skill discovery flowchart

3 Agent Personas

• code-reviewer — Five-axis code review with categorized findings
• test-engineer — Android testing pyramid, coverage analysis, Prove-It pattern
• security-auditor — OWASP Mobile Top 10 vulnerability assessment

4 Reference Checklists

• testing-patterns — JUnit5, MockK, Espresso, Compose tests, MockWebServer
• security-checklist — Data storage, network, auth, components, secrets, ProGuard/R8
• performance-checklist — Android Vitals targets, startup, rendering, memory, APK size
• accessibility-checklist — TalkBack, touch targets, contrast, Compose semantics

7 Slash Commands

/spec · /plan · /build · /test · /review · /code-simplify · /ship

Multi-Platform Support

• Claude Code — Full plugin with hooks, skills, and slash commands
• Cursor — .cursor/rules/ directory or .cursorrules file
• Gemini CLI — .gemini/skills/ auto-discovery
• Windsurf — .windsurfrules configuration
• GitHub Copilot — .github/copilot-instructions.md + agent personas
• OpenCode — Agent-driven skill routing via AGENTS.md
• Kiro IDE — .kiro/skills/ directory
• Any agent — Plain Markdown, works with any tool that reads project context

Installation

# Claude Code
claude plugin marketplace add GuillemRoca/agent-skills-android
claude plugin install agent-skills-android

# Or clone for any agent
git clone https://github.com/GuillemRoca/agent-skills-android.git

Tech Stack

Kotlin · Jetpack Compose · Material 3 · Hilt · Coroutines/Flow · Room · DataStore · Retrofit · JUnit5 · MockK · Espresso · Gradle · GitHub Actions · Play Store