Communitygithub.com

brainzcode/premium-landing

Obtén fotografías gratuitas y sin restricciones de licencia para un sitio web desde Unsplash — buscando por estado de ánimo en lugar de sustantivos, ajustando tamaño y recorte para el espacio, respetando los requisitos de enlace directo y seguimiento de descargas de la API, y escribiendo texto alternativo real. Úsalo cuando una página necesite una imagen destacada, fotografía de sección, avatares o imágenes de tarjetas y no se haya proporcionado ninguna; cuando los marcadores de posición grises necesiten ser reemplazados con imágenes reales; o cuando se te pida encontrar, seleccionar o intercambiar fotos para un diseño.

¿Qué es premium-landing?

Este skill, 'brainzcode/premium-landing', está diseñado para que los asistentes de IA (como Claude Code, Cursor o Codex) puedan agregar imágenes de stock de alta calidad a páginas web o interfaces de usuario, utilizando la API de Unsplash. Su función principal es reemplazar marcadores de posición grises o imágenes genéricas con fotografías reales, gratuitas y con licencia comercial, siguiendo las mejores prácticas y reglas de la API de Unsplash. El skill guía al usuario en la obtención de una clave de API gratuita, la búsqueda efectiva de imágenes por 'estado de ánimo' (mood) en lugar de sustantivos literales, el redimensionado y recorte correcto para diferentes slots (héroe, tarjeta, avatar), el cumplimiento de los términos de licencia (enlace directo a CDN, activación del endpoint de descarga) y la escritura de textos alternativos (alt) descriptivos para accesibilidad. Es útil para desarrolladores y diseñadores que buscan mejorar visualmente sus proyectos de forma rápida y legal.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Imágenes de stock

Una página de aterrizaje con un marcador de posición gris donde debería ir la imagen destacada está incompleta. Esto cubre la obtención de fotografías reales que sean gratuitas para uso comercial, que coincidan con el diseño y que no se rompan cuando alguien más cargue la página.

El endpoint que todos intentan primero está muerto

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

source.unsplash.com — el endpoint de imágenes aleatorias sin clave — fue retirado. Todavía aparece en publicaciones de blog y plantillas antiguas, y ahora devuelve 503. Si lo encuentras en un código base, eso es una imagen rota, no una que funcione.

Lo que sí funciona, sin clave, es la CDN cuando ya conoces un ID de foto:

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

Eso devuelve una imagen real. Pero no puedes buscar sin una clave, y inventar IDs de fotos no funciona. Entonces:

Obtener una clave (dos minutos, gratuita)

  1. Ve a https://unsplash.com/oauth/applications → Nueva Aplicación → acepta los términos
  2. Copia la Clave de Acceso
  3. Exhíbela como variable de entorno — nunca la confirmes en el repositorio:
export UNSPLASH_ACCESS_KEY="tu_clave_de_acceso"

El nivel de demostración es de 50 solicitudes/hora, lo cual es suficiente para una página de aterrizaje. Si el usuario no tiene una clave, díselo y pregúntale — no recurras silenciosamente a cajas grises ni inventes URLs.

curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
  "https://api.unsplash.com/search/photos?query=neblina+costera&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'])
"

Dos reglas de la API que son fáciles de pasar por alto

1. Enlaza directamente las URLs que devuelve la API. Los términos de la API de Unsplash requieren usar sus URLs de CDN en lugar de volver a alojar el archivo. Esto entra en conflicto con el consejo habitual de servir activos locales optimizados, y los términos prevalecen mientras estés usando la API. Si un cliente necesita archivos autoalojados, licencia la foto a través de Unsplash+ o cómprala en otro lugar — no la vuelvas a alojar silenciosamente esperando que funcione.

2. Activa el endpoint de descarga cuando una foto se use realmente. No cuando se previsualice — cuando se publique. Así es como los fotógrafos obtienen crédito por el uso, y es una condición de la API, no una cortesía.

curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
  "$UBICACION_DESCARGA"   # el valor de links.download_location del resultado de búsqueda

Límites de la licencia

La Licencia de Unsplash permite uso comercial y no comercial sin permiso y sin atribución requerida. No permite vender copias sin alteraciones, y no permite construir un servicio de fotos competidor. Las fotos pueden contener personas identificables, marcas comerciales o obras de arte — Unsplash no gestiona autorizaciones de modelo o propiedad, por lo que para cualquier cosa que implique respaldo (una persona que parece ser un cliente, una foto de testimonio) es mejor obtener una imagen con autorización.

La atribución no es obligatoria pero cuesta una línea y es lo correcto:

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

Elegir bien

Buscar el sustantivo literal es lo que hace que una página parezca una plantilla. "Café" devuelve diez mil fotos idénticas de arte latte desde arriba.

Busca el estado de ánimo, no el tema. Para una tostaduría de café: taller industrial cálido, manos trabajando, luz matutina interior. Para una asesoría financiera: arquitectura serena, interior minimalista tranquilo, sombras largas.

Luego filtra por tres cosas que el diseño realmente condiciona:

  • Orientación y colocación del sujeto. Una imagen destacada que se recorta con object-fit: cover necesita que el sujeto esté descentrado o con espacio superior, o el recorte lo decapita. Verifica dónde se sitúa el sujeto antes de elegir — la aritmética del encuadre está en ../landing-page/references/traps.md.
  • Rango tonal. El texto superpuesto necesita que la región detrás de él sea consistentemente clara u oscura. Una foto de tonos medios ocupados hace que cualquier color de texto sea incorrecto.
  • Un fotógrafo, o un estilo visual. Tres imágenes de tres fotógrafos diferentes en una misma sección parecen de stock. Prefiere varios fotogramas de una misma sesión, o una gradación consistente.

Tamaños

Los parámetros de la CDN de Unsplash realizan el redimensionado, así que solicita el tamaño que mostrarás:

?auto=format&fit=crop&w=1600&q=80        héroe
?auto=format&fit=crop&w=800&q=80         tarjeta
?auto=format&fit=crop&w=192&h=192&q=80   avatar (cuadrado)

auto=format sirve WebP/AVIF a los navegadores que lo aceptan. Para imágenes destacadas responsivas, genera un srcset a 800/1200/1600/2000 en lugar de enviar un archivo de 2000px a los teléfonos.

Texto alternativo

alt describe lo que la imagen muestra, para alguien que no puede verla. No es un espacio para palabras clave ni el título de la foto.

<!-- incorrecto -->
<img alt="imagen destacada de la página de inicio de la tostaduría de café">
<!-- correcto -->
<img alt="Tostador vertiendo granos verdes en un tambor tostador en un taller">

Si la imagen es decorativa y el texto circundante ya lo dice todo, usa alt="" para que un lector de pantalla lo omita. Un alt vacío es correcto; un alt faltante no lo es.

Lista de verificación

  • UNSPLASH_ACCESS_KEY configurada, nunca confirmada en el repositorio
  • Se buscó por estado de ánimo, no por el sustantivo literal
  • Se verificó la colocación del sujeto en relación con cómo recorta el espacio
  • El rango tonal funciona con cualquier texto superpuesto
  • Las imágenes en una misma sección comparten un estilo visual
  • Las URLs de la CDN están enlazadas directamente como lo requiere la API — no re-alojadas
  • Se activó download_location para cada foto que se publica
  • Los parámetros de tamaño coinciden con el tamaño de visualización; srcset en imágenes destacadas responsivas
  • Texto alternativo real, o alt="" cuando es decorativo
  • No se asume autorización de modelo/propiedad para nada que implique respaldo

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.

Skills relacionados