abdullah4ai/asc-hitl-interaction
swiftship/internal/skills/data/features/asc-hitl-interaction/SKILL.md
Human-in-the-loop interaction patterns for ASC operations. Use when asking the user for metadata, settings, or confirmations during App Store Connect workflows.
$ install --global
skillsauthnpx skillsauth add abdullah4ai/apple-developer-toolkit asc-hitl-interactionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 30, 2026, 4:35 AM36.8s1 file scanned
SKILL.md
- name:
- asc-hitl-interaction
- description:
- Human-in-the-loop interaction patterns for ASC operations. Use when asking the user for metadata, settings, or confirmations during App Store Connect workflows.
ASC Human-in-the-Loop Interaction
The terminal UI renders your questions with pickers based on the OPTIONS block format. Every question MUST include an OPTIONS block. Follow these patterns for all user-facing questions.
Core Rules
- Ask ONE question at a time — never dump multiple questions in a single message
- Always offer a suggestion — propose a value based on app context so the user can accept or tweak it
- Every question MUST use an OPTIONS block — the terminal renders these as navigable pickers
- If the user responds with "yes", "ok", "sure", "y", or similar — use your suggested value
- If the user responds with "Use your best judgment for this and all remaining fields" — enter auto mode (see below)
- Keep questions concise — one or two sentences max, then the OPTIONS block
Suggestion Fields (description, keywords, copyright, what's new, etc.)
When you have a suggested value, present it as the first option. Always include a text-entry option so the user can type a custom value.
Format:
**Description**: I'd suggest:
> "Your suggested description text here."
[OPTIONS]
- Use this suggestion | Accept the suggested description
- Enter my own | [INPUT] Type a custom value
[/OPTIONS]
Another example:
**Copyright**: I'd suggest: 2026 Mohammed Al-Quraini
[OPTIONS]
- Use this suggestion | Accept the suggested copyright
- Enter my own | [INPUT] Type a custom value
[/OPTIONS]
Rules:
- Show your suggestion ABOVE the OPTIONS block as a quote or inline text
- First option is always "Use this suggestion" (or a short label of the value if it's brief)
- Text-entry options MUST have
[INPUT]at the start of their description — this tells the terminal to show a text input prompt - The UI appends "Let AI decide" and "AI decides all" automatically — do NOT add them
Fixed-Option Fields (category, age rating, content rights, etc.)
When a field has a fixed set of valid values, list all valid values as options.
Format:
What age rating fits your app? This app has no objectionable content.
[OPTIONS]
- 4+ | No objectionable content (recommended)
- 9+ | Mild cartoon or fantasy violence
- 12+ | Infrequent mild language, simulated gambling
- 17+ | Frequent intense violence, mature themes
[/OPTIONS]
Rules:
- Put your recommended choice first
- Keep descriptions under 60 characters
- Include ALL valid values
- The UI appends "Let AI decide" and "AI decides all" automatically — do NOT add them
Fields that MUST list all valid values:
- App category, age rating, content rights, encryption compliance
- Any API field that only accepts specific enum values
- Confirmations (Yes/No/Cancel style)
URL Fields
URLs require the user to provide a value they control. AI cannot generate hosted URLs.
Format:
**Support URL**: A publicly accessible URL is required.
[OPTIONS]
- Enter URL | [INPUT] Type your support page URL
- Use GitHub profile | [INPUT] Enter your GitHub username
[/OPTIONS]
Auto Mode — AI Decides All
When the user selects "AI decides all", auto-fill everything you can WITHOUT asking. But some items are impossible for AI to resolve — you MUST still ask about these:
Always ask (even in auto mode)
- URLs the user must own — Support URL, Privacy Policy URL (AI cannot host pages)
- Screenshots — need actual images; offer upload or simulator capture
- Incomplete agreements — must be accepted in browser (see asc-manual-actions skill)
- Content declarations — content rights, encryption (legal liability on the user)
Auto-fill without asking
- Description, keywords, what's new, promotional text
- Age rating, app category
- Copyright
- Build selection (use latest valid build)
- Version string
When auto-filling, proceed through all auto-fillable fields in one turn (no questions), then stop and ask about the first unresolvable item. After resolving it, continue auto-filling until the next unresolvable item or until done.
Confirmation Before Destructive Actions
Even in auto mode, ALWAYS show a preview and ask for confirmation before submit/publish:
Ready to submit. Proceed?
[OPTIONS]
- Yes, submit | Submit for App Store review
- Review changes | Show the preview again
- Cancel | Stop without submitting
[/OPTIONS]
Related Skills
abdullah4ai/apple-developer-toolkit
tools
VerifiedTrustedCommunity
Apple platform skill for docs, WWDC lookup, App Store Connect work, and SwiftUI app generation. Use repo-local `node cli.js` for Apple docs and WWDC search, `appledev store` for App Store Connect workflows, and `appledev build` for app scaffolding or fix loops on macOS. USE WHEN: Apple APIs, WWDC sessions, TestFlight/App Store tasks, or building/fixing Apple-platform apps. DON'T USE WHEN: non-Apple platforms, generic backend work, or general web research. EDGE CASES: docs-only queries use `node cli.js` in this repo, not `appledev`; release workflows use `appledev store`; app scaffolding uses `appledev build`; rules-only requests can read `references/ios-rules/` or `references/swiftui-guides/` progressively without invoking binaries.
8SKILL.mdUpdated Mar 27, 2026
abdullah4ai/apple-developer-toolkit
tools
VerifiedTrustedCommunity
All-in-one Apple developer skill with three integrated tools shipped as a single unified binary. (1) Documentation search across Apple frameworks, symbols, and 1,267 WWDC sessions from 2014-2025. No credentials needed. (2) App Store Connect CLI with 120+ commands covering builds (find/wait/upload), TestFlight, pre-submission validate, submissions, signing, subscriptions (family-sharable), IAP, analytics, Xcode Cloud, metadata workflows, release pipeline dashboard, insights, win-back offers, promoted purchases, product pages, nominations, accessibility declarations, pre-orders, pricing filters, localizations update, diff, webhooks with local receiver, workflow automation, and more. Requires App Store Connect API key. (3) Multi-platform app builder (iOS/watchOS/tvOS/iPad/macOS/visionOS) that generates complete Swift/SwiftUI apps from natural language with auto-fix, simulator launch, interactive chat mode, and open-in-Xcode. Requires an LLM API key and Xcode. Includes 38 iOS development rules and 12 SwiftUI best practice guides for Liquid Glass, navigation, state management, and modern APIs. All three tools ship as one binary (appledev). USE WHEN: Apple API docs, App Store Connect management, WWDC lookup, or building iOS/watchOS/tvOS/macOS/visionOS apps from scratch. DON'T USE WHEN: non-Apple platforms or general coding.
7SKILL.mdUpdated Mar 27, 2026
abdullah4ai/widgets
testing
VerifiedTrustedCommunity
watchOS complications: WidgetKit complication families, accessory sizes, timeline providers for watch face. Use when implementing watchOS-specific patterns related to widgets.
5SKILL.mdUpdated Mar 27, 2026
abdullah4ai/haptics
development
VerifiedTrustedCommunity
watchOS haptic feedback: WKInterfaceDevice preset haptic types for wrist-based feedback. Use when implementing watchOS-specific patterns related to haptics.
5SKILL.mdUpdated Mar 27, 2026