UAE PASS Integration — Agent Skill

An Agent Skill that teaches AI coding agents (Claude Code, Codex, Cursor, OpenCode, and others) how to integrate UAE PASS — the UAE's national digital identity (OAuth 2.0 / OpenID Connect) — into your application.

It's web-first but multi-platform, and built for progressive disclosure: the agent reads a lean SKILL.md, then loads only the reference for the platform/feature you're actually working on — so a web task never drags iOS, Android, or signing material into context.

Unofficial / community project. Not affiliated with, endorsed by, or supported by UAE PASS, TDRA, or the UAE Government. It consolidates the public documentation at docs.uaepass.ae (plus the official sample apps and community plugins) into an agent-readable form. Always verify against the official docs before going live.

What's covered

Area	Platforms / topics
Authentication	Web (browser OAuth2), iOS, Android, Flutter, React Native
Platform-agnostic	Endpoints & environments, onboarding & credentials, scopes & user attributes, troubleshooting, the official login button, SP use-case rules
Features	Digital signature (PDF), eSeal, data sharing, facial-biometric confirmation
Runnable sample	A ~200-line Node.js + Express web login app (staging sandbox)

Install

This repo follows the standard skill layout (skills/<name>/SKILL.md), so it works with the common tools:

npx skills (vercel-labs/skills)

# Preview what's in the repo
npx skills add MalikZu/uaepass-skill --list

# Install into Claude Code (project-level)
npx skills add MalikZu/uaepass-skill --skill uaepass --agent claude-code

# Install globally (user-level), for any supported agent
npx skills add MalikZu/uaepass-skill --skill uaepass -g

# Remove it
npx skills remove uaepass

The CLI supports Claude Code, Codex, Cursor, OpenCode, and 70+ other agents (--agent/-a).

Claude Code plugin marketplace

/plugin marketplace add MalikZu/uaepass-skill
/plugin install uaepass@uaepass-skill

Manual

Copy the skill folder into your agent's skills directory:

# Project-level (Claude Code)
cp -r skills/uaepass /path/to/your/project/.claude/skills/uaepass
# or global
cp -r skills/uaepass ~/.claude/skills/uaepass

Then start your agent and ask it to "sign in with UAE PASS" / "integrate UAE PASS" — the skill triggers from its description.

How it's organised

skills/uaepass/
├── SKILL.md                      # lean hub: pick a platform → load only that reference
├── references/
│   ├── web-authentication.md     # ← Web (default)
│   ├── ios-integration.md        # ← iOS        (loaded only for iOS work)
│   ├── android-integration.md    # ← Android
│   ├── flutter-integration.md    # ← Flutter
│   ├── react-native-integration.md  # ← React Native
│   ├── endpoints-and-environments.md, onboarding-and-credentials.md,
│   │   scopes-and-user-attributes.md, troubleshooting-and-faq.md,
│   │   login-button-and-design.md, use-cases-and-guidelines.md   # platform-agnostic
│   ├── web-registration.md, token-validation.md, user-linking.md # web extras
│   └── digital-signature.md, eseal.md, data-sharing.md,
│       facial-biometric.md        # features (load only when asked)
└── assets/
    └── node-web-login-sample/    # runnable Node.js + Express web login

The SKILL.md body stays small; the heavy detail lives in references/ and is pulled in on demand. That's what keeps mobile/signing/etc. out of context during a web task (and vice-versa).

Try the web sample

cd skills/uaepass/assets/node-web-login-sample
cp .env.example .env       # defaults to staging + the public sandbox_stage creds
npm install && npm start   # → http://localhost:3000

A real login needs a staging UAE PASS account and the staging UAE PASS mobile app — see skills/uaepass/references/onboarding-and-credentials.md.

Sources & accuracy

Consolidated from the live official docs at docs.uaepass.ae (authoritative idshub endpoints), cross-checked against the 2020 SDG integration PDFs and the official iOS/Android sample apps. Flutter and React Native document community (unofficial) plugins plus the raw flow.

The synced baseline (docs version, page hashes, last-sync date) is tracked in docs-sync.json. A scheduled GitHub Action (.github/workflows/docs-watch.yml) re-checks docs.uaepass.ae every ~3 days and, if it changed, has Claude Code open a PR updating the references — and pings a reminder issue if the baseline goes stale (>3 months). To refresh manually, see MAINTAINING.md.

Contributing & license

Contributions welcome — see CONTRIBUTING.md. Licensed under the MIT License. "UAE PASS" and related marks belong to their respective owners.