CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

island-best-practice

Conventions, architecture, and design patterns for the boring.notch macOS Dynamic Island app. Use this skill whenever working on any feature, bugfix, or refactor in boring.notch — including adding new views, managers, settings, animations, or modifying the notch layout. Also consult this when the user asks about how the project works, how to add a new module, or when you need to understand the codebase structure before making changes.

65

Quality

82%

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

The canonical home for this skill is island-best-practice in SnowingFox/macos-island

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 project-conventions skill: the body stays at overview altitude, defers module detail to six real, clearly-signaled reference files, and gives concrete wiring recipes and checklists for the most common tasks. The consistent 4s reflect small gaps — placeholder code in templates, no validation feedback loop in the feature checklist, and two links escaping the bundle — rather than any structural weakness.

DimensionReasoningScore

Conciseness

The body is dense with project-specific facts (state layers, file paths, enum conventions, the ContentView composition tree) and avoids explaining general Swift/SwiftUI knowledge, with every section carrying project rules. Minor trimming is possible — e.g., the full NotchLayout tree and the singleton boilerplate template restate some things inferable from the code — so it sits at anchor 4 rather than the lean anchor 5.

4 / 5

Actionability

Mostly executable guidance: a copy-paste-ready Defaults key snippet, an exact enum/switch wiring recipe ('Add a case to NotchViews enum in enums/generic.swift'), and a 10-item feature checklist with concrete file names. The manager template contains ellipsis placeholders ('func startMonitoring() { ... }') and the conditional-modifier example is illustrative rather than runnable, which keeps it just below anchor 5.

4 / 5

Workflow Clarity

Multi-step processes are clearly sequenced — 'When adding a new top-level view' (4 numbered steps) and 'Checklist for New Features' (10 steps) — and step 8 ('Test both open and closed notch states, and with liquid glass on/off') provides a verification checkpoint. There is no explicit error-recovery/feedback loop around that test step, so it matches anchor 4 ('clear sequence with most checkpoints; minor validation gaps') rather than anchor 5. No destructive/batch operations, so the workflow cap does not apply.

4 / 5

Progressive Disclosure

The body is a genuine overview with a well-signaled one-level-deep reference table ('When to read' column), and all six referenced files (animation-patterns.md, design-conventions.md, music-module.md, widget-system.md, window-and-input.md, xcode-integration.md) exist in references/. The minor gap is the out-of-bundle relative links to ../../../ARCHITECTURE.md and ../../../BUILD.md, which do not resolve within the skill bundle, keeping it at anchor 4 ('minor organization gaps') rather than anchor 5.

4 / 5

Total

16

/

20

Passed

Description

82%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 description that clearly states both what the skill covers and when to use it, with an unusually explicit and well-scoped trigger section. The only deductions are a second-person phrase ('when you need to understand...') violating the third-person voice rule and slightly generic action coverage.

DimensionReasoningScore

Specificity

The description names the domain ('boring.notch macOS Dynamic Island app') and lists several concrete work types ('adding new views, managers, settings, animations, or modifying the notch layout', 'how to add a new module'), which would fit anchor 4, but the second-person phrase 'when you need to understand the codebase structure before making changes' triggers the mandated 1-point specificity penalty, bringing it to anchor 3 territory (domain named with concrete actions, though coverage leans generic — 'any feature, bugfix, or refactor').

3 / 5

Completeness

It explicitly answers both questions: what ('Conventions, architecture, and design patterns for the boring.notch macOS Dynamic Island app') and when ('Use this skill whenever working on any feature, bugfix, or refactor... Also consult this when the user asks about how the project works...'), with concrete trigger phrases matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Good natural-phrase coverage: 'feature', 'bugfix', 'refactor', 'adding new views', 'settings', 'animations', 'notch layout', 'how the project works', 'add a new module' are things a contributor would actually say. A few natural terms are missing (e.g., 'widget', 'shelf', 'lyrics', 'calendar'), and no synonyms or file names are given, so it falls just short of anchor 5's comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to one specific named app ('boring.notch macOS Dynamic Island app'), a clear niche with distinct triggers; virtually no overlap risk with other skills, matching anchor 5.

5 / 5

Total

17

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

SnowingFox/macos-island

Path

.codex/skills/island-best-practice/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.