swiftui-audit

Runs the full evidence-backed macOS SwiftUI audit suite over a project.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? SwiftUI codebases accumulate deprecated modifiers, outdated idioms, and API misuse that standard linters miss. This Skill runs a coordinated, multi-domain audit of a macOS SwiftUI project so every finding is grounded in real shipping-app evidence and current Apple documentation. ## Core Features & Use Cases - Full audit orchestration: Runs a relevance scan, then delegates to the audit-macos-swiftui-full orchestrator across dependency waves covering guards, state and data, UI domains, and boundaries. - Structured findings: Writes per-finding Markdown reports under swiftui-audits/ using a shared finding schema, plus a _SUMMARY.md with a 0-100 nativeness score. - Strict or advisory gating: Reads project settings to label hard findings as release-blocking or advisory, with a matching audit-gate.sh mode for CI exit behavior. - Use Case: Before shipping a macOS app update, run the full audit to surface deprecated SwiftUI APIs and state-management issues, then review the scored summary and verified findings. ## Quick Start Ask the agent to run $swiftui-audit on this macOS SwiftUI project and produce the audit report.

Frequently Asked Questions about swiftui-audit

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

FAQPage Schema
How do I run a full SwiftUI audit on my macOS project?

Invoke $swiftui-audit against your project directory. It creates a swiftui-audits folder, runs a relevance scan, then executes the audit domains in dependency waves and writes per-finding Markdown plus a scored summary.

What does the SwiftUI audit report contain?

The report contains per-finding Markdown files following a shared finding schema, plus a _SUMMARY.md with a 0-100 nativeness score. Every finding requires source inspection and verification against the bundled corpus and current Apple documentation.

Can the SwiftUI audit block a CI release?

Yes. With strict_audit set to true or left unset, hard findings are labeled release-blocking, and the audit-gate.sh script accepts matching --strict or --advisory modes to control CI exit behavior.

Does the SwiftUI audit fix issues automatically?

Fixes are applied only when the user explicitly requests them and the shared fix-safety protocol permits them. Otherwise all findings remain open for manual review and remediation.

When should I not run the full SwiftUI audit?

Skip it when you only need a single domain checked, since the full suite runs all relevant audit domains and is intended for explicit, comprehensive reviews. It activates only when explicitly requested with $swiftui-audit.