claudeers.
// Claude Skills

duology

Claude Code skills for designing, building, testing and shipping apps on iPhone Duo and iOS 27. Layout patterns, app recipes, a fold linter and pose checks.

// Claude Skills[ cli ][ api ][ web ][ mobile ][ claude ]#claude#agent-skills#claude-code#claude-code-plugin#claude-skills#foldable#ios#ios27#skills◷ MIT$open-sourceupdated 29 days ago
Actively maintained
100/100
last commit 16 days ago
last release 21 days ago
releases 4
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up duology (claude-plugin project) into my current project.
Found on https://claudeers.com/duology
Repo: https://github.com/Kimeur/duology
Homepage/docs: —
Detected install method: claude-plugin → /plugin install duology@Kimeur/duology
Category: skills. Platforms: cli, api, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add Kimeur/duology
/plugin install duology@Kimeur/duology
// or clone
git clone https://github.com/Kimeur/duology

// compatibility

Platformscli, api, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageSwift

Get your FREE $2.50 API credits to access TickAtlas financial data ↗
Duology: design, build, test and ship apps for iPhone Duo with Claude Code

Duology

Claude Code skills for designing, building, testing and shipping apps on iPhone Duo.

Your agent learned iOS before the iPhone Duo existed. Duology teaches it the rest.

Quick start · What's inside · Patterns · Recipes · Proof · FAQ · Roadmap

/plugin marketplace add Kimeur/duology

[!IMPORTANT] v0.3 is out (21 October 2026): 30 skills in 5 plugins, with a new plugin of iOS 27 features (duology-features) and five app recipes, plus /duo-doctor, /duo-new, /duo-audit, /duo-poses, /duo-review and a design review agent, checked on Xcode 27.1 and the iPhone Duo simulator. Checks on a real iPhone Duo and published test results come next. Duology is built in the open: the full pack of 36 skills is planned for v1.0 in January 2027. Star or watch the repo to follow along. See the roadmap and the release notes.

[!NOTE] Duology is a community project. It is not affiliated with, endorsed by or sponsored by Apple Inc. iPhone is a trademark of Apple Inc. Every API claim links to Apple's own documentation in reference/sources.md.


Demo: Claude Code runs duo-lint on an app built before iPhone Duo, fixes the four findings until duo-lint reports zero, then the gallery app is shown closed, open, half folded like a book and propped up in tabletop on the iPhone Duo simulator
25-second demo, silent. Watch the MP4. Lint output and screenshots are real.


The problem

iPhone Duo is in stores from 23 October 2026. It has a 5.4″ outer display, a 7.6″ inner display and a fold. Coding agents were trained before it existed, so when you ask one to "make this work on Duo" it writes code Apple tells you not to write:

  • it measures UIScreen.main.bounds, which is ambiguous on a phone with two displays;
  • it branches on device orientation or userInterfaceIdiom and treats "regular width" as "iPad";
  • it puts buttons and text where the phone folds;
  • it rebuilds the screen when you unfold, so you lose your scroll position, your typing or your video;
  • it designs one screen and stretches it, instead of a layout for each way people hold the phone.

Apple published the rules in six Tech Talks, a HIG page and the iOS 27.1 SDK. Duology turns them, plus what we learned shipping a real Duo app, into skills Claude Code loads when it needs them.

How Duology fixes it

  1. It knows the device. Size classes, reserved regions, ArrangementView, vertical bars and the hinge. Each fact is checked against the iOS 27.1 SDK. Scenes and windows have their own skill (v0.2), and so do the cameras (duo-camera, v0.3).
  2. It designs, not just compiles. Eight named layout patterns, state that survives fold and unfold, and two people on one screen, each with SwiftUI code. v0.2 adds design tokens, guidance for each pose, fold transitions, thumb reach and accessibility on both displays.
  3. It builds whole apps. A recipe creates a project that builds and runs on the iPhone Duo simulator. Five are ready: a two-player game, a finance dashboard, a media player, a reader and a shop. Three more are planned.
  4. It checks its own work. duo-lint finds code Apple warns against. /duo-audit adds a 15-point design checklist on screenshots from the simulator. /duo-poses (v0.2) screenshots your app closed, open, in book pose and in tabletop, and /duo-review hands those frames to a design review agent.
You ask Claude Code, Duology guides the code, Xcode 27.1 builds it for the iPhone Duo simulator, duo-lint, the 15-point design review and screenshots of four poses (v0.2) check it, then you ship. An App Store checklist (v1.0) is planned

