CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-communication-common-java

Azure Communication Services common utilities for Java. Use when working with CommunicationTokenCredential, user identifiers, token refresh, or shared authentication across ACS services.

57

Quality

66%

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/azure-communication-common-java/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

A well-organized, highly actionable API-reference-style skill whose code examples cover the main ACS authentication patterns. Its weaknesses are a monolithic 300-line structure with zero external reference files, filler sections, and a pinned dependency version that will age.

Suggestions

Split identifier construction/parsing/type-checking and the Entra ID / cloud-environment reference into references/ files (e.g. references/identifiers.md, references/entra-auth.md) linked one level deep from SKILL.md, keeping only the credential quick-start patterns inline.

Delete the filler "When to Use" section ("This skill is applicable to execute the workflow or actions described in the overview") and fold the "Trigger Phrases" list into the description or drop it as duplication.

Remove or contextualize the pinned version ("1.4.0") and add a short error-handling example for token refresh failures to back up the 'Handle token refresh failures gracefully' best practice.

DimensionReasoningScore

Conciseness

The body is mostly tight code examples, but it carries clear padding: a 300-line inlined API reference, three near-duplicate token-refresh variants, a boilerplate "When to Use" section ("This skill is applicable to execute the workflow or actions described in the overview") that adds nothing, and a pinned time-sensitive version ("1.4.0") with no deprecation context. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 2, since there is little concept over-explanation.

3 / 5

Actionability

Nearly every section gives copy-paste-ready Java with imports and realistic placeholders ("https://<resource>.communication.azure.com", "+14255551234"), covering the common cases (static token, proactive refresh, identifiers, dispose). A few snippets reference undefined symbols ("fetchNewTokenFromServer()", "currentToken", "chatClient.doSomething()"), which are minor gaps matching anchor 4 rather than fully self-contained anchor 5.

4 / 5

Workflow Clarity

Usage-condition-labeled patterns ("Static Token (Short-lived Clients)" vs "Proactive Token Refresh (Long-lived Clients)") plus a Best Practices list give an unambiguous decision path for the skill's single purpose — no destructive or batch operations, so no validation cap applies. It falls short of anchor 5 because "Handle token refresh failures gracefully" is asserted without any error-handling example or feedback loop.

4 / 5

Progressive Disclosure

Section headers and a Key Concepts table give real structure, but the skill is a monolithic ~305-line SKILL.md with no references/ directory at all: identifier parsing/type-checking, Entra ID auth, and cloud-environment reference material clearly belong in separate one-level-deep files. This matches anchor 3 ('content that should be separate is inline'); it is not 2 because navigation within the file is easy, and not 4+ because nothing is split out.

3 / 5

Total

14

/

20

Passed

Description

70%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.

A solid description with an explicit 'Use when' trigger clause and recognizable SDK-specific trigger terms. Its main weakness is the generic action phrase 'common utilities', which undersells the concrete capabilities (token refresh configuration, identifier parsing, Entra ID auth) documented in the body.

Suggestions

Replace the vague action phrase 'common utilities' with concrete verbs, e.g. 'Configure CommunicationTokenCredential with proactive/async token refresh, construct and type-check ACS user/phone/Teams identifiers, and authenticate with Entra ID for Teams extensibility.'

Add the natural synonyms users say that are currently missing, such as 'user access token', 'ACS token', or 'Teams extensibility', to improve trigger coverage.

Mention the related client services (Chat, Calling) explicitly so the shared-authentication use case ('shared authentication across ACS services') is more concrete.

DimensionReasoningScore

Specificity

"Azure Communication Services common utilities for Java" names the domain clearly and points at concrete objects ("CommunicationTokenCredential", "token refresh", "user identifiers"), but the stated action — "common utilities" — is generic rather than a list of specific actions like 'configures token refresh' or 'parses identifiers'. It sits between anchor 3 (domain plus limited concrete actions) and anchor 4 (several specific actions); the vague action verb keeps it at 3.

3 / 5

Completeness

Both parts are explicit: the what ("common utilities for Java" for ACS authentication/identifiers) and an explicit when-clause ("Use when working with CommunicationTokenCredential, user identifiers, token refresh, or shared authentication across ACS services"). It is not a 5 because the what-clause is thinner and less concrete than the anchor-5 example, matching anchor 4 ('when' present, 'what' could be more specific).

4 / 5

Trigger Term Quality

Natural developer terms are present — "CommunicationTokenCredential", "token refresh", "user identifiers", "ACS", "Azure Communication Services" — which a user working in this SDK would plausibly say. A few common variations are missing ("user access token", "ACS token", Chat/Calling client authentication), so it matches anchor 4 rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (ACS auth/token credentials for Java) with distinct class-name triggers, giving minimal conflict risk. There is minor overlap potential with generic Azure identity/SDK skills or sibling ACS service skills (Chat, Calling), which keeps it at anchor 4 rather than 5.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
sickn33/agentic-awesome-skills
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.