Update simplify-code/SKILL.md to introduce parallel review sub-agents and reorganize steps. The doc now: recommends determining the smallest diff command, uses repository local instructions to disambiguate patterns, and adds a Step 2 that launches four Codex sub-agents (Reuse, Quality, Efficiency, Clarity) with guidance on prompts, expected outputs, and recommended roles. It also clarifies aggregation of findings, discarding duplicates/conflicts, renumbers subsequent steps (fixing, validation, summary), and tightens wording about applying only high-confidence, behavior-preserving fixes and not staging/committing changes.
Revise the simplify-code skill doc to provide clearer modes (review-only, safe-fixes, fix-and-validate), a preferred scope order, and explicit rules for selecting git diff commands. Replace the previous four-agent launch prescription with a flexible review shape (tiny/medium/large) and guidance for parallel lanes. Add steps to load local repo instructions, normalize findings into a structured format (file/symbol, category, problem, fix, confidence), and tighten rules for applying only high-confidence, behavior-preserving fixes. Also include guidance for scoped validation and a concise outcome summary.
Introduce a new scroll-reveal reference describing how to implement detail surfaces that reveal secondary content via vertical scrolling. Adds references/scroll-reveal.md with intent, core pattern, a minimal SwiftUI example that derives a normalized progress from scroll offset, design guidance (morphing controls, haptics, interaction guards), and pitfalls. Also update components-index.md and SKILL.md to point to the new guidance and to recommend driving visuals from a single scroll-derived progress value rather than parallel gesture state machines.
Hullo @dimillian 👋
I ran your skills through `tessl skill review` at work and found some targeted improvements. Here's the before/after:
| Skill | Before | After | Change |
|-------|--------|-------|--------|
| swiftui-ui-patterns | 81% | 100% | +19% |
| github | 85% | 100% | +15% |
| macos-spm-app-packaging | 86% | 100% | +14% |
| react-component-performance | 86% | 100% | +14% |
| swift-concurrency-expert | 88% | 100% | +12% |
| app-store-changelog | 93% | 100% | +7% |
| ios-debugger-agent | 94% | 100% | +6% |
| swiftui-view-refactor | 93% | 95% | +2% |
| swiftui-liquid-glass | 100% | 100% | — |
| swiftui-performance-audit | 100% | 100% | — |
<details>
<summary>Changes made</summary>
**swiftui-ui-patterns** — Expanded description with additional trigger terms (VStack/HStack, @State, @Binding, navigation hierarchies, custom view modifiers). Added explicit build validation checkpoints and error recovery guidance to the workflow steps.
**github** — Added explicit "Use when..." clause with natural trigger terms (check CI status, create PR, list issues). Added a structured "Debugging a CI Failure" numbered workflow organizing existing commands into a clear investigation sequence.
**macos-spm-app-packaging** — Added a minimum end-to-end example (bootstrap to running app). Added validation checkpoints after packaging, signing, and notarization with specific verification commands (codesign, spctl, stapler). Added a common notarization failures troubleshooting table.
**react-component-performance** — Added three concrete before/after code examples (isolate ticking state, stabilize callbacks with useCallback + memo, derived data with useMemo). Expanded profiling validation with explicit React DevTools Profiler steps.
**swift-concurrency-expert** — Expanded description with concrete actions (adding Sendable conformance, @MainActor annotations, resolving actor isolation warnings). Added verification step to workflow. Added three before/after Swift code examples covering @MainActor, protocol conformance isolation, and @concurrent.
**app-store-changelog** — Added commit-to-bullet transformation examples showing how raw commits map to user-facing App Store bullets, plus examples of internal-only commits that get dropped. Added a complete example "What's New" output block.
**ios-debugger-agent** — Added build failure handling and post-launch verification checkpoints to the core workflow (verify app launched via describe_ui or screenshot before proceeding to UI interaction).
**swiftui-view-refactor** — Tightened prose in sections 3, 3b, and large-view handling. Removed a redundant example. Converted workflow list to clean numbered format.
</details>
Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch - just saw room for improvement and wanted to contribute.
If you want to run reviews, evals and optimizations yourself, just `npm install @tessl/cli` then run `tessl skill review path/to/your/SKILL.md`, and click here (https://tessl.io/registry/skills/submit) to find out more.
Thanks in advance 🙏
Add guidance to SwiftUI skill docs recommending a stable view tree and avoiding top-level conditional branch swapping. Updated swiftui-performance-audit/SKILL.md and swiftui-view-refactor/SKILL.md to include checklist bullets, a new section with examples demonstrating preferred (single base view, localized conditions) vs. avoid patterns, and an updated refactor step order to emphasize stable structure. This reduces root identity churn, unnecessary invalidation, and improves SwiftUI diffing and performance.
Added new reference guides for building macOS Settings windows and customizing menu bar commands in SwiftUI. Updated the components index to include links to these new resources.
Adds guidance on using `.sheet(item:)` over `.sheet(isPresented:)` for model-driven state, and recommends that sheets own their actions and handle dismissal internally. Includes code examples and best practices for sheet usage in SwiftUI.
Introduces a new reference file describing the lightweight, closure-based client pattern for SwiftUI apps. Updates the components index to include a link to this new guidance, supporting easier discovery and usage of small, testable API clients.
Updated documentation to clarify that Sparkle relies on the `CFBundleVersion` (build number) for update checks, and that `BUILD_NUMBER` must be incremented for each release. This helps ensure proper update behavior when using Sparkle.
Introduces new documentation for SwiftUI UI patterns, providing best practices and component guidance, and for macOS SwiftPM app packaging without Xcode, including scaffolding and build scripts. These additions help developers with UI composition in SwiftUI and packaging macOS apps using SwiftPM.
Updated SKILL.md and release.md to include steps for creating a git tag and publishing a GitHub release with the app zip and appcast. This provides clearer guidance for distributing releases via GitHub.
Introduce a set of templates, scripts, and documentation for scaffolding, building, packaging, signing, and notarizing SwiftPM-based macOS apps without Xcode. Includes bootstrap project skeleton, build and packaging scripts, signing/notarization helpers, and reference guides for setup, packaging, and release workflows.
Removed the old 'app-scaffolding-wiring.md' reference and added a new, more comprehensive 'app-wiring.md' guide covering TabView, NavigationStack, sheet routing, and global dependency graph setup. Updated 'components-index.md' to reference the new guide and reflect the expanded focus on dependency management.
Updated SKILL.md to reference project concurrency settings and added a new reference guide for Swift 6.2 approachable concurrency mode. The new guide covers detection, expected behavior changes, recommended fixes, and common pitfalls for projects using main-actor-by-default and default actor isolation.
Introduces recommendations for splitting large SwiftUI view files using private extensions and MARK comments to organize helpers, async functions, and subviews. This helps maintain readability and structure in files exceeding approximately 300 lines.
Added a new reference file detailing best practices for loading states and placeholders in SwiftUI, including usage of redacted placeholders and ContentUnavailableView. Updated the components index to include a link to the new loading & placeholders documentation.
Added a new reference file for title menus, including usage patterns, examples, and design guidance. Updated the components index to include a link to the new title menus reference.
Introduces the 'swiftui-ui-patterns' skill to docs/skills.json, providing best practices and example-driven guidance for building SwiftUI views and components. Adds SKILL.md and a comprehensive set of reference files covering TabView, NavigationStack, sheets, forms, controls, grids, overlays, haptics, focus handling, media, matched transitions, split views, and more.
Replaces hardcoded skills in docs/app.js with dynamic loading from a generated docs/skills.json. Adds scripts/build_docs_index.py to generate the index from SKILL.md files, and a pre-commit hook to keep the index in sync. Updates README with setup instructions for the pre-commit hook.
Introduced a new section describing the GH Issue Fix Flow, outlining its purpose, key features, and usage for resolving GitHub issues using the `gh` CLI, local edits, builds/tests, and git push.
Introduces SKILL.md outlining the end-to-end process for resolving GitHub issues using gh, local code changes, XcodeBuildMCP, and git. The guide covers intake, code location, implementation, build/test, commit/push, and reporting steps.
Added detailed recommendations and examples for splitting large SwiftUI view bodies and computed view properties into subviews or dedicated View types. Clarified when to extract subviews and how to structure them for maintainability and reuse. Adjusted section numbering to accommodate the new content.
Introduced a theme toggle button in the docs header, allowing users to switch between light and dark modes. Theme preference is saved in localStorage and applied on load. Updated CSS to support theme variables and improved code block styling for both themes.
Introduces a new documentation site under the docs/ directory, including index.html, app.js, and styles.css. The site lists and describes iOS Codex skills, provides navigation, and displays markdown-based instructions and references for each skill. Also adds a .DS_Store file.
Introduces a new section describing the SwiftUI Performance Audit feature, outlining its purpose, key features, and usage scenarios to help users diagnose and improve SwiftUI runtime performance.
Introduced SKILL.md with a comprehensive workflow for auditing and improving SwiftUI runtime performance, including code review, profiling, diagnosis, and remediation steps. Added summarized Apple and WWDC resources under the references directory to support performance analysis and best practices.
Added a new reference file summarizing SwiftUI-specific concurrency guidance from WWDC, covering actor isolation, Sendable closures, and async work structuring. Updated SKILL.md to include a link to this new reference for easier access to SwiftUI concurrency best practices.
