CtrlK
BlogDocsLog inGet started
Tessl Logo

avalonia-layout-zafiro

Guidelines for modern Avalonia UI layout using Zafiro.Avalonia, emphasizing shared styles, generic components, and avoiding XAML redundancy.

66

1.22x
Quality

53%

Does it follow best practices?

Impact

86%

1.22x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/avalonia-layout-zafiro/SKILL.md

The canonical home for this skill is avalonia-layout-zafiro in sickn33/agentic-awesome-skills

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 lean and well-sectioned with a usable checklist and anti-patterns, but it is undermined by missing executable examples and, more critically, by a content map that references five files and a local repo path that do not exist in the bundle. Progressive disclosure fails in practice despite a clean table layout.

Suggestions

Provide the referenced bundle files (themes.md, containers.md, containers.md, icons.md, behaviors.md, components.md) under references/, or inline the essential guidance so the skill is self-contained.

Add at least one concrete, copy-paste-ready axaml snippet per major topic (e.g., a HeaderedContainer and an EdgePanel example) to raise actionability.

Replace the hardcoded '/mnt/fast/Repos/angor/...' pointer with a portable reference (a repo URL or an included example) and replace the vague 'When to Use' boilerplate with specific trigger conditions.

DimensionReasoningScore

Conciseness

The body is mostly efficient: short sections, a compact content map, a checklist, and terse anti-patterns, with little explanation of concepts Claude already knows. It is below 5 because of mild filler ('Master modern, clean, and maintainable Avalonia UI layouts', 'Read ONLY files relevant to the layout challenge!') and some redundancy between the checklist and anti-patterns, and above 3 because the padding is minor rather than pervasive.

4 / 5

Actionability

It names concrete APIs and patterns (e.g., 'HeaderedContainer instead of Border', '{Icon fa-name}', 'EdgePanel', 'DynamicResource'), but provides no executable axaml code or worked examples, and the detail files it points to for the real guidance do not exist. It is above 2 because specific components/patterns are named rather than only high-level hints, but below 4 because guidance is incomplete and no copy-paste-ready examples are present.

3 / 5

Workflow Clarity

There is useful structure (a content map with 'when to read', a checklist, DO/DON'T lists) but no sequenced multi-step workflow, and the closing 'When to Use' is vague boilerplate ('applicable to execute the workflow or actions described in the overview'). It is above 2 because the sections provide a rough navigable order, but below 4 because no explicit sequence or checkpoints tie the guidelines into a process.

3 / 5

Progressive Disclosure

The content map clearly signals five one-level-deep references (themes.md, containers.md, icons.md, behaviors.md, components.md), but none of these files exist in any bundle directory, and the 'Related Project' link points to a hardcoded local path (/mnt/fast/Repos/angor/...) that is not portable. The design intent is good but navigation is broken because every reference leads nowhere, so it lands at the 'references buried / structure fails' level rather than a 3.

2 / 5

Total

12

/

20

Passed

Description

53%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 names a specific, well-scoped niche (Avalonia UI layout with Zafiro.Avalonia) but omits any 'when to use' trigger guidance, capping completeness at 3. It is distinctive and reasonably specific, though its listed items are emphases rather than concrete actions.

Suggestions

Add an explicit 'Use when...' clause stating natural triggers, e.g., 'Use when building or refactoring Avalonia UI layouts with Zafiro.Avalonia, or when the user mentions Zafiro, Avalonia layouts, or XAML redundancy.'

Reframe the emphasis list as concrete actions (e.g., 'Compose layouts with semantic containers, organize shared styles, and extract generic components') to lift specificity toward 4-5.

Include common synonyms/file extensions users might say (e.g., 'axaml', '.axaml', 'Avalonia XAML') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Avalonia UI layout using Zafiro.Avalonia') and lists three focus areas ('shared styles, generic components, and avoiding XAML redundancy'), but these read as thematic emphases rather than concrete executable actions, matching the anchor that names the domain with 1-2 concrete actions but is not comprehensive. It is above 2 because multiple specific areas are named, but below 4 because no concrete operations (e.g., 'create themes', 'compose containers') are stated.

3 / 5

Completeness

There is a clear 'what' (guidelines for modern Avalonia UI layout), but 'when' is entirely absent with no 'Use when' clause or equivalent trigger guidance, which per the guidelines caps completeness at 3. It is above 2 because the 'what' is explicit rather than vague, but below 4 because the 'when' is missing rather than merely weak.

3 / 5

Trigger Term Quality

It includes relevant natural keywords a user might say ('Avalonia UI layout', 'XAML', 'shared styles') but lacks common variations/synonyms and has no natural trigger phrase. It is above 2 because the keywords are domain-specific and not purely generic, but below 4 because coverage of natural terms is incomplete and no 'Use when' phrasing is present.

3 / 5

Distinctiveness Conflict Risk

Naming both the framework ('Avalonia') and the specific library ('Zafiro.Avalonia') carves a clear niche with minimal conflict risk against unrelated skills. It is below 5 because a broader generic 'Avalonia' skill could still overlap, and above 3 because the Zafiro.Avalonia qualifier makes it mostly distinct.

4 / 5

Total

13

/

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.

Validation15 / 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
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.