core-nfc

Read and write NFC tags with NDEF and APDU protocols on iOS.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/DFly7/iOS-FastAPI-Supabase-AI --skill core-nfc-dfly7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: core-nfc
Source: https://github.com/DFly7/iOS-FastAPI-Supabase-AI/tree/main/.agents/skills/core-nfc
Command: npx skills add https://github.com/DFly7/iOS-FastAPI-Supabase-AI --skill core-nfc-dfly7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Integrating NFC into iOS apps is error-prone and requires correct entitlements, Info.plist entries, session lifecycle handling, and support for multiple tag protocols; this Skill consolidates practical patterns and checks to implement reliable NFC read/write workflows.

Core Features & Use Cases

  • NDEF Read & Write: Patterns to scan NDEF tags, parse common payloads (URLs, text, MIME), construct messages, and write safely after checking tag status and capacity.
  • Tag Protocol Support: Direct NFCTag access for ISO7816 APDU exchanges, ISO15693 block reads, FeliCa and MIFARE operations, locking tags, and multi-record messages.
  • Entitlements & Background Reading: Guidance for com.apple.developer.nfc.readersession.formats, NFCReaderUsageDescription, associated domains, and handling background tag launches via NSUserActivity.
  • Robust Session Management: Best practices for availability checks, delegate lifecycle, distinguishing expected invalidations (user cancel / first-read) from real errors, and graceful recovery strategies.

Quick Start

Use the core-nfc skill to read an NFC tag's NDEF records and return a JSON summary of URLs and text payloads.

Frequently Asked Questions about core-nfc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read and write NDEF tags in an iOS app?

NFC tag reading and writing in iOS requires scanning NDEF tags, parsing common payloads like URLs and text, and safely writing constructed messages after verifying tag status and capacity.

What entitlements do I need for NFC tag reading on iPhone?

NFC tag reading on iPhone requires com.apple.developer.nfc.readersession.formats entitlements and NFCReaderUsageDescription entries in Info.plist. You must also configure associated domains for background tag launches via NSUserActivity.

Can I exchange APDU commands with ISO7816 tags using Core NFC?

Yes, Core NFC supports direct NFCTag access for ISO7816 APDU command exchanges, alongside ISO15693 block reads, FeliCa, and MIFARE tag operations.

How does iOS handle background NFC tag reading?

Background NFC tag reading on iOS is handled via NSUserActivity launches. You must configure associated domains and the proper reader session formats entitlement to support detecting and processing tags when the app is not in the foreground.

What is the best way to manage NFCReaderSession lifecycle and errors?

Robust session management involves checking availability, managing the delegate lifecycle, and distinguishing expected invalidations like user cancel or first-read from real errors. This approach ensures graceful recovery strategies during NFC tag workflows.