Superlego

A collection of AI coding assistant skills for Swift, SwiftUI, iOS/macOS development, and development workflows.

Installation

Claude Code (Recommended)

Add the marketplace and install plugins:

# Add the superlego marketplace
/plugin marketplace add robinsalehjan/superlego

# Install the skills collection
/plugin install skills@superlego

# Optionally install safety-hooks for additional protection
/plugin install safety-hooks@superlego

# Restart Claude Code

Alternative: Direct GitHub Installation

Install the main skills plugin directly:

/plugin install robinsalehjan/superlego

Note: Direct installation only includes the skills plugin. To get safety-hooks as a separate plugin, use the marketplace method above.

Local Development

For local development or testing:

# Add as a local marketplace
/plugin marketplace add /path/to/superlego

# Install plugins
/plugin install skills@superlego
/plugin install safety-hooks@superlego

Verify Installation

Check that skills are available:

/help

Or ask Claude to list available skills.

Available Skills

Swift & SwiftUI Development

Skill	Description
swiftui-ui-patterns	Best practices and example-driven guidance for building SwiftUI views and components. Tab architecture, navigation, sheets, lists, and more.
swiftui-performance-audit	Performance analysis and optimization for SwiftUI. Profiling with Instruments, identity optimization, lazy loading patterns.
swiftui-view-refactor	SwiftUI view refactoring using MV patterns. State management, view composition, dependency injection.
swiftui-liquid-glass	WWDC25 Liquid Glass design patterns for visionOS and iOS. Glassmorphism, depth effects, spatial UI.
swift-concurrency-expert	Swift 6.2+ concurrency review and remediation. Actor isolation, Sendable safety, data-race fixes.

Development Workflows

Skill	Description
devdocs	Session continuity for AI-assisted development. Persist working state across sessions to prevent context loss. Integrates with superpowers plugin.
gh-issue-fix-flow	End-to-end GitHub issue fix workflow. Issue intake, code changes, builds/tests, commit with closing message, and push.
ios-debugger-agent	iOS debugging workflow with LLDB and Instruments. Crash investigation, memory debugging, performance profiling.
macos-spm-app-packaging	macOS app packaging with Swift Package Manager. Notarization, code signing, DMG creation, release workflow.
app-store-changelog	App Store release notes generation. Parse git history, categorize changes, format for App Store Connect.

Safety & Protection

Skill	Description
safety-hooks	Pre-tool-use safety hooks. Protect against dangerous bash commands, sensitive file access, and git branch protection.

Usage

Skills are automatically available when the plugin is installed. Claude will detect relevant skills based on your task and offer to use them.

Explicitly Request a Skill

Use the swiftui-ui-patterns skill to help me build a tab-based navigation

Browse Skill References

Each skill includes reference documents with detailed patterns and examples:

Read the references in the swiftui-ui-patterns skill directory

Skill Structure

Each skill contains:

SKILL.md - Main skill definition with workflow and guidance
references/ - Supporting documentation and patterns
scripts/ - (Optional) Automation scripts for the skill

Philosophy

Convention over configuration - Follow Swift/SwiftUI community best practices
Modern patterns first - Swift 6.2+, iOS 18+, latest SwiftUI APIs
Example-driven - Learn from real patterns, not abstract descriptions
Session continuity - Persist state to prevent context loss

Contributing

Fork the repository
Create a new skill following the SKILL.md format
Add references/ with supporting documentation
Submit a PR

Skill Template

---
name: my-skill
description: Brief description. Use when [trigger condition].
---

# My Skill

## Overview

What this skill does.

## Workflow

### 1. First step
...

### 2. Second step
...

Updating

Update installed plugins from the marketplace:

# Update individual plugins
/plugin update skills@superlego
/plugin update safety-hooks@superlego

# Or update the marketplace to get latest versions
/plugin marketplace update superlego

License

MIT License - see LICENSE file for details.

Support

Issues: https://github.com/rsj/superlego/issues

using-superlego