CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

window-management

Customize macOS SwiftUI windows and scene behavior. Use when tuning window chrome, drag regions, placement, restoration, launch behavior, or borderless windows.

67

Quality

84%

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

78%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, actionability-focused skill: sections are organized by concern, exact API modifiers are named, concrete code is properly offloaded to a real one-level reference, and the workflow ends with a verification step and checklist. Weaknesses are mild: some guidance is repeated across sections/guardrails, and the reference snippets rely on undefined helper functions.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence — no padding explaining what SwiftUI or windows are, and bullets are concrete directives. Minor trimming is possible: the Review Checklist and Guardrails restate several section bullets (e.g., drag-region and restoration rules appear three times), and a few soft-advisory lines ("Keep one clear path back to regular window management...") could be tightened, keeping it below the lean 5 anchor.

4 / 5

Actionability

Guidance is concrete throughout, naming exact modifiers (`.toolbar(removing: .title)`, `.windowMinimizeBehavior(.disabled)`, `.defaultWindowPlacement { content, context in ... }`, `content.sizeThatFits(.unspecified)`, `context.defaultDisplay.visibleRect`) and deferring executable examples to the reference file. Not a 5 because the reference snippets call undefined helpers (`clampToDisplay`, `zoomToFit`, `centeredPosition`), so the code is not fully copy-paste ready.

4 / 5

Workflow Clarity

The 7-step workflow is clearly sequenced, includes an explicit verification checkpoint ("Build and launch the app with `build-run-debug` to verify the result"), a conditional fallback (step 7 → `appkit-interop`), and a Review Checklist. It stops short of the 5 anchor because there is no explicit fix-and-retry loop if verification reveals a problem (e.g., what to check when drag or placement misbehaves).

4 / 5

Progressive Disclosure

The body is a well-sectioned overview and all executable code lives in one clearly signaled, one-level-deep reference ("For concrete window modifier examples, read `references/api-snippets.md`") that exists in the bundle. No nested references and no inline API dump, matching the clear-split 5 anchor.

5 / 5

Total

17

/

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 description: explicit what and when clauses, third-person-style imperative voice, and a concrete list of trigger domains. The main gaps are the single general verb ("Customize") rather than multiple distinct actions, and a few missing natural synonyms (title bar, zoom, full screen).

DimensionReasoningScore

Specificity

The description names the domain ("macOS SwiftUI windows and scene behavior") and lists several concrete customization targets ("window chrome, drag regions, placement, restoration, launch behavior, or borderless windows"). It falls short of a 5 because the only verb is the general "Customize" applied to feature areas rather than multiple distinct concrete actions like extract/fill/merge/convert.

4 / 5

Completeness

It explicitly answers both questions: what ("Customize macOS SwiftUI windows and scene behavior") and when ("Use when tuning window chrome, drag regions, placement, restoration, launch behavior, or borderless windows") with concrete trigger phrases. The voice matches the imperative style of the top anchor examples, with no first/second-person penalty.

5 / 5

Trigger Term Quality

Good natural keyword coverage including "window chrome", "drag regions", "placement", "restoration", and "borderless windows" — phrases a user would plausibly say. A few natural variants are missing (e.g., "title bar", "zoom", "full screen", "window controls"), so it does not reach the comprehensive-synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The macOS + SwiftUI + window/scene-management niche is clear and the trigger areas are distinctive. Minor overlap risk remains with broader SwiftUI layout/scene skills (e.g., a general swiftui-patterns skill) for generic "window" requests, which keeps it just below the minimal-conflict 5 anchor.

4 / 5

Total

17

/

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

openai/plugins

Path

plugins/build-macos-apps/skills/window-management/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.