CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swift-style-skill

A practical, opinionated Swift style skill for writing, reviewing, and refactoring modern Swift code. Covers naming, formatting, file organization, documentation, and coding conventions. Project instructions and formatter/linter configurations take precedence over its defaults.

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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-structured, lean style-skill body: concrete rules, a clear sequenced workflow with mode-specific outputs, and exemplary one-level-deep routing to real reference files. Its only weaknesses are minor repetition of the precedence rule and the lack of an explicit validation checkpoint in the workflow.

Suggestions

State the project-precedence rule once (e.g., in Agent Behavior) and drop the verbatim repeats in the intro and Workflow to reclaim tokens.

Add a lightweight verification step to the workflow, e.g. after refactoring, confirm behavior and API compatibility are unchanged before finishing.

Trim the opening paragraph, which restates the frontmatter description nearly verbatim.

DimensionReasoningScore

Conciseness

The body is dense, rule-based, and assumes Claude's competence — no tutorial padding or explanations of concepts Claude already knows. It falls short of 5 only because the precedence rule ("Project instructions and formatter/linter configurations take precedence over this skill's defaults") is stated in the intro, again in Workflow step 3, and again verbatim in Agent Behavior, plus the opening paragraph largely restates the frontmatter description — minor repetition that could be trimmed.

4 / 5

Actionability

As an instruction-only skill, the guidance is maximally concrete and directly applicable: exact casing rules ("UpperCamelCase", "lowerCamelCase"), precise limits ("120-column default limit, 4-space indentation, no tabs, no semicolons, K&R braces"), and fully specified exceptions for blank-line placement. This exceeds anchor 4's "minor gaps" — every rule is executable as written.

5 / 5

Workflow Clarity

The Workflow section gives a clear five-step sequence with per-mode outputs and an explicit conflict-handling checkpoint ("identify it and ask the user how to proceed"), and the audit path includes a safety constraint ("Do not edit files during an audit"). It falls short of anchor 5 because there is no explicit validation/verification checkpoint (e.g., confirming behavior preservation after style changes), though the skill involves no destructive or batch operations that would warrant a cap of 3.

4 / 5

Progressive Disclosure

The body is a lean overview with a Routing section that maps each topic to exactly one of four reference files ("Naming questions or violations: references/NAMING.md" etc.), all of which exist, and none of which reference further files — references are one level deep and clearly signaled. This matches the anchor's pattern of well-signaled, shallow, easy-to-navigate structure.

5 / 5

Total

18

/

20

Passed

Description

83%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 strong, third-person description that states concrete capabilities and a precise topical scope with negligible fluff. Its main gap is the absence of an explicit "Use when..." trigger clause and a few natural trigger synonyms users might phrase differently.

Suggestions

Add an explicit trigger clause, e.g. "Use when writing, reviewing, refactoring, or auditing Swift code, or when the user asks about Swift naming, formatting, or style conventions."

Include a few natural synonyms users actually say, such as "Swift style guide" or "clean/idiomatic Swift", to broaden trigger coverage.

Consider mentioning the audit mode ("...and auditing") since the body defines it as a supported task mode.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions ("writing, reviewing, and refactoring modern Swift code") and comprehensively lists coverage areas ("naming, formatting, file organization, documentation, and coding conventions"), matching the anchor for multiple specific concrete actions with comprehensive coverage. It does not fall to 4 because no meaningful capability area is left unstated for a style skill.

5 / 5

Completeness

The 'what' is explicit and concrete. The 'when' is present via "for writing, reviewing, and refactoring modern Swift code", which is equivalent trigger guidance, but it is embedded in the what-statement rather than an explicit 'Use when...' trigger clause, so it could be more explicit — matching anchor 4 rather than 5. It is not capped at 3 because the phrase does explicitly state the situations in which the skill applies.

4 / 5

Trigger Term Quality

Natural terms a user would say are present: "Swift", "style", "naming", "formatting", "reviewing", "refactoring", "coding conventions", "documentation". It falls short of 5 because common user phrasings like "Swift style guide", "idiomatic Swift", "clean up my Swift code", or "lint" are missing, while clearly exceeding anchor 3's "some relevant keywords but missing common variations".

4 / 5

Distinctiveness Conflict Risk

The description is tightly scoped to Swift code style, giving it a clear niche with minimal conflict risk — a user naming Swift, naming conventions, or formatting would only match this skill. It matches anchor 5 and does not sit at 4, since no broader skill domain (general code style, other languages) is invoked.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

pchelnikov/Swift-Style-Skill

Path

swift-style-skill/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.