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.