apple-productivity

Access macOS productivity apps (Calendar, Contacts, Mail, Messages, Reminders, Voice Memos). Use when user asks about calendar events, contacts, emails, iMessages, reminders, or voice transcription.

16 stars

Best use case

apple-productivity is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Access macOS productivity apps (Calendar, Contacts, Mail, Messages, Reminders, Voice Memos). Use when user asks about calendar events, contacts, emails, iMessages, reminders, or voice transcription.

Teams using apple-productivity should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/apple-productivity/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/fullstack-web/apple-productivity/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/apple-productivity/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How apple-productivity Compares

Feature / Agentapple-productivityStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Access macOS productivity apps (Calendar, Contacts, Mail, Messages, Reminders, Voice Memos). Use when user asks about calendar events, contacts, emails, iMessages, reminders, or voice transcription.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Apple Productivity Apps

Access macOS native productivity apps via helper scripts in ~/bin/.

## Quick Start

| You want to... | Run... |
|----------------|--------|
| Today's calendar | `calendar-events` |
| Find a contact | `contacts-search "name"` |
| Recent messages | `imessage-recent` |
| Unread mail | `mail-unread` |
| Overdue reminders | `reminders-list -o` |
| Transcribe voice memo | `voice-memos process` |

All scripts support `-j` for JSON output.

## Detailed References

- **Calendar**: [reference/calendar.md](reference/calendar.md)
- **Contacts**: [reference/contacts.md](reference/contacts.md)
- **Mail**: [reference/mail.md](reference/mail.md)
- **Messages**: [reference/messages.md](reference/messages.md)
- **Reminders**: [reference/reminders.md](reference/reminders.md)
- **Voice Memos**: [reference/voice-memos.md](reference/voice-memos.md)

## Security

**Read-only (no confirmation needed)**:
- Viewing events, contacts, mail, messages, reminders

**Write operations (ALWAYS confirm first)**:
- `calendar-add` - creating events
- Sending messages/emails
- Modifying reminders

**Rule**: Use `AskUserQuestion` before ANY write operation.

## Common Patterns

### Morning context check
```bash
calendar-events && reminders-list -o && imessage-recent -n
```

### Contact lookup with birthday
```bash
contacts-search -v "Marie"
```

### Historical message search
```bash
imessage-search --pattern "resume"
```

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| Mail.app not running | `mail-unread` requires app | Tell user to open Mail.app |
| Query timeout | Date range too large | Use smaller range |
| No results | Empty dataset | Handle gracefully |

## Related Skills

- `apple-photos` - Photo library access
- `apple-shortcuts` - Run macOS Shortcuts
- `apple-health-fitness` - Health data (under development)

Related Skills

adhd-productivity

16
from diegosouzapw/awesome-omni-skill

ADHD-optimized productivity techniques and interventions. Invoke when user shows signs of task abandonment, context switching, or needs focus assistance.

Apple Foundation Models

16
from diegosouzapw/awesome-omni-skill

Use this skill when working with Apple's Foundation Models framework for on-device AI and LLM capabilities in iOS/macOS apps

apple-tv-troubleshooter

16
from diegosouzapw/awesome-omni-skill

Expert troubleshooting for Apple TV (tvOS) React Native development. Use when users have issues with Siri Remote, focus management, TVEventHandler, TVFocusGuideView, ScrollView not scrolling, tvOS-specific problems, parallax animations, or tvOS vs Android TV differences.

apple-reminders

16
from diegosouzapw/awesome-omni-skill

Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.

apple-health-fitness

16
from diegosouzapw/awesome-omni-skill

Query Health and Fitness data from Apple Health app including activity, workouts, heart rate, sleep, and health metrics. Use when user asks about health stats, fitness activity, workouts, sleep data, or health metrics.

apple-app-store-agent

16
from diegosouzapw/awesome-omni-skill

Comprehensive agent for preparing and generating all assets needed for Apple App Store submission. Use when user needs to prepare an iOS/iPadOS/macOS app for App Store release, including generating app metadata (descriptions, promotional text, keywords), creating app icons, designing screenshots, preparing privacy policy URLs, and organizing fastlane-compatible folder structures. Triggers on requests like "prepare my app for App Store", "create App Store screenshots", "generate app description", "make app icon", or "set up fastlane metadata".

office-productivity

16
from diegosouzapw/awesome-omni-skill

Office productivity workflow covering document creation, spreadsheet automation, presentation generation, and integration with LibreOffice and Microsoft Office formats.

applesauce-core

16
from diegosouzapw/awesome-omni-skill

This skill should be used when working with applesauce-core library for Nostr client development, including event stores, queries, observables, and client utilities. Provides comprehensive knowledge of applesauce patterns for building reactive Nostr applications.

apple-dev-best-practices

16
from diegosouzapw/awesome-omni-skill

Apple platform development best practices for Swift 6, SwiftUI, SwiftData, and iOS/macOS apps. Use when building any iOS or macOS app, writing Swift code, designing SwiftUI views, working with Xcode projects, implementing navigation, state management, concurrency, networking, persistence, or testing on Apple platforms. Triggers on Swift, SwiftUI, iOS, macOS, Xcode, UIKit, SwiftData, Core Data, XCTest, StoreKit, CloudKit, MapKit, HealthKit, or any Apple framework. Also use when reviewing Swift code, debugging iOS apps, migrating UIKit to SwiftUI, or planning Apple platform architecture.

apple-appstore-reviewer

16
from diegosouzapw/awesome-omni-skill

Serves as a reviewer of the codebase with instructions on looking for Apple App Store optimizations or rejection reasons.

apple-ui-design

16
from diegosouzapw/awesome-omni-skill

Apple-inspired clean, minimal, premium UI design. Use when building modern interfaces requiring exceptional UX, clean aesthetics, or Apple-like polish. Triggers on: clean UI, modern design, Apple style, minimal, premium, user-friendly, UX.

apple-hig-designer

16
from diegosouzapw/awesome-omni-skill

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.