Agent-skills-standard android-networking

Integrate Retrofit, OkHttp, and Kotlinx Serialization for type-safe API communication in Android. Use when building API clients, adding interceptors, or configuring network security. (triggers: **/*Api.kt, **/*Service.kt, **/*Client.kt, Retrofit, OkHttpClient, @GET, @POST)

install

source · Clone the upstream repo

git clone https://github.com/HoangNguyen0403/agent-skills-standard

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/HoangNguyen0403/agent-skills-standard "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/android/android-networking" ~/.claude/skills/hoangnguyen0403-agent-skills-standard-android-networking && rm -rf "$T"

manifest: skills/android/android-networking/SKILL.md

source content

Android Networking Standards

Priority: P0

1. Configure HTTP Stack

Use Retrofit 2 with OkHttp 4 for all backend communication.
Use Kotlinx Serialization with
```
@SerialName
```
for JSON field mapping.
Implement Certificate Pinning for sensitive production domains.

See setup & wrappers for DTO and API examples.

2. Define API Endpoints

All API calls must
```
suspend
```
functions.
Declare endpoints only in API interface — handle errors in Repository.

See setup & wrappers for API endpoint definitions.

3. Add Cross-Cutting Concerns

Use OkHttp Interceptors for
```
Bearer token
```
injection and
```
HttpLoggingInterceptor
```
(debug only).
Wrap responses with
```
Result
```
wrapper or
```
Either
```
in Repository layer.
Define R8/ProGuard rules for Retrofit/OkHttp when
```
isMinifyEnabled = true
```
.
Use MockWebServer for unit/integration tests — cover 500, 401, 403 error cases.

Anti-Patterns

No Blocking Network Calls: All API functions must suspend.
No Logic in API Interface: Only declare endpoints — handle errors in Repository.
No Raw Converter Factory: Explicitly set "application/json" MediaType with kotlinx.serialization.

References

Setup & Wrappers