CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-appconfiguration-java

Azure App Configuration SDK for Java. Centralized application configuration management with key-value settings, feature flags, and snapshots.

55

Quality

69%

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

Quality

Content

65%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 code-dense, highly actionable reference for the Java SDK with excellent per-operation examples and lean prose. Its weaknesses are structural: no progressive disclosure into reference files, no validation guidance around destructive operations, and a few snippets that reference undefined variables.

Suggestions

Move bulk API detail (snapshots, feature flags, secret references) into references/*.md files and keep SKILL.md as an overview with well-signaled one-level-deep links.

Add validation guidance around destructive operations, e.g., verify the ETag or list settings before delete, and confirm snapshot status before archive/recover.

Make every snippet self-contained: define 'connectionString' (or use the AZURE_APPCONFIG_CONNECTION_STRING env var consistently) and include missing imports for List, ArrayList, and Duration; remove the boilerplate 'When to Use' filler.

DimensionReasoningScore

Conciseness

The body is dominated by compact, copy-ready code with almost no padded prose — Claude's knowledge of Azure or Java is not re-explained. Minor trims remain: async client construction appears twice ('Async Client' and 'Async Operations'), the 'When to Use' section is boilerplate filler, and the pinned version '1.10.1' is time-sensitive information not in a deprecated section. This is anchor 4 (efficient, minor instances that could be trimmed) rather than 5.

4 / 5

Actionability

Concrete, mostly executable Java code covers all common operations (CRUD with ETag conditionals, listing/filtering, feature flags, secret references, read-only locks, snapshots, error handling). Minor gaps keep it below anchor 5: 'connectionString' and 'setting' are used without being defined in some snippets, and imports for 'List', 'ArrayList', and 'Duration' are missing in the snapshot section.

4 / 5

Workflow Clarity

Each operation is individually well demonstrated, but the skill documents destructive and batch operations (deleteConfigurationSetting, archiveSnapshot) with no validation or verification guidance, and the rubric caps workflow clarity at 3 for destructive/batch operations without validation. There is no sequencing guidance (e.g., verify ETag or list before deleting, confirm before archiving a release snapshot) beyond raw API calls.

3 / 5

Progressive Disclosure

Section structure is clear and well-organized (concepts table, per-operation headers, reference links table), but the full ~400-line API reference is inlined in SKILL.md with no bundle files at all — content that clearly belongs in separate reference files (snapshots, feature flags, secret references) is inline. This sits between anchor 2 (bulk reference inlined) and anchor 4 (bulk split out), landing on 3 given the good in-page organization.

3 / 5

Total

14

/

20

Passed

Description

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

The description clearly states what the skill covers with good natural keywords and a distinct niche, but it lacks any 'Use when...' trigger guidance and describes capabilities as nouns rather than concrete actions. Adding an explicit trigger clause and verb-led capability phrasing would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g., 'Use when working with Azure App Configuration in Java, managing application settings, feature flags, labels, or configuration snapshots.'

Rephrase capabilities as concrete actions, e.g., 'Create, read, update, and delete key-value settings; manage feature flags; and create immutable snapshots.'

Include common user phrasings like 'app config' or 'application settings' to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Azure App Configuration SDK for Java') and three capability areas ('key-value settings, feature flags, and snapshots'), but these are noun phrases rather than concrete actions — no verbs like create, read, update, or delete settings. It matches anchor 3 (names domain and concrete actions, not comprehensive) better than anchor 4, which requires several specific actions.

3 / 5

Completeness

The 'what' is clearly stated ('Centralized application configuration management with key-value settings, feature flags, and snapshots') but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is above anchor 2 because the 'what' is specific, but below anchor 4, which requires an explicit 'when'.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'Azure App Configuration', 'Java', 'feature flags', 'snapshots', 'configuration' are terms users would plausibly say. A few natural variations are missing ('app config', 'application settings', 'config store'), matching anchor 4 (good coverage, a few natural terms missing) rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (a specific Azure service plus a specific language), but a generic query like 'manage app configuration' would overlap with sibling Azure SDK skills for other languages. This fits anchor 4 (mostly distinct, minor overlap risk with closely related skills) better than anchor 5, whose distinct trigger phrases leave minimal conflict risk.

4 / 5

Total

14

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/azure-appconfiguration-java/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.