audit-swiftui-typography-text

Audits macOS SwiftUI typography code for deprecated APIs, Dynamic Type defects, and hallucinated text modifiers.

2|1|Updated Jun 7, 2026
One-click install
npx skills add https://github.com/yigitkonur/plugin-swiftui --skill audit-swiftui-typography-text-yigitkonur
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-swiftui-typography-text
Source: https://github.com/yigitkonur/plugin-swiftui/tree/main/plugins/swiftui/skills/audit-swiftui-typography-text
Command: npx skills add https://github.com/yigitkonur/plugin-swiftui --skill audit-swiftui-typography-text-yigitkonur

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ast-grep, and includes scripts (resource) and references (resource) components.

What problem does it solve? AI-generated SwiftUI text code frequently contains deprecated patterns like Text + Text concatenation, hardcoded font sizes that break Dynamic Type, and invented APIs such as .fontSize() that never existed. This Skill audits a macOS SwiftUI codebase for nine specific typography defects and reports or fixes them with evidence grounded in real shipping apps. ## Core Features & Use Cases - Nine-rule defect detection: Covers deprecated Text + Text concatenation, the design-only Font.system overload, hardcoded font sizes, missing lineLimit space reservation, malformed AttributedString, mis-gated TextRenderer, hand-rolled label rows, jiggling numerics without monospacedDigit(), and hallucinated type APIs. - Hybrid lint engine: Combines tier-1 grep tells with a tier-2 ast-grep structural rule for multi-line Text + Text, emitting unified JSON and SARIF output with parse-probe warnings. - Evidence-grounded fixes: Verifies uncertain findings against a corpus of 1,857 shipping macOS apps via the swiftui-ctx CLI and Apple documentation via Sosumi, then applies safe auto-fixes (e.g., appending weight: .regular) under a fix-safety protocol. - Use Case: Point the Skill at an in-progress macOS SwiftUI project to receive structured findings in swiftui-audits/typography-text/, each citing a real GitHub permalink and Apple doc, with mechanical defects fixed automatically. ## Quick Start Audit the SwiftUI sources in my macOS project for typography and text defects and write the findings to the swiftui-audits folder.

Frequently Asked Questions about audit-swiftui-typography-text

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit SwiftUI text and typography code on macOS?▼

Run the shared lint runner with this skill's rule set against your SwiftUI sources, then read each located file in full before reporting. Confirmed findings are written to swiftui-audits/typography-text/ with severity, fix mode, and citations.

What SwiftUI typography defects does this audit detect?▼

It detects nine defects: deprecated Text + Text concatenation, the design-only Font.system overload, hardcoded font sizes, lineLimit without reservesSpace, malformed AttributedString, mis-gated TextRenderer, hand-rolled label rows, missing monospacedDigit on live numerics, and invented type APIs.

Does the audit automatically fix SwiftUI typography issues?▼

Only txt-02, the deprecated design-only Font.system overload, is auto-fixed by appending weight: .regular under a clean-tree fix-safety protocol. All other findings are flag-only, reported with a grounded correct example for the developer to apply.

Can this audit catch hallucinated SwiftUI text APIs?▼

Yes, rule txt-09 is a hard-fail check for invented names like .fontSize(), .textStyle(), Text(styled:), and .attributedText(). A swiftui-ctx lookup exit code 3 corroborates that no shipping Mac app uses the symbol.

Is this skill limited to macOS SwiftUI projects?▼

Yes, it is macOS-only and SwiftUI-only, targeting macOS 26 deployment floors. AppKit NSTextView and NSAttributedString bridging are explicitly out of scope, and availability gating checks use the macOS arm only.