CommunityImagemgithub.com

F2-Beamer/stock-photo-metadata

Use quando for preparar fotos para upload em contas de contribuidor do Adobe Stock ou Shutterstock, quando uma foto de banco de imagens precisar de título, descrição, categoria ou palavras-chave, ou quando um lote de imagens de banco de imagens precisar de um CSV de metadados.

O que é stock-photo-metadata?

Este skill gera metadados precisos e prontos para upload para as plataformas Adobe Stock e Shutterstock. Ele cria, para cada imagem, um título, descrição, categoria e palavras-chave em inglês, respeitando rigorosamente os limites de caracteres, quantidade de palavras-chave e formatos de CSV definidos no arquivo `platform-rules.md`, que deve ser consultado antes de cada execução. Para lotes de imagens, o skill também gera arquivos CSV no formato exato exigido por cada plataforma, organizando as imagens aprovadas em subpastas e rejeitando aquelas que não atendem aos critérios mínimos de qualidade (como ruído, baixa resolução, logos ou pessoas não autorizadas). O processo envolve analisar visualmente a imagem, verificar a necessidade de releases, escrever metadados sem alucinações ou palavras-chave genéricas, e garantir que nada seja duplicado ou fora do contexto. O skill é indicado para fotógrafos e contribuidores que desejam automatizar a preparação de metadados de forma consistente e confiável, evitando rejeições por parte das plataformas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/F2-Beamer/stock-photo-metadata/tree/HEAD

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Metadados de Fotos de Banco de Imagens

Visão Geral

Cria, para cada imagem, metadados em inglês para Adobe Stock e Shutterstock: título, descrição, categoria e palavras-chave. Para várias imagens, também gera um arquivo CSV. As explicações ao usuário permanecem em português, mas os metadados são em inglês.

Os valores das plataformas (limites de caracteres, número de palavras-chave, listas de categorias, formatos CSV) estão em platform-rules.md, na mesma pasta. Leia este arquivo antes de cada saída. Os formatos CSV de ambas as plataformas foram confirmados com uploads bem-sucedidos. Pendentes estão o limite de descrição do Shutterstock e palavras-chave rejeitadas (consulte platform-rules.md).

Procedimento

  1. Visualizar a imagem. Anotar o motivo principal, clima, cores, local, estação do ano, horário do dia, pessoas visíveis, marcas, logotipos, edifícios e propriedades particulares.
  2. Verificar releases. Pessoas identificáveis, marcas/logotipos, edifícios ou terrenos particulares, obras de arte, conteúdo de IA. Se houver algum desses, incluir a observação na saída. Nunca afirmar que uma imagem está livre de restrições se houver dúvidas.
  3. Escrever o título. Concreto, descritivo, sem palavras de preenchimento e sem nomes de marcas, a menos que tenham release.
  4. Escrever a descrição. Uma ou duas frases, motivo e contexto. Manter dentro do limite de caracteres do Shutterstock.
  5. Escolher a categoria. Para Adobe: exatamente um número e nome da lista. Para Shutterstock: até duas categorias da lista em platform-rules.md. No CSV, escrever em minúsculas e em inglês, ex.: nature,parks/outdoor.
  6. Escolher as palavras-chave. Colocar as mais importantes primeiro. Motivo, objetos, clima, cores, local, estação do ano, finalidade de uso. Sem repetições, sem termos que não correspondam à imagem.

Verificar e Classificar Imagens

