Communitygithub.com

brainzcode/premium-landing

Obtenha fotografia gratuita e livre de licenças para um site a partir do Unsplash — pesquisando por clima em vez de substantivo, dimensionando e cortando para o espaço, respeitando os requisitos de hotlink e rastreamento de download da API, e escrevendo texto alternativo real.

O que é premium-landing?

Este skill capacita agentes de IA a enriquecer landing pages com fotografia real e de alta qualidade do Unsplash, substituindo placeholders cinzas genéricos. Ele abrange todo o fluxo de trabalho: obtenção de chave de API gratuita (50 solicitações/hora), busca por clima visual (por exemplo, "oficina industrial quente" em vez de "café") para evitar resultados genéricos, seleção de imagens com base na orientação e posicionamento do assunto para cortes adequados com `object-fit: cover`, e dimensionamento das imagens através dos parâmetros CDN do Unsplash (como `w=1600&q=80`) para otimizar a entrega. O skill também enfatiza o cumprimento das regras da API, como usar URLs CDN diretamente (hotlinking) e acionar o endpoint de download para cada foto enviada, garantindo conformidade com a licença do Unsplash, que permite uso comercial sem atribuição obrigatória, mas proíbe venda de cópias não alteradas ou uso que implique endosso sem liberações de modelo/propriedade. Finalmente, ele fornece orientação sobre criação de textos alternativos descritivos (com uso de `alt=""` para imagens decorativas), contribuindo para acessibilidade e SEO.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/stock-imagery

Perguntar na sua IA favorita

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

Documentação

Imagens de Stock

Uma página inicial com um placeholder cinza onde o herói deveria estar está inacabada. Isso cobre a obtenção de fotografia real que seja gratuita para uso comercial, combine com o design, e não quebre quando outra pessoa carregar a página.

O endpoint que todo mundo tenta primeiro está morto

https://source.unsplash.com/1600x900/?coffee     →  HTTP 503

source.unsplash.com — o endpoint de imagem aleatória sem chave — foi descontinuado. Ele ainda está por toda parte em posts de blog e templates mais antigos, e agora retorna 503. Se você o encontrar em um código, isso é uma imagem quebrada, não uma funcional.

O que funciona, sem chave, é a CDN quando você já conhece um id de foto:

https://images.unsplash.com/photo-1447933601403-0c6688de566e?auto=format&fit=crop&w=1600&q=80

Isso retorna uma imagem real. Mas você não pode pesquisar sem uma chave, e inventar ids de fotos não funciona. Então:

Obtendo uma chave (dois minutos, gratuita)

  1. https://unsplash.com/oauth/applications → Novo Aplicativo → aceite os termos
  2. Copie a Chave de Acesso
  3. Exporte-a — nunca a commite:
export UNSPLASH_ACCESS_KEY="sua_chave_de_acesso"

A camada de demonstração é de 50 solicitações/hora, o que é suficiente para uma página inicial. Se o usuário não tiver uma chave, diga isso e peça — não caia silenciosamente para caixas cinzas e não invente URLs.

curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
  "https://api.unsplash.com/search/photos?query=coastal+fog&orientation=landscape&per_page=8" \
| python3 -c "
import json,sys
for p in json.load(sys.stdin)['results']:
    print(p['id'], p['width'], p['height'], '|', (p.get('alt_description') or '')[:60])
    print('   ', p['urls']['raw'])
    print('   ', p['user']['name'], p['links']['download_location'])
"

Duas regras da API que são fáceis de esquecer

1. Use hotlink nos URLs que a API retorna. Os termos da API do Unsplash exigem o uso de seus URLs CDN em vez de re-hospedar o arquivo. Isso entra em conflito com o conselho usual de servir ativos locais otimizados, e os termos prevalecem enquanto você estiver usando a API. Se um cliente precisar de arquivos auto-hospedados, licencie a foto através do Unsplash+ ou compre em outro lugar — não re-hospede silenciosamente na esperança de que funcione.

2. Acione o endpoint de download quando uma foto for realmente usada. Não quando ela for pré-visualizada — quando for enviada. É assim que os fotógrafos recebem crédito pelo uso, e é uma condição da API, não uma cortesia.

curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
  "$DOWNLOAD_LOCATION"   # o valor links.download_location do resultado da pesquisa

Limites da licença

A Licença Unsplash permite uso comercial e não comercial sem permissão e sem atribuição obrigatória. Ela não permite vender cópias inalteradas, e não permite construir um serviço de fotos concorrente. As fotos podem conter pessoas identificáveis, marcas registradas ou obras de arte — o Unsplash não faz liberação de modelo ou propriedade, portanto, para qualquer coisa que implique endosso (uma pessoa parecendo ser um cliente, uma foto de depoimento) use uma imagem com liberação.

A atribuição não é obrigatória, mas custa uma linha e é a coisa certa a fazer:

<!-- Foto: Jane Doe / Unsplash -->

Escolhendo bem

Pesquisar pelo substantivo literal é o que faz uma página parecer um template. "Café" retorna dez mil fotos idênticas de latte art de cima.

