CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-audit-textkit

Use when the user mentions TextKit review, text layout issues, Writing Tools integration, or UITextView/NSTextView code review.

Quality

75%

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 ./axiom-codex/skills/axiom-audit-textkit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 content is an exceptionally actionable audit procedure — exact grep patterns, executable Swift fixes, per-pattern verification steps, and a disciplined phase structure with explicit checkpoints and false-positive handling. Its only real weaknesses are minor: a couple of wordy issue paragraphs and a monolithic single-file layout where the pattern catalog and invocation examples could live in reference files.

DimensionReasoningScore

Conciseness

The body is dense, non-padded domain knowledge — exact grep patterns, iOS 18/macOS 15 API names, and fallback semantics Claude cannot reliably recall from training — with no re-explanation of basics. A few Issue paragraphs (Pattern 1, Pattern 5) are wordy and could be tightened, which matches anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') rather than 3's 'some unnecessary explanation'.

4 / 5

Actionability

Every detection pattern ships a copy-paste-ready regex, fixes are executable Swift (e.g. the `textLayoutManager` optional-binding path and the `location(_:offsetBy:)` NSRange→NSTextRange bridge), and the false-positive list plus output template make the common cases fully covered. This matches anchor 5 ('fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

The five phases are clearly sequenced with an explicit checkpoint ('Present this map in the output before proceeding'), a verification loop on every detection ('For every grep match, use Read to verify the surrounding context before reporting'), false-positive recovery guidance, and output caps for large findings. This matches anchor 5 ('clear sequence with explicit validation steps; feedback loops for error recovery'); the destructive/batch cap does not apply to a read-only audit.

5 / 5

Progressive Disclosure

The body is well-organized with clear section headers and no nested references, but it is a 344-line monolith that inlines the full pattern catalog, cross-reference tables, and invocation examples rather than splitting any of it into bundle files, and its one pointer ('axiom-uikit (skills/textkit-ref.md)') does not resolve to a file in this bundle (no references/ directory exists). This matches anchor 4 ('good structure; most content appropriately placed; minor organization gaps') rather than 5's well-signaled one-level-deep references.

4 / 5

Total

18

/

20

Passed

Description

51%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 is a well-targeted trigger list with strong niche distinctiveness and good natural keywords, but it is 'when'-only: it never tells the model what the skill does (audit for TextKit 1 fallback triggers, glyph-API misuse, missing Writing Tools configuration). Leading with a one-sentence capability statement before the 'Use when' clause would lift both completeness and specificity.

Suggestions

Lead with a concrete 'what' clause before the trigger list, e.g. 'Audits Swift/AppKit code for TextKit 1 fallback triggers, glyph-counted API misuse, and missing Writing Tools configuration, with migration fixes.'

Add the natural trigger variations users actually say for this niche — 'TextKit 2', 'NSLayoutManager', 'glyph', 'text editor migration' — to broaden keyword coverage.

State the outcome (prevents silent TextKit 1 fallback, preserves inline Writing Tools, correct layout for complex scripts) so the 'what' is explicit rather than implied by the word 'review'.

DimensionReasoningScore

Specificity

The description names the domain ("TextKit review", "text layout issues", "Writing Tools integration", "UITextView/NSTextView code review") but the only action it offers is the generic "review" — no concrete capabilities such as detecting anti-patterns, auditing for TextKit 1 fallback, or verifying Writing Tools wiring. This matches anchor 2 ('Names the domain but actions are minimal or generic') rather than 3, which requires 1-2 concrete actions.

2 / 5

Completeness

The 'when' is explicit ("Use when the user mentions..."), but the 'what' is only the word "review" embedded inside the trigger clauses — the description never states what the skill does. This falls between anchor 2 ('only when is present without what') and anchor 3 (a clear 'what' with a missing 'when'), and sits closer to 2 because the 'what' is vague rather than clear.

2 / 5

Trigger Term Quality

Phrases like "TextKit review", "text layout issues", "Writing Tools integration", and "UITextView/NSTextView code review" are natural terms a user would say in this niche. A few common variations are missing ("TextKit 2", "NSLayoutManager", "glyph", "migration"), which fits anchor 4 ('good keyword coverage; a few natural terms missing') and not 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"TextKit", "Writing Tools", and "UITextView/NSTextView" define a clear niche with distinct triggers and minimal overlap with other skills' descriptions. This matches anchor 5 ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

13

/

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

CharlesWiltgen/Axiom

Path

axiom-codex/skills/axiom-audit-textkit/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.