CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ios-settings-patterns

Apple-platform settings design for signalbox - which control shape fits which problem, what status text should say, and the anti-patterns this project keeps rediscovering. Use when adding or changing anything in the macOS Settings window, the iOS Settings tab, or any pane that pairs a control with live state.

Quality

85%

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

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 high-quality patterns skill: nearly every line is project-specific hard-won guidance with named precedents, concrete decision tables, copy-ready status strings, and a pre-ship validation checklist, and it respects the reader's intelligence. The residual gaps are structural rather than substantive — an implicit rather than explicit step sequence, an external unverifiable mock as the only concrete layout example, and research detail that could be offloaded to a reference file.

Suggestions

Add a short numbered procedure up top (pick shape from table → draft status text per rules → check anti-patterns → run the ship checklist) so the sequence is explicit rather than implied by section order.

Move the per-app precedent survey (Spotlight/Photos/iCloud/Alfred bullets) into a references/ file and keep one summary line plus the split rule inline, freeing body tokens.

Inline one small mock snippet (a pane with label + caption + Rebuild button) so the concrete layout example does not depend solely on the external components/specs/settings.html file.

DimensionReasoningScore

Conciseness

The body is dense and project-specific throughout — the decision table, status-string rules, anti-pattern list, and worked example are all signal this project had to learn the hard way, and it assumes competence (never explains what a checkbox or Form is). The Apple HIG blockquotes ("Minimize the number of settings you offer...") are cited precedent load-bearing to the rules, not padding. It sits at 4 rather than 5 because minor trimming is possible: the Spotlight/Photos/iCloud/Alfred bullet list partly repeats the table row above it, and the four-item worked example runs long.

4 / 5

Actionability

For an instruction-only skill the guidance is unusually concrete: a seven-row problem→shape→precedent table, copy-ready status strings ("Can't reach your cloud board right now. Events are being kept and will be sent when it's back."), a named precedent for every rule, and a pre-ship checklist. Not 5 because some guidance stays abstract ("ask where the state changes a decision, and put it there") and the one concrete layout artifact is delegated to an external file ("components/specs/settings.html") with no inline example.

4 / 5

Workflow Clarity

There is a clear implicit sequence — the one rule, then shape selection, then status text, then structure, then anti-patterns as a check — and an explicit validation checkpoint: the "Before you ship a settings change" checklist. No destructive or batch operations are involved, so the workflow cap does not apply. Held at 4 rather than 5 because the procedure is never laid out as an explicit ordered workflow (the reader assembles it from section order), and the only error-recovery model is implicit in the worked example's four wrong answers.

4 / 5

Progressive Disclosure

This is a single-file skill with no bundle (no references/, scripts/, or assets/ exist), and the body is well-sectioned rather than a monolithic wall. The "Where the evidence lives" section gives one-level-deep, per-file pointers with a clear 'start here' (synthesis.md) and a description of each file's most reusable content — good navigation. Not 5: the detailed six-agent research is summarized inline across several sections (shape precedents, status text rules) that could sit in a reference file, and the pointed-to paths live outside the skill bundle, so the reference structure cannot be verified.

4 / 5

Total

16

/

20

Passed

Description

87%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: it states what the skill covers in concrete terms, gives an explicit and specific 'Use when' clause naming the exact surfaces, and is tightly scoped to this project so conflict risk is minimal. The main room for improvement is trigger-term breadth — a few natural synonyms (preferences, toggle, checkbox) are absent.

Suggestions

Add natural synonyms to the trigger clause, e.g. 'Use when adding or changing settings/preferences controls — checkboxes, toggles, radios — in the macOS Settings window...'.

Mention the pane/tab structure guidance (e.g. 'how to organize panes and toolbar tabs') so the description covers that body section too.

DimensionReasoningScore

Specificity

Names the domain ("Apple-platform settings design for signalbox") and three concrete coverage areas: "which control shape fits which problem, what status text should say, and the anti-patterns this project keeps rediscovering." This matches the 4 anchor (several specific items, minor gaps) rather than 5, because the body also covers pane/tab structure and iOS-specific conventions that the description omits; it is well above 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

Explicitly answers both questions: what ("which control shape fits which problem, what status text should say, and the anti-patterns") and when ("Use when adding or changing anything in the macOS Settings window, the iOS Settings tab, or any pane that pairs a control with live state"). The when-clause is concrete with specific trigger surfaces, matching the 5 anchor exactly; nothing below 5 fits since neither what nor when is weak or implied.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: "macOS Settings window", "iOS Settings tab", "pane that pairs a control with live state", "status text". Falls short of the 5 anchor because common synonyms are missing — notably "preferences" (the macOS idiom), "toggle", "checkbox", and "label" — which are all terms the body itself uses and a user would plausibly say.

4 / 5

Distinctiveness Conflict Risk

The niche is pinned to one project and its named surfaces ("signalbox", "macOS Settings window", "iOS Settings tab"), so it would not fire for generic Apple HIG, UI-copy, or documentation skills. Clear niche with distinct triggers — the 5 anchor; even the 4 anchor's 'minor overlap risk' with closely related skills does not apply given the project-specific scoping.

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

dwmkerr/signalbox

Path

.claude/skills/ios-settings-patterns/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.