# Appstore

> Appstore is an Agent Skill for devops & security published in the tw93/MiaoYan repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Prepare and validate a MiaoYan Mac App Store build. Not for GitHub Releases.

- Skill name: `appstore`
- Category: [DevOps & Security](https://www.openparable.com/skill/devops-security/1)
- Source: https://github.com/tw93/MiaoYan/blob/HEAD/.agents/skills/appstore/SKILL.md
- Repository: tw93/MiaoYan (8,434 GitHub stars when collected)

## SKILL.md

# MiaoYan App Store Workflow

Use this skill only when the maintainer explicitly asks for App Store build or submission work.

## App Store vs GitHub Release

| Area | App Store | GitHub Release |
|---|---|---|
| Build intent | App Store distribution | Direct download and update feed |
| Entitlements | App Store entitlements | Developer ID entitlements |
| Sparkle | Not included | Included |
| Credentials | App Store Connect credentials | Developer ID and notarization credentials |

## Build And Validate

```bash
bash scripts/build-appstore.sh
xcrun altool --validate-app -f build/AppStore/Export/MiaoYan.app -t macos --apiKey <KEY_ID> --apiIssuer <ISSUER_ID>
```

Use Xcode Organizer for upload when that is safer than CLI upload.

## Pre-Submission Checklist

- `MARKETING_VERSION` matches the intended release version.
- `CURRENT_PROJECT_VERSION` is incremented when required.
- App Store entitlements are used.
- The App Store configuration builds cleanly.
- Screenshots and metadata are ready in App Store Connect when needed.

## Safety Rules

- Never upload to App Store Connect without explicit maintainer confirmation.
- Never commit App Store Connect API keys, certificates, passwords, or local credential paths.
- Validate before upload.

---

Source: https://www.openparable.com/skill/devops-security/appstore (OpenParable). Cite the canonical URL above.