Quick start

Claude Code · plugin marketplace

You need: a Mac with Apple silicon, Xcode 27.1 (27A9275 or later) and Claude Code.

/plugin marketplace add Kimeur/duology
/plugin install duology@duology

Add the other plugins when you need them:

/plugin install duology-design@duology
/plugin install duology-recipes@duology
/plugin install duology-ship@duology
/plugin install duology-features@duology

duology-recipes and duology-ship need duology, which gives them /duo-doctor. duology-design and duology-features install on their own, but their skills point to duology's skills (duo-layout, duo-continuity, duo-scenes), so install duology first. duology-features adds the iOS 27 features: Foundation Models, App Intents, the camera, media, reading, games, the iOS 27 SwiftUI changes, and widgets, Live Activities and Controls.

Restart Claude Code, then check your setup:

/duo-doctor

It checks macOS, Xcode 27.1, the iOS 27.1 simulator runtime, an iPhone Duo simulator, Xcode's agent bridge (xcrun mcpbridge) and Python for duo-lint. It tells you how to fix anything that fails, and it changes nothing on its own.

Cursor, Codex, Copilot, Gemini CLI and others · skills only
npx skills add Kimeur/duology

The CLI finds your agent and puts the skills where it looks. You get every skill. Slash commands and the lint hook are Claude Code features, so on other agents ask for them in plain words ("run the Duo audit"). AGENTS.md lists the script behind each command.

One skill only:

npx skills add Kimeur/duology --skill duo-layout

Each skill works on its own: links that point outside its folder go to this repo on GitHub.

Manual

Each skill is a folder with a SKILL.md. Copy the ones you want into .claude/skills/ (project) or ~/.claude/skills/ (everyone on this Mac).

Ask Claude

Make my app work well on iPhone Duo. Start with an audit, fix what it finds,
then run it on the Duo simulator.
/duo-new recipe-two-player-game TapDuel
A reaction game: each player taps their own targets, first to ten wins.
Review these Figma frames for iPhone Duo and tell me what breaks when the phone is half folded.

What's inside

v0.3: 30 skills in 5 plugins, 5 commands and 1 review agent. The full pack plans 36 skills in 5 plugins, 6 commands and 2 review agents. Rows marked planned aren't built yet; the roadmap says when they land. Claude loads a skill only when the task needs it, so the pack costs almost nothing while it sits unused.

duology · foundation: setup, layout, continuity, scenes
SkillStatusUse it when
duo-startv0.1You're not sure where to begin. Works out SwiftUI or UIKit, new or existing app, and picks the right skills.
duo-setupv0.1Setting up Xcode 27.1 next to an older Xcode, Device Hub, Xcode's agent connection, Swift 6 project settings.
duo-layoutv0.1Content lands in the fold. Size classes, uneven safe areas, reserved regions, ArrangementView and when to use your own split instead.
duo-navigationv0.1Toolbars and tab bars. Vertical bars, tabs that become a sidebar, NavigationSplitView, sheets, overflow.
duo-continuityv0.1Something resets when you fold. Scroll, playback, typed text, selection and navigation survive fold, unfold, rotate and resize.
duo-scenesv0.2Several windows, Split View, and showing something on the outer display while the inner one is in use.
duology-design · design and interaction
SkillStatusUse it when
duo-design-systemv0.2Setting up spacing, grids (even column counts), type for both displays, Liquid Glass, corners, colour and contrast, touch targets.
duo-patternsv0.1Choosing a layout. List-detail, supporting pane, two-page, dual view, extended canvas, feed reflow, tabs to sidebar, displacement.
duo-posturesv0.2Designing for closed, open, book, tabletop, standing and flipped. The hinge as an effect, used sparingly.
duo-transitionsv0.2The move from closed to open should feel like one app, not a reload.
duo-ergonomicsv0.2Two-handed grip, thumb reach, controls on the side edge.
duo-shared-screenv0.1Two people use one phone: games, teaching, showing something to a customer.
duo-accessibilityv0.2VoiceOver order across panes, Dynamic Type on both displays, Reduce Motion, hardware keyboard.
duo-design-reviewv0.1Reviewing screenshots or Figma frames against the 15-point Duo checklist.
duology-features · iOS 27 features on two displays
SkillStatusUse it when
duo-intelligencev0.3Adding Foundation Models: an AI pane when open, a short summary when closed.
duo-app-intentsv0.3Siri, app actions and onscreen awareness with App Intents.
duo-camerav0.3Capture apps. Each camera by the way it faces, the virtual front camera, a preview on the outer display.
duo-mediav0.3Video and audio. Tabletop player, Picture in Picture, "up next".
duo-readingv0.3Books and documents. Two pages in book pose, notes beside the text.
duo-gamesv0.3Games. Fill the screen in every pose, keep touch controls off the fold.
duo-swiftui-27v0.3The iOS 27 SwiftUI changes that matter on Duo: reordering, swipe actions on any view, the @State macro, new toolbar APIs.
duo-system-surfacesv0.3Widgets, Live Activities, StandBy and Controls on either display.
duology-recipes · app recipes

