swiftui-api-gap
Generate and maintain deterministic SwiftUI-vs-Raven API parity reports and automation. Use when users ask to audit missing SwiftUI components/APIs, refresh coverage reports, reduce report noise, tune matching logic (owner-qualified names, constructors, operators), or update the weekly GitHub Actions PR workflow that publishes Reports/swiftui-api-gap/gap_report.md.
npx skills add majiayu000/claude-skill-registry --skill swiftui-api-gap --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# SwiftUI API Gap ## Overview Use this skill to keep Raven's SwiftUI parity tracking deterministic, actionable, and automated. Primary implementation files: - `Scripts/swiftui_api_gap_report.py` - `.github/workflows/swiftui-api-gap-report.yml` - `Documentation/SwiftUI-API-Gap-Automation.md` Primary artifact: - `Reports/swiftui-api-gap/gap_report.md` ## Workflow 1. Run report generation. ```bash Scripts/swiftui_api_gap_report.py --repo-root . --output-dir Reports/swiftui-api-gap ``` 2. Validate outputs exist. ```bash ls -lh Reports/swiftui-api-gap ``` 3. Check report quality quickly. - Confirm summary section has counts and coverage. - Confirm named APIs are separate from operator-like overloads. - Confirm constructor coverage is owner-qualified (`Type.init`) and not globally skipped. 4. If asked to improve actionability, prioritize: - Owner-qualified matching for members (`Type.func`, `Type.var`, `Type.init`). - Noise separation for operator-like signatures. - Stable high-signal lists for components/modifiers. - Clear markdown sections that humans can triage. ## Automation Weekly workflow: - `.github/workflows/swiftui-api-gap-report.yml` - Runs Monday via cron. - Uses macOS runner
- Overview
- Workflow
- Automation
- Matching Rules
- Troubleshooting
Scripts/swiftui_api_gap_report.py --repo-root . --output-dir Reports/swiftui-api-gap ls -lh Reports/swiftui-api-gap venv/bin/python -m pip install pyyaml
What does the swiftui-api-gap skill do?
Generate and maintain deterministic SwiftUI-vs-Raven API parity reports and automation. Use when users ask to audit missing SwiftUI components/APIs, refresh coverage reports, reduce report noise, tune matching logic (owner-qualified names, constructors, operators), or update the weekly GitHub Actions PR workflow that publishes Reports/swiftui-api-gap/gap_report.md.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill swiftui-api-gap --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
