CtrlK
BlogDocsLog inGet started
Tessl Logo

macos-menubar-tuist-app

Build, refactor, or review SwiftUI macOS menubar apps that use Tuist.

60

Quality

70%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/macos-menubar-tuist-app/SKILL.md

The canonical home for this skill is macos-menubar-tuist-app in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

81%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, actionable, and exceptionally well-structured with explicit validation and feedback loops. Its only notable gap is that moderately long inlined sections could benefit from one-level-deep reference files.

Suggestions

Move the validation matrix and/or failure-pattern/fix-direction reference into a separate referenced file and link to it from the overview.

Replace the '<TargetName>' placeholder in the validation command with a note on how to discover the actual scheme name.

Provide canonical contents for run-menubar.sh / stop-menubar.sh (or a referenced snippet) so the launch path is fully copy-paste ready.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence, never explaining what SwiftUI or Tuist are, with only minor restatement between 'When to Use' and the description that could be trimmed.

4 / 5

Actionability

It provides concrete executable commands (e.g., 'TUIST_SKIP_UPDATE_CHECK=1 tuist xcodebuild build ...', 'bash -n run-menubar.sh') and a clear file-placement map, with minor gaps like the '<TargetName>' placeholder and absent full script contents.

4 / 5

Workflow Clarity

A clear numbered bottom-to-top build sequence is paired with an explicit validation matrix, a failure-pattern/fix-direction feedback loop, and a completion checklist, giving explicit validation checkpoints and error-recovery guidance.

5 / 5

Progressive Disclosure

The content is well-organized into clearly headed sections in a single self-contained file, but inlined blocks like the validation matrix and failure patterns could be split into referenced files, so it sits just below the ideal one-level-deep reference structure.

4 / 5

Total

17

/

20

Passed

Description

58%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 specific and distinct but omits an explicit trigger/Use-when clause, which caps its completeness. Trigger term coverage is solid but lacks synonyms users would naturally say.

Suggestions

Add an explicit 'Use when ...' clause naming concrete triggers (e.g., menubar utilities, status item apps, Tuist manifests).

Include natural synonyms and variations users might say, such as 'menu bar', 'status bar item', or 'LSUIElement app'.

Expand the action list toward comprehensive coverage (e.g., 'generate manifests, wire launch scripts, enforce architecture boundaries').

DimensionReasoningScore

Specificity

The phrase 'Build, refactor, or review' names several concrete actions against a clear domain, but the actions are coarse-grained and lack fuller coverage (e.g., manifests, launch scripts), placing it above the 3 anchor and just below comprehensive 5.

4 / 5

Completeness

It clearly states what the skill does but lacks any explicit 'Use when...' trigger clause, so per the judging guidelines completeness is capped at 3.

3 / 5

Trigger Term Quality

Natural terms like 'SwiftUI macOS menubar apps' and 'Tuist' appear, but common variations users might say (e.g., 'menu bar', 'status bar item', file extensions) are missing, matching the 'some relevant keywords but missing variations' anchor.

3 / 5

Distinctiveness Conflict Risk

The narrow intersection of SwiftUI, macOS menubar, and Tuist gives a clear niche with distinct triggers and only minor overlap risk with general Swift skills.

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.

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.