{"id":50440642,"url":"https://github.com/ciscoriordan/storescreens-skill","last_synced_at":"2026-05-31T19:01:20.533Z","repository":{"id":351428910,"uuid":"1210938524","full_name":"ciscoriordan/storescreens-skill","owner":"ciscoriordan","description":"Agent skill that sets up and runs storescreens-cli for App Store screenshot automation. Works with any AI coding assistant that supports skills.","archived":false,"fork":false,"pushed_at":"2026-05-23T23:19:49.000Z","size":2329,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T23:23:37.506Z","etag":null,"topics":["agent-skill","app-store","ios","macos","mcp","screenshots","xcode"],"latest_commit_sha":null,"homepage":"https://storescreens.app","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ciscoriordan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-14T23:02:58.000Z","updated_at":"2026-05-23T22:44:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ciscoriordan/storescreens-skill","commit_stats":null,"previous_names":["ciscoriordan/storescreens-skill"],"tags_count":59,"template":false,"template_full_name":null,"purl":"pkg:github/ciscoriordan/storescreens-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ciscoriordan%2Fstorescreens-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ciscoriordan%2Fstorescreens-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ciscoriordan%2Fstorescreens-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ciscoriordan%2Fstorescreens-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ciscoriordan","download_url":"https://codeload.github.com/ciscoriordan/storescreens-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ciscoriordan%2Fstorescreens-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33744447,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skill","app-store","ios","macos","mcp","screenshots","xcode"],"created_at":"2026-05-31T19:01:19.827Z","updated_at":"2026-05-31T19:01:20.513Z","avatar_url":"https://github.com/ciscoriordan.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"![StoreScreens](assets/banner.png)\n\n# storescreens-skill\n\nAgent skill for [storescreens-cli](https://github.com/ciscoriordan/storescreens-cli), the CLI that captures App Store screenshots across every required device size, renders them into captioned, framed App Store-ready images, and uploads them (with per-locale metadata) straight to App Store Connect, in one command.\n\nThis skill lets an AI coding assistant handle the entire pipeline: installing the CLI, detecting your Xcode project, configuring devices, generating UI tests, running captures, installing device bezels, writing a `render:` config that produces captioned/framed App Store Connect-ready screenshots, configuring the App Store Connect API, and pushing screenshots + per-locale metadata (name, subtitle, description, keywords, what's new, promotional text) to App Store Connect for the next release. It also supports **targeted screenshots** for quick visual checks during development, capturing the current simulator screen in under a second without building or running tests.\n\n## Prerequisites\n\nThe skill installs [storescreens-cli](https://github.com/ciscoriordan/storescreens-cli) via Homebrew automatically if it's not already on your machine. You need **macOS 14+** and **Xcode 16+**.\n\n## Install\n\n### One-liner via [skills.sh](https://skills.sh)\n\nThe easiest way. The [`skills`](https://github.com/vercel-labs/skills) CLI from Vercel Labs will detect this repo's `SKILL.md` and install it into the right location for your assistant (Claude Code, Cursor, or any other supported tool):\n\n```bash\nnpx skills add ciscoriordan/storescreens-skill\n```\n\nUpdate later with:\n\n```bash\nnpx skills update ciscoriordan/storescreens-skill\n```\n\n### Claude Code (manual)\n\nClone the skill into your user-level skills directory to make it available in every project:\n\n```bash\ngit clone https://github.com/ciscoriordan/storescreens-skill.git \\\n  ~/.claude/skills/storescreens\n```\n\nOr install per-project by cloning into the project's `.claude/skills/` directory:\n\n```bash\ncd /path/to/your/xcode-project\ngit clone https://github.com/ciscoriordan/storescreens-skill.git \\\n  .claude/skills/storescreens\n```\n\nUpdate later with:\n\n```bash\ngit -C ~/.claude/skills/storescreens pull\n```\n\nRestart Claude Code after installing. The skill should then appear when you run `/skills` or when an applicable request triggers it (for example, \"set up App Store screenshots\").\n\n### Other AI coding assistants\n\nFor any assistant that supports skill files or custom instructions, point it at `SKILL.md` from this repo, or load `storescreens.skill` (a packaged archive of the skill) as a skill package. Works with any assistant that can read skill definitions.\n\n## What the Agent Does\n\n1. Installs [storescreens-cli](https://github.com/ciscoriordan/storescreens-cli) (and `storescreens-mcp`) if needed\n2. Detects the Xcode project and scheme\n3. Generates `storescreens.yml` with the right devices for all required App Store sizes\n4. Sets up a UI test target and `ScreenshotTests.swift` with navigation for each screen\n5. Configures screenshot mode in the app (pro access, disabled animations, sample data)\n6. Adds accessibility identifiers for reliable element targeting\n7. Runs preflight checks - errors and warnings are surfaced before capture, with a prompt to fix or continue\n8. Runs capture (via MCP tools when available, CLI otherwise)\n9. Walks you through a `render:` block for App Store-ready framed/captioned screenshots: background (solid, gradient, or panoramic image sliced across all slides), optional scrim, logo, device chrome (none / stroke / bezel), and markdown captions with per-slide highlights\n10. Guides you through `storescreens bezels import` - mounting Apple Design Resource DMGs and installing bezel assets\n11. Iterates on caption/color/font changes via `storescreens render` without re-running a full capture\n12. Configures the App Store Connect API (`storescreens auth login`, `.p8` key, env vars) and uploads rendered screenshots + per-locale metadata (description, keywords, release notes, promotional text, privacy URL) to App Store Connect via `storescreens submit`, optionally auto-submitting the version for App Review\n13. Troubleshoots failures using build logs\n\n## MCP Server\n\nWhen `storescreens-mcp` is configured in `.mcp.json`, the agent uses structured MCP tools instead of Bash calls. This gives it per-screenshot progress inline and structured results without requiring it to parse terminal output.\n\nAvailable tools:\n\n| Tool | Description |\n|------|-------------|\n| `capture` | Start full App Store screenshot capture in background |\n| `get_capture_status` | Poll progress for a running capture |\n| `get_capture_result` | Fetch full manifest once capture is complete |\n| `take_screenshot` | Capture current simulator screen and return image inline (\u003c1 second) |\n| `check` | Run preflight scan for common issues |\n| `list_simulators` | List available simulators grouped by App Store slot |\n| `list_screenshots` | List screenshots from the last capture |\n| `get_screenshot` | Load a saved PNG as inline image |\n| `read_config` / `write_config` | Read or write `storescreens.yml` |\n\nSee [storescreens-cli](https://github.com/ciscoriordan/storescreens-cli#agent-skill) for setup instructions.\n\n## Works with Xcode MCP (Xcode 26.3+)\n\nStoreScreens complements [Xcode's built-in MCP server](https://developer.apple.com/documentation/xcode/giving-agentic-coding-tools-access-to-xcode). When both are available, the agent picks the right tool for each situation:\n\n| Tool | What it captures | When to use |\n|------|-----------------|-------------|\n| Xcode `RenderPreview` | A single SwiftUI `#Preview` | Checking an individual view's layout. No simulator needed. |\n| StoreScreens `take_screenshot` | The full running app in a simulator | Checking the app with real data, navigation, and system chrome. |\n| StoreScreens `capture` | Full App Store screenshots | Final screenshots across multiple devices, locales, and appearances. |\n\n## Contents\n\n- **`SKILL.md`** - Step-by-step instructions for the agent\n- **`storescreens.skill`** - Packaged skill archive (SKILL.md + references + assets)\n- **`references/config-reference.md`** - Top-level `storescreens.yml` config schema (devices, locales, test target, etc.)\n- **`references/render-reference.md`** - Full `render:` schema: background (including panoramic slicing), scrim, logo, caption (fonts, markdown, highlights), chrome (stroke / bezel), bezel install flow, caption shorthands, and a complete example\n- **`references/submit-reference.md`** - Full App Store Connect upload schema: `app_store_connect:` block, `submit:` sub-block, credential resolution (env + `~/.storescreens/asc-credentials.yml`), `metadata/\u003clocale\u003e/*.txt` file layout and ASC field mapping, destructive upload semantics, troubleshooting, and a complete example\n- **`references/upload-build-reference.md`** - Full `upload_build:` schema: archiving, `.ipa` export, `altool` upload to App Store Connect / TestFlight, auto-versioning, non-beta Xcode auto-selection, and troubleshooting\n- **`assets/ScreenshotTests.swift.template`** - Starter XCUITest template. Mirrored from `storescreens-cli`'s `Resources/` on every release so it stays in sync with the CLI's expected cache-path contract.\n\n## Related\n\n- [storescreens-cli](https://github.com/ciscoriordan/storescreens-cli) - The CLI tool this skill automates\n\n## License\n\n[MIT](LICENSE) \u0026copy; 2026 Francisco Riordan\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fciscoriordan%2Fstorescreens-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fciscoriordan%2Fstorescreens-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fciscoriordan%2Fstorescreens-skill/lists"}