asc-screenshot-resize

Visão geral da skill asc-screenshot-resize

O que a skill asc-screenshot-resize faz

A skill asc-screenshot-resize ajuda você a preparar screenshots da App Store para envio, verificando os tamanhos aceitos no momento e redimensionando ou validando imagens com o sips do macOS e a CLI asc. Ela serve para o trabalho prático de deixar as screenshots prontas para submissão sem ter que adivinhar dimensões com base em uma tabela desatualizada.

Quem deve usar

Use a skill asc-screenshot-resize se você gerencia ativos do App Store Connect, corrige exportações de screenshots para release ou precisa de um jeito repetível de validar conjuntos de screenshots por dispositivo. Ela é especialmente útil em fluxos de Design Implementation, em que o resultado de design precisa bater exatamente com os requisitos do App Store Connect.

Por que esta skill é diferente

O principal diferencial do asc-screenshot-resize é que ele não depende de uma tabela fixa de tamanhos dentro da própria skill. Ele espera que a CLI forneça a fonte de verdade atual, o que reduz o risco de divergência quando a Apple altera as dimensões aceitas para screenshots.

Como usar a skill asc-screenshot-resize

Instale e verifique a skill

Instale a skill com npx skills add rudrankriyam/app-store-connect-cli-skills --skill asc-screenshot-resize. Depois da instalação, abra primeiro skills/asc-screenshot-resize/SKILL.md, porque é ali que estão definidos o fluxo de trabalho e os comandos exatos de validação. Em seguida, confira a árvore de arquivos local em busca de convenções do projeto pai antes de processar os ativos em lote.

Comece pela matriz de tamanhos atual

No uso da asc-screenshot-resize, comece perguntando à CLI quais tamanhos estão aceitos no momento:

asc screenshots sizes --output table
asc screenshots sizes --all --output table

Use a visão --all quando precisar de suporte para destinos menos comuns, como Apple TV, Mac, Vision Pro, Watch ou iMessage. Esse passo é importante porque a skill foi pensada com base nos dados atuais da plataforma, e não na memória ou em documentação estática.

Prepare os inputs antes de redimensionar

Antes de fazer uma passada de resize, limpe os nomes dos arquivos e verifique os metadados das imagens. Espaços Unicode ocultos podem quebrar ferramentas em lote, e dimensões incompatíveis podem fazer uma screenshot aparentemente correta falhar na validação. Um bom prompt ou pedido de tarefa deve informar o tipo de dispositivo de destino, a pasta de origem, a pasta de saída esperada e se você precisa apenas de validação rigorosa ou de resize com validação.

Use um prompt de fluxo de trabalho concreto

Um bom pedido de orientação para a asc-screenshot-resize é específico, não genérico. Por exemplo: “Valide as screenshots em ./screenshots/iphone para IPHONE_65, corrija primeiro os problemas de nome de arquivo e depois redimensione só se for necessário, reportando qualquer imagem que ainda falhe nas dimensões.” Isso dá contexto suficiente para a skill escolher o caminho certo e deixa o resultado mais confiável.

FAQ da skill asc-screenshot-resize

A asc-screenshot-resize serve só para App Store Connect?

Sim. O objetivo dela é preparar e validar screenshots para o App Store Connect. Não é uma skill genérica de edição de imagem, nem foi feita para substituir uma ferramenta de design em decisões de layout, cortes ou revisão de identidade visual.

Preciso da CLI asc para usar esta skill?

Sim. A skill depende da asc como fonte de verdade para os tamanhos atuais de screenshots e para os comandos de validação. Se você quer apenas redimensionamento genérico de imagens, um prompt comum ou um script independente pode ser mais simples.

A asc-screenshot-resize é amigável para iniciantes?

Em geral, sim, desde que você consiga seguir um fluxo básico no terminal. A principal curva de aprendizado está em entender os alvos por tipo de dispositivo e em ler a saída da validação. Normalmente, iniciantes conseguem melhores resultados começando com um único conjunto de dispositivos e confirmando os tamanhos aceitos antes de mexer nos arquivos.

Como melhorar a skill asc-screenshot-resize

Dê a ela o alvo real, não um objetivo vago

O maior ganho de qualidade vem de informar o destino exato: tipo de dispositivo, caminho da pasta e se as screenshots são para iPhone, iPad ou outro alvo do App Store Connect. A asc-screenshot-resize funciona melhor quando consegue validar contra um alvo de upload concreto, em vez de tentar inferir a intenção a partir dos nomes dos arquivos.

Reduza modos de falha evitáveis

Os problemas mais comuns são suposições antigas sobre dimensões, caracteres ocultos nos nomes dos arquivos e mistura de screenshots de dispositivos diferentes na mesma pasta. Se a primeira execução falhar, verifique a sanitização dos nomes e compare os metadados da imagem com sips antes de rodar novamente a passada de resize ou validação.

Faça iterações com validação, não no chute

Use a primeira saída como uma passada de diagnóstico. Se uma screenshot estiver fora por uma margem mínima, corrija a exportação original ou a política de crop em vez de redimensionar repetidamente o mesmo arquivo com problema. Para a asc-screenshot-resize em fluxos de Design Implementation, o ciclo de feedback mais forte é: validar, corrigir a exportação original de design e validar de novo até que o conjunto corresponda aos requisitos atuais do App Store Connect.