CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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—not standalone MockWebServer or API-test setup.

61

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/android/android-networking/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a compact, well-organized standards checklist that correctly pushes implementation detail to a single real reference file, with no padding or basic-concept explanations. Its weaknesses are repetition (rules and the reference link stated multiple times), the complete absence of executable code or examples in the body itself, and a checklist structure that lacks workflow sequencing or validation checkpoints.

Suggestions

State each rule once: keep the suspend-function and endpoint-declaration rules either in the numbered sections or in Anti-Patterns, not both, and reference implementation.md a single time (e.g., in the References section) instead of three identical links.

Include one minimal executable snippet inline — e.g., a Retrofit API interface with a suspend @GET function and a @SerialName DTO — so the core pattern is actionable without opening the reference file.

Reframe sections 1–3 as an ordered setup workflow with a verification step (e.g., confirm the app builds and pinned-domain requests succeed after adding Certificate Pinning and R8 rules), and fix the grammar of 'All API calls must `suspend` functions' to 'must be suspend functions'.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows and is generally lean, but it is noticeably redundant: the suspend rule ('All API calls must `suspend` functions' / 'All API functions must suspend') and the endpoint-declaration rule ('Declare endpoints only in API interface — handle errors in Repository' / 'No Logic in API Interface') are each stated twice, and the identical link 'See [setup & wrappers](references/implementation.md)' appears three times. This matches the 'mostly efficient but could be tightened' anchor; it is not the 4 anchor because the duplication is a real, non-minor tightening opportunity.

3 / 5

Actionability

Guidance names concrete specifics (Retrofit 2, OkHttp 4, '@SerialName', 'Bearer token' injection, 'isMinifyEnabled = true', error cases 500/401/403), but the body contains no executable code or commands — everything runnable lives in the reference file — and one directive is garbled ('All API calls must `suspend` functions' is missing 'be'). This fits the 'some concrete guidance but incomplete; missing key details' anchor better than the mostly-executable anchor at 4.

3 / 5

Workflow Clarity

Sections 1–3 imply a setup order (configure stack → define endpoints → add cross-cutting concerns), but they read as a standards checklist rather than a sequenced workflow, with no validation checkpoints or feedback loops (e.g., nothing to verify the stack builds or pinning works). This matches 'steps listed but validation gaps; sequence present but checkpoints missing or implicit' rather than the clearer sequenced-with-checkpoints anchor at 4.

3 / 5

Progressive Disclosure

The body is a short, well-sectioned overview that appropriately delegates code to a real one-level-deep reference (references/implementation.md, verified to exist with complete Hilt/Retrofit setup code). It falls short of the 5 anchor only through minor organization noise: the same reference link is repeated three times with identical label text, and the Anti-Patterns section duplicates inline rules instead of being cleanly complementary.

4 / 5

Total

13

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong description: third-person voice, concrete named technologies, an explicit 'Use when...' trigger clause, and a thoughtful exclusion boundary. The only weakness is that a few natural synonyms (networking, HTTP client, REST) are absent, which slightly limits trigger coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Integrate Retrofit, OkHttp, and Kotlinx Serialization for type-safe API communication', 'building API clients, adding interceptors, or configuring network security' — covering the domain comprehensively with named technologies rather than vague language. It matches the anchor for multiple specific concrete actions with comprehensive coverage; it does not fit the score-4 anchor since no meaningful capability area of the skill is left unmentioned.

5 / 5

Completeness

It explicitly answers both questions: the 'what' ('Integrate Retrofit, OkHttp, and Kotlinx Serialization for type-safe API communication in Android') and the 'when' ('Use when building API clients, adding interceptors, or configuring network security') with concrete trigger phrases. This is a direct match for the score-5 anchor; the 'when' clause is explicit, not weakly implied as at score 4.

5 / 5

Trigger Term Quality

Strong natural terms users would say: 'Retrofit', 'OkHttp', 'interceptors', 'API clients', 'network security', 'MockWebServer'. A few common variations are missing (e.g., 'networking', 'HTTP client', 'REST API'), which keeps it at the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (Android networking with three named libraries) and even adds an explicit exclusion boundary — 'not standalone MockWebServer or API-test setup' — minimizing the risk of triggering for the wrong skill. It clearly matches the 'clear niche with distinct triggers; minimal conflict risk' anchor rather than the minor-overlap anchor at 4.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

HoangNguyen0403/agent-skills-standard

Path

skills/android/android-networking/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.