kotlin-specialist
tessl i github:jeffallan/claude-skills --skill kotlin-specialistUse when building Kotlin applications requiring coroutines, multiplatform development, or Android with Compose. Invoke for Flow API, KMP projects, Ktor servers, DSL design, sealed classes.
61%
Overall
Validation
Implementation
Activation
Validation
75%| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md line count is 95 (<= 500) | Pass |
frontmatter_valid | YAML frontmatter is valid | Pass |
name_field | 'name' field is valid: 'kotlin-specialist' | Pass |
description_field | 'description' field is valid (188 chars) | Pass |
description_voice | 'description' uses third person voice | Pass |
description_trigger_hint | Description includes an explicit trigger hint | Pass |
compatibility_field | 'compatibility' field not present (optional) | Pass |
allowed_tools_field | 'allowed-tools' field not present (optional) | Pass |
metadata_version | 'metadata' field is not a dictionary | Warning |
metadata_field | 'metadata' field not present (optional) | Pass |
license_field | 'license' field is missing | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
body_present | SKILL.md body is present | Pass |
body_examples | No examples detected (no code fences and no 'Example' wording) | Warning |
body_output_format | Output/return/format terms detected | Pass |
body_steps | Step-by-step structure detected (ordered list) | Pass |
Total | 12 / 16 Passed |
Implementation
42%The skill has strong progressive disclosure with a well-organized reference table, but critically lacks actionable code examples. The content reads more like a role description than executable guidance - it tells Claude what patterns to use without showing how. The constraints are useful but would benefit from concrete examples of correct vs incorrect code.
Suggestions
- Add executable code examples for key patterns: a coroutine/Flow example, a sealed class state modeling example, and a DSL builder example
- Replace the abstract 'Role Definition' paragraph with a concrete quick-start code snippet demonstrating idiomatic Kotlin
- Add validation checkpoints to the Core Workflow, especially for steps 3-4 (e.g., 'Run detekt/ktlint before committing', 'Verify coroutine tests pass with runTest')
- Convert MUST DO/MUST NOT DO items into concrete before/after code examples showing the correct pattern
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary framing ('You are a senior Kotlin engineer with 10+ years...') and the 'When to Use This Skill' section largely duplicates the description. The constraints and knowledge reference sections are reasonably efficient. | 2 / 3 |
Actionability | No executable code examples are provided. The content describes what to do abstractly ('Use sealed class for state modeling', 'Use Flow for reactive streams') but never shows concrete, copy-paste ready implementations. The workflow is high-level without specific commands or code. | 1 / 3 |
Workflow Clarity | The 5-step core workflow provides a sequence but lacks validation checkpoints or feedback loops. For a skill involving coroutines and multiplatform development where errors are common, there's no guidance on verification steps or error recovery. | 2 / 3 |
Progressive Disclosure | Excellent use of a reference table with clear topics, file paths, and 'Load When' conditions. The structure appropriately keeps the main skill as an overview while pointing to detailed references one level deep. | 3 / 3 |
Total | 8 / 12 Passed |
Activation
72%This description excels at trigger terms and distinctiveness with comprehensive Kotlin ecosystem keywords, making it easy to identify when needed. However, it lacks specificity about what actions or capabilities the skill provides - it tells Claude when to use it but not what it actually does beyond 'building applications'.
Suggestions
- Add concrete actions describing what the skill does, e.g., 'Guides architecture patterns, implements coroutine scopes, configures Gradle multiplatform builds'
- Replace the vague 'building Kotlin applications' with specific capabilities like 'structure suspend functions, design state flows, create platform-specific implementations'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Kotlin) and lists several specific technologies (coroutines, multiplatform, Compose, Flow API, KMP, Ktor, DSL, sealed classes), but doesn't describe concrete actions - only mentions 'building' without specifying what actions the skill performs. | 2 / 3 |
Completeness | Has explicit 'Use when' and 'Invoke for' clauses addressing when to use it, but the 'what does this do' is weak - it only says 'building applications' without describing specific capabilities or actions the skill provides. | 2 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Kotlin', 'coroutines', 'multiplatform', 'Android', 'Compose', 'Flow API', 'KMP', 'Ktor', 'DSL', 'sealed classes' - these are all terms developers naturally use when working in this domain. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with Kotlin-specific terminology (KMP, Ktor, sealed classes, Flow API, Compose) that clearly separates it from general programming skills or other language-specific skills. | 3 / 3 |
Total | 10 / 12 Passed |
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.