See App recipes.

duology-ship · testing and App Store
SkillStatusUse it when
duo-testingv0.1Writing tests that hold up on the Duo simulator: logic tested on the Mac, launch switches, UI tests that really reach SwiftUI gestures.
duo-pose-matrixv0.2Screenshots of your app closed, open, in book pose and in tabletop, by pressing Device Hub's pose buttons (with your Accessibility permission) or with poses you set by hand.
duo-lintv0.1Finding code Apple warns against before it ships.
duo-performanceplanned (v1.0)Resizing smoothly at 120 Hz when the phone opens.
duo-app-storeplanned (v1.0)Duo screenshots (required from April 2027), metadata, App Review notes, privacy manifest.
duo-migrateplanned (v1.0)Bringing an existing app over: which SDK you build with changes how it looks on Duo.

Commands and agents

CommandStatusWhat it does
/duo-doctorv0.1Checks the Mac: Xcode 27.1, the iOS 27.1 runtime, an iPhone Duo simulator, Xcode's agent bridge and Python.
/duo-new <recipe> <AppName>v0.1Creates a new app from a recipe, tests its rules on the Mac, builds it and runs it on the Duo simulator.
/duo-auditv0.1Runs duo-lint and the 15-point checklist on your app and lists what to fix, most serious first.
/duo-posesv0.2Runs your app closed, open, in book pose and in tabletop, saves a screenshot of each, and puts the simulator back.
/duo-reviewv0.2Design critique of screenshots or Figma frames by the duo-design-reviewer agent. Reads only.
/duo-shipplanned (v1.0)App Store checklist for Duo: screenshots, metadata, review notes.
AgentStatusWhat it does
duo-design-reviewerv0.2Reviews a screen the way a Duo design lead would, with the rule behind each comment.
duo-pose-testerplanned (v1.0)Runs the pose check and reports each failure with its screenshot.
duo-lint · example report

Real output on a four-file sample, tests/fixtures/sample in the skill, run from that folder:

$ duo-lint Sources/
Sources/App/RootView.swift:7           DUO004  warning  userInterfaceIdiom == .pad  layout picked by device type; pick it by size class or space
Sources/Feed/FeedView.swift:8          DUO001  error    UIScreen.main.bounds        your window is not the screen on a two-display phone; size from the view or window
Sources/Player/Controls.swift:9        DUO007  warning  frame(width: 390)           fixed width of 320 pt or more; let the container size it
Sources/Settings/SettingsView.swift:6  DUO009  warning  <= 667                      GeometryReader size compared to a device size; use size class or ViewThatFits
4 findings · 1 error · 3 warnings (4 files checked)

Each line gives the place, the rule, the severity, the code and what's wrong. An error is an API the SDK already deprecates; a warning is a pattern that is almost always wrong on iPhone Duo. Add -v to print the fix and the Apple source under each finding. It has nine rules (DUO001 to DUO009) and prints text, JSON or GitHub annotations.

With duology-ship installed, Claude Code runs it as duo-lint. If you installed the skill on its own, run <skill-folder>/scripts/duo-lint . from your app's folder. <skill-folder> is the folder that holds the skill's SKILL.md. Turn on the optional hook (export DUOLOGY_LINT_HOOK=1 before you start Claude Code) and Claude sees these findings right after it edits a Swift file. The hook never blocks an edit.

Layout patterns


The gallery app's two-page screen on the iPhone Duo simulator: one page on the closed 5.4-inch outer display, two facing pages on the open 7.6-inch inner display
Real screenshots of the gallery app on the iPhone Duo simulator (iOS 27.1), drawn at the same scale.

Every pattern in duo-patterns comes with a SwiftUI recipe and a screen in the gallery app (samples/DuologyGallery).