Sob solicitação, o skill verifica todas as imagens de uma pasta e as move para as subpastas aprovadas/ e rejeitadas/. Fluxo:

  1. Listar todos os JPG/JPEG/PNG diretamente na pasta (não em aprovadas/ ou rejeitadas/). Criar as subpastas se não existirem.
  2. Visualizar cada imagem e avaliar:
    • Rejeitada se algum dos seguintes itens se aplicar:
      • Fortemente subexposta ou ruidosa, motivo quase irreconhecível
      • Ruído visível (granulação no céu, sombras ou áreas uniformes), mesmo com brilho adequado
      • Baixa resolução: menos de 4 megapixels de pixels totais (valor de referência, não verificado)
      • Fora de foco ou tremida
      • Logotipo ou marca visível (ex.: logotipo de empresa em caminhão) sem release
      • Pessoas identificáveis, edifícios particulares, instalações governamentais ou militares sem release
      • Marca d'água, texto na imagem ou artefatos fortes
    • Aprovada em todos os outros casos.
    • Em caso de dúvida, classificar como "rejeitada" e informar o motivo. O usuário decide.
  3. Para cada imagem, uma frase de justificativa (em português).
  4. Mover os arquivos, não copiar. Se um arquivo com o mesmo nome já existir no destino, não sobrescrever e perguntar.
  5. Resumo: quantidade de aprovadas e rejeitadas, lista dos arquivos rejeitados com o motivo.

Apenas imagens aprovadas entram na criação de metadados e nos arquivos CSV.

Saída por Imagem

**Nome do arquivo:** <nome>

**Releases:** <observação ou "nenhuma identificável">

**Adobe Stock**
- Título: ...
- Categoria: <nº> <nome>
- Palavras-chave: ...

**Shutterstock**
- Descrição: ...
- Categoria 1: ...
- Categoria 2: ...
- Palavras-chave: ...

CSV para Várias Imagens

Dois arquivos na pasta das imagens, UTF-8. Aspas apenas onde um campo contiver vírgulas (ex.: palavras-chave). Nome do arquivo, título e categoria nunca entre aspas. Caso contrário, o Adobe lê o nome do arquivo com aspas e não associa a linha a nenhuma imagem.

Adobe Stock: adobe-stock-upload.csv (separador vírgula, colunas exatamente assim, em inglês):

Filename,Title,Keywords,Category,Releases

  • Filename: nome completo do arquivo com extensão
  • Keywords: separadas por vírgula, máx. 49, por relevância
  • Category: apenas o número, ex.: 11
  • Releases: deixar em branco se não houver release

Shutterstock: shutterstock-metadados.csv (separador vírgula, formato do arquivo de exemplo do Shutterstock, upload confirmado):

Filename,Description,Keywords,Categories,Editorial,Mature content,illustration

  • Categories: até duas, separadas por vírgula entre aspas, em minúsculas e em inglês, ex.: "nature,parks/outdoor"
  • Editorial, Mature content, illustration: cada um no. Nenhum upload editorial como alternativa: imagens com instalação identificável, edifício ou propriedade sem release são rejeitadas (rejeitadas/), não enviadas como editorial.
  • Nenhuma coluna de release no formato. Informar releases apenas na observação ao usuário.

Regras

  • Sem alucinações: local, espécie animal, tipo de árvore, marca só mencionar se visível ou claramente identificável. Caso contrário, formular de forma genérica.
  • Nenhuma palavra-chave que seja apenas tendência ou termo de busca, mas que não corresponda à imagem.
  • Sem repetições de palavras-chave e sem palavras como "best", "beautiful", "amazing".
  • Respeitar rigorosamente os limites de caracteres, contar após escrever.
  • Palavras-chave: cerca de 30 por imagem. O Shutterstock rejeita palavras-chave individuais. O usuário informa quais, e elas são registradas em platform-rules.md em "Palavras-chave Rejeitadas". Nunca usar esses termos novamente.
  • Nunca omitir releases, mesmo em caso de dúvida.

Erros Comuns

ErroCorreção
Título mais longo que o necessário, keyword stuffingCurto e concreto, palavras-chave separadas
Mais de uma categoria no AdobeExatamente uma categoria
Nomes de marcas no títuloRemover ou informar release
Local adivinhadoSó mencionar se visível, caso contrário "lake", "mountain" etc.
Limites da plataforma de memóriaVerificar em platform-rules.md

Habilidades Relacionadas