Pesquise o clima, não o assunto. Para uma torrefação de café: oficina industrial quente, mãos trabalhando, interior com luz matinal. Para uma consultoria de investimentos: arquitetura parada, interior minimalista silencioso, sombras longas.

Em seguida, filtre por três coisas que o design realmente restringe:

  • Orientação e posicionamento do assunto. Um herói que corta com object-fit: cover precisa do assunto descentralizado ou com espaço livre acima, ou o corte o decapita. Verifique onde o assunto está antes de escolher — a aritmética do enquadramento está em ../landing-page/references/traps.md.
  • Faixa tonal. O texto sobreposto precisa que a região atrás dele seja consistentemente clara ou consistentemente escura. Uma foto de tom médio ocupada torna toda cor de texto errada.
  • Um fotógrafo, ou um visual. Três imagens de três fotógrafos em uma seção parecem stock. Prefira vários quadros de uma única sessão, ou uma pós-produção consistente.

Dimensionamento

Os parâmetros da CDN do Unsplash fazem o redimensionamento, então solicite o tamanho que você exibe:

?auto=format&fit=crop&w=1600&q=80        herói
?auto=format&fit=crop&w=800&q=80         card
?auto=format&fit=crop&w=192&h=192&q=80   avatar (quadrado)

auto=format serve WebP/AVIF para navegadores que aceitam. Para heróis responsivos, emita um srcset com 800/1200/1600/2000 em vez de enviar um arquivo de 2000px para telefones.

Texto alternativo (alt)

alt descreve o que a imagem mostra, para alguém que não pode vê-la. Não é um espaço para palavras-chave nem o título da foto.

<!-- não -->
<img alt="imagem herói da página inicial da torrefação de café">
<!-- sim -->
<img alt="Tostador despejando grãos verdes em um torrador de tambor em uma oficina">

Se a imagem for decorativa e o texto ao redor já disser tudo, use alt="" para que um leitor de tela a ignore. Um alt vazio é correto; um alt ausente não é.

Lista de verificação

  • UNSPLASH_ACCESS_KEY definida, nunca commitada
  • Pesquisou o clima, não o substantivo literal
  • Posicionamento do assunto verificado em relação a como o espaço corta
  • Faixa tonal funciona sob qualquer texto sobreposto
  • Imagens em uma seção compartilham um visual
  • URLs CDN usados via hotlink conforme exigido pela API — não re-hospedados
  • download_location acionado para cada foto enviada
  • Parâmetros de dimensionamento correspondem ao tamanho de exibição; srcset em heróis responsivos
  • Texto alternativo real, ou alt="" quando decorativo
  • Nenhuma suposição de liberação de modelo/propriedade para nada que implique endosso

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Build a complete premium landing page, either replicated from a reference screenshot/URL or designed from a written brief, in HTML, React, Next.js or Astro. Use when asked to build, design, replicate or clone a landing page, marketing page, or one-page site; when handed a design screenshot or Figma/Pinterest reference to turn into code; or when a landing page needs a full premium pass. Covers design tokens, section patterns, the layout traps that silently break grids and marquees, and screenshot-based responsive verification from 320px to 1920px.

brainzcode/premium-landing

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

brainzcode/premium-landing

Build true Apple-style liquid glass in the browser — real refraction via SVG displacement maps, chromatic dispersion, specular edges. Use when asked for liquid glass, glassmorphism, frosted/glass cards, glass navbars, or when a blur-based "glass" effect looks flat. Includes the performance trap that makes backdrop-filter stutter on scroll and the contrast trap that makes text unreadable on glass.

brainzcode/premium-landing

Build a premium mobile nav — a hamburger button that morphs into a close X, a full-screen overlay panel with staggered link reveal, scroll lock, focus trap, and reduced-motion handling. Use when asked for a mobile menu, hamburger/burger button, nav drawer, off-canvas menu, or when a menu loses scroll position, still scrolls behind on iOS, leaks Tab focus to the page underneath, or the close button stops responding. Includes the z-index trap that swallows the close button and the iOS rubber-band trap.

brainzcode/premium-landing

Rebuild a design accurately from a supplied reference — a screenshot, PDF page, mockup or live URL — by measuring it numerically instead of eyeballing it. Use when asked to replicate, clone, match or rebuild a design "exactly", "1 to 1" or "with no mistakes", or when a build drifts from its reference. Covers extracting the true content box from a padded screenshot, deriving element positions as percentages, solving object-fit framing, and knowing when a reference cannot be matched.

brainzcode/premium-landing

Ship link previews and favicons that actually work - Open Graph and Twitter card tags, a correctly framed 1200x630 share image, and a full favicon set (SVG, ICO, apple-touch, maskable manifest icons). Use when asked for social sharing, OG image, open graph, twitter card, link preview, share image, favicon, app icon, apple touch icon, or web manifest. Also use when a shared link previews blank, shows the wrong image, or a favicon will not appear. Includes the absolute-URL trap that silently blanks every preview and the font trap that breaks SVG favicons on other machines.

Habilidades Relacionadas