PatternClosedOpenGood for
List-detaillist, then detailboth side by sidemail, messages, settings
Supporting panemain content, pane in a sheetmain content with a narrower panecomments, tools, "up next"
Two-pageone pagetwo pages, one per sidebooks, documents, slides
Dual viewone view, togglethe same data two wayslist and map, text and preview
Extended canvascanvasthe canvas spans the fold, tools stay clear of itmaps, drawing, big tables
Feed reflow1 or 2 columnsan even number of columnsphotos, shops, news
Tabs to sidebartab bar on the sidesidebarapps with many sections
Displacementn/acontrols move off the fold, scrolling content stays putany screen with controls near the middle

The gallery app on the iPhone Duo simulator (iOS 27.1): closed on the outer display, open on the inner display. The gallery README also shows each screen in book and tabletop poses.

PatternClosedOpen
List-detailInbox list on the closed phone, with Close and filter buttons in the vertical barOpen: inbox list on the left, a message on the right, message actions in the vertical bar
Supporting paneArticle on the closed phone, with Discussion and Share in the vertical barOpen: the article with the discussion pane beside it
Two-pageTitle page of the book on the closed phone, with page buttons at the bottom of the vertical barOpen: the title page and January as facing pages, the gap on the fold line
Dual viewPlaces list on the closed phone with the List and Map switchOpen: the list of places on the left, the map of Lisbon on the right
Extended canvasTrail map on the closed phone with the tool palette at the bottomOpen: the trail map across the whole display, the palette bottom centre
Feed reflowShop grid in two columns on the closed phoneOpen: the shop grid in four columns
Tabs to sidebarListen Now on the closed phone with eight tabs in a vertical tab barOpen: a sidebar with a Library section next to Listen Now
DisplacementVoice memo list on the closed phone with the record controls at the bottomOpen: voice memos with the record group bottom centre

v0.2 adds three screens, one for each of duo-postures, duo-transitions and duo-design-system. The last column shows the pose each one is about.

ScreenClosedOpenFolded
Tabletop playerClosed: the kelp forest film above the player controls, with a subtitleOpen: the film across the display, the controls floating over its bottom edgeTabletop: the film above the fold, the same controls below it
Fold transitionClosed: the rock-pooling guide at The middle shore, one paragraph highlighted and the next selected, reading tools at the bottomOpen: contents on the left of the fold, the same section and selection on the rightBook pose: the same split as open; nothing moved
Design tokensClosed: the energy dashboard on a four-column grid with the margin and touch target overlaysOpen: eight columns, four on each side, with a 16 pt gutter on the dashed fold lineBook pose: the fold as the middle gutter, four columns on each side

App recipes

/duo-new <recipe> <AppName> creates the project, tests its rules on the Mac, builds it and opens it on the iPhone Duo simulator. 5 recipes are ready; the others are planned.

RecipeStatusWhat you get
recipe-two-player-gamev0.1Each player gets half the screen in every pose, with the game logic tested on the Mac.
recipe-finance-dashboardv0.3Balance when closed; balance, charts and transactions when open.
recipe-media-playerv0.3Player that moves to tabletop on its own, with "up next" and Picture in Picture.
recipe-readerv0.3Two pages in book pose, and it remembers where you were.
recipe-shopv0.3Product shelf beside product details, with a two-pane paywall.
recipe-notes-aiplanned (v1.0)Notes list and editor, with an AI summary pane on the inner display.
recipe-camera-studioplanned (v1.0)The person you film sees themselves on the outer display.
recipe-kids-learningplanned (v1.0)A parent check, a privacy manifest, and nothing tracked.

The finance dashboard recipe, closed pose, on the iPhone Duo simulator The finance dashboard recipe, open pose, on the iPhone Duo simulator
The finance dashboard recipe on the iPhone Duo simulator

The media player recipe, closed pose, on the iPhone Duo simulator The media player recipe, tabletop pose, on the iPhone Duo simulator
The media player recipe on the iPhone Duo simulator

The reader recipe, book pose, on the iPhone Duo simulator The reader recipe, tabletop pose, on the iPhone Duo simulator
The reader recipe on the iPhone Duo simulator

The shop recipe, closed pose, on the iPhone Duo simulator The shop recipe, open pose, on the iPhone Duo simulator
The shop recipe on the iPhone Duo simulator

Proof, not promises

Every skill has test tasks in evals/, 41 so far (40 ready to run). Each task runs with Claude Code twice, with and without Duology, in a fresh copy of the same sample project. A run passes when the app builds for the iPhone Duo simulator, duo-lint finds nothing, every check in the task passes and every checklist rule it covers passes.

No results yet. The first published runs are planned before v1.0, and we'll publish them here whatever they show.

TaskWithout DuologyWith Duology
Make an existing list app work on Duopendingpending
Keep video playing through fold and unfoldpendingpending
Build a two-player game on one phonependingpending
Tabletop layout for a video callpendingpending

How the runs work and how to rerun them: evals/README.md.

Verified on

Status
Xcode 27.1 (27A9275)Checked
iPhone Duo simulator, iOS 27.1Checked
iPhone Duo devicePlanned before v1.0
iOS 27.2 betaNot tracked until release

Each SKILL.md repeats this in its front matter, so you can see how far every rule has been tested.

FAQ

How is this different from other iPhone Duo skill repos?

Other repos explain the Duo APIs well, and mirzaaghazadeh/iphone-duo-skills also covers Flutter, React Native and Capacitor. Duology aims to go from design to the App Store for native SwiftUI and UIKit apps. v0.1 has layout patterns, a recipe, a linter, an audit command and a test harness. v0.2 adds design skills, a scenes skill, the pose screenshots (/duo-poses) and a design review agent. v0.3 adds eight iOS 27 feature skills and four more recipes. The App Store skill and published test results come later.

Xcode 27 already ships agent skills. Why add more?

Apple's skills (export them with xcrun agent skills export) cover SwiftUI in general and making apps resizable. Duology points to them and doesn't copy them. It adds what they don't cover: design for each pose, two-person use, recipes and verification.

Do I need an iPhone Duo?

No. Everything runs on the iPhone Duo simulator in Xcode 27.1. A few things only show on real hardware (how the hinge feels, camera handoff, 120 Hz transitions); those skills say so.

Does it work with UIKit?

Yes. duo-layout, duo-navigation, duo-continuity and duo-shared-screen give SwiftUI and UIKit versions, and so do the v0.2 skills (duo-scenes, duo-design-system, duo-postures, duo-transitions, duo-ergonomics, duo-accessibility). duo-patterns builds in SwiftUI and maps each pattern to its UIKit counterpart. The recipes are SwiftUI apps.

Does Duology send any data anywhere?

No. Skills are text files, and duo-lint, duo-doctor and the duo-pose-matrix tools run on your Mac.

Documentation

  • Roadmap: what's planned and when.
  • Changelog: what changed in each release.
  • AGENTS.md: using Duology from Codex, Cursor, Copilot, Gemini CLI and other agents.
  • Gallery app: how to run it and what each screen shows.
  • Evals: how the test runs work.
  • Device facts: displays, cameras, poses, size classes.
  • API index: every Duo API with its Apple doc link.
  • Sources: the Apple pages and talks behind each rule.
  • Contributing: how to add a skill, a pattern or a recipe.
  • Security: how to report a security problem.

Star history

Duology GitHub star history

Contributing

Pull requests are welcome, especially new patterns, recipes and test tasks. Each change needs:

  • a link to the Apple doc or talk behind any API claim;
  • a test task in evals/ for any new skill;
  • a verified: line saying where you tested it.

Read CONTRIBUTING.md before you start. Found a wrong API claim? Open an issue with the Apple link.

Acknowledgements

Built on Apple's iPhone Duo Tech Talks and Human Interface Guidelines, and on design ideas from Microsoft's Surface Duo patterns, Android's adaptive layouts and Samsung's Flex mode. Thanks to the Swift agent-skills community: twostraws, AvdLee, Dimillian and mirzaaghazadeh.

License

MIT. Apple documentation is linked, never copied. Apple, iPhone and Xcode are trademarks of Apple Inc.

// faq

What is duology?

Claude Code skills for designing, building, testing and shipping apps on iPhone Duo and iOS 27. Layout patterns, app recipes, a fold linter and pose checks.. It is open-source on GitHub.

Is duology free to use?

duology is open-source under the MIT license, so it is free to use.

What category does duology belong to?

duology is listed under skills in the Claudeers registry of Claude-compatible tools.

16 views
★ 40 stars
unclaimed
updated 29 days ago

// embed badge

duology on Claudeers
[![Claudeers](https://claudeers.com/api/badge/duology.svg)](https://claudeers.com/duology)

// retro hit counter

duology hit counter
[![Hits](https://claudeers.com/api/counter/duology.svg)](https://claudeers.com/duology)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how duology connects across the ecosystem