About

Imported from akillness/jeo-skills (.agent-skills/unsplash-asset-images/SKILL.md). Install upstream with npx skills add akillness/jeo-skills --skill unsplash-asset-images. Copyright stays with the author (MIT).

Unsplash Asset Images (Avatars, Portraits, Backgrounds, Wallpapers)

Name: unsplash-asset-images
Author: akillness

Goal: quickly grab good-looking images from Unsplash and deliver them in the right size + ratio.

When to use this skill

Need a real Unsplash photo page URL (not a placeholder) for an avatar, headshot, portrait, hero background, or abstract wallpaper.
Need the recommendation delivered with suggested output ratios/sizes (1:1, 4:5, 3:4, 16:9, 9:16) for a specific use case.
Need guidance on downloading and cropping/resizing an Unsplash photo for a design or image pipeline.
Need a quick "which ratio do I use?" decision for avatars, headshot cards, hero backgrounds, or mobile wallpapers.
Need reminders on Unsplash licensing/attribution norms (e.g., avoiding Unsplash+ unless requested).
Don't use this for Aura Assets (aura.build/assets) searches — route to aura-asset-images instead, which searches Aura's own asset library by tag rather than Unsplash.

Output rule

For each recommendation, output:

Unsplash page URL (canonical)
Suggested ratios + sizes for the use case

If the user wants a file, instruct them to use the Download button on Unsplash and then crop/resize in their design tool or image pipeline.

License / safety (keep it simple)

Unsplash images are generally free to use, but avoid Unsplash+ images unless the user explicitly wants them.
Don’t present the photographer name as “required attribution” (Unsplash doesn’t require it), but it’s good practice to include.

How to deliver the right size + ratio

Open the Unsplash photo page and use the Download button.
Resize/crop to the target ratio in your design tool or image pipeline.
Keep faces centered for avatars/headshots and preserve horizon for wide backgrounds.

Note: do not include Unsplash source or secondary image links; keep only the main photo page URLs.

Curated picks (5 each)

1) Avatars (1:1)

Pick images with clean face framing + simple backgrounds.

Suggested deliverables:

1:1: 256×256, 512×512, 1024×1024

2) Headshots (4:5 or 3:4)

Aim for shoulders-up framing, neutral backgrounds, “professional but human”.

Suggested deliverables:

4:5: 800×1000, 1200×1500, 1600×2000
3:4: 900×1200, 1500×2000

3) Portraits (editorial / candid)

Use these when the vibe is “human story”, not “corporate headshot”.

Suggested deliverables:

3:4: 1500×2000
4:5: 1200×1500
1:1 crop for social: 1080×1080

4) Large backgrounds (website hero, banners) — 16:9

Pick wide shots with clean negative space and readable gradients.

Suggested deliverables:

Desktop hero: 1920×1080, 2400×1350, 2880×1620
Social banner: 1500×500 (3:1) — consider manual crop

5) Abstract wallpapers (desktop/mobile)

Use when you need “brand-safe”, non-specific visuals.

Suggested deliverables:

Desktop: 2560×1600 or 2880×1800
Mobile: 1080×1920 (9:16)

Quick “which ratio do I use?” cheatsheet

Avatar: 1:1
Headshot card: 4:5 (great default), 3:4 (taller)
Website hero background: 16:9
Mobile wallpaper / story background: 9:16

If the user asks for “best image”:

prefer clean negative space
avoid busy backgrounds
ensure face is not cropped awkwardly (use crop=faces on production URLs)

References

Upstream source: https://github.com/MengTo/Skills/tree/main/agent-skills/media/unsplash-asset-images

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/akillness-jeo-skills-unsplash-asset-images/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

akillness-jeo-skills-unsplash-asset-images.ocm.jsonjson

{
  "ocm": "1",
  "id": "akillness-jeo-skills-unsplash-asset-images",
  "kind": "skill",
  "name": "unsplash-asset-images",
  "description": "Use when you need to pick high-quality Unsplash images for product/design assets (avatars, headshots, portraits, large website backgrounds, and abstract wallpapers) and output real Unsplash URLs plus practical instructions for producing the right resolutions and aspect ratios (1:1, 4:5, 3:4, 16:9, 9:16).",
  "publisher": "akillness",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "unsplash",
      "asset",
      "images",
      "mengto-skills",
      "stock-images",
      "design-assets",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Use when you need to pick high-quality Unsplash images for product/design assets (avatars, headshots, portraits, large website backgrounds, and abstract wallpapers) and output real Unsplash URLs plus practical instructions for producing the right resolutions and aspect ratios (1:1, 4:5, 3:4, 16:9, 9:16)."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/akillness/jeo-skills",
      "path": ".agent-skills/unsplash-asset-images/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/akillness/jeo-skills/blob/HEAD/.agent-skills/unsplash-asset-images/SKILL.md",
      "key": "akillness/jeo-skills/.agent-skills/unsplash-asset-images/SKILL.md"
    },
    "compatibility": "Needs web access to browse the asset library and return real image URLs. No local dependencies.",
    "allowed_tools": [
      "Bash",
      "Read",
      "Write",
      "Edit",
      "Glob",
      "Grep",
      "WebFetch"
    ],
    "license": "MIT"
  },
  "instructions": "# Unsplash Asset Images (Avatars, Portraits, Backgrounds, Wallpapers)\n\nGoal: quickly grab *good-looking* images from Unsplash and deliver them in the **right size + ratio**.\n\n## When to use this skill\n\n- Need a real Unsplash photo page URL (not a placeholder) for an avatar, headshot, portrait, hero background, or abstract wallpaper.\n- Need the recommendation delivered with suggested output ratios/sizes (1:1, 4:5, 3:4, 16:9, 9:16) for a specific use case.\n- Need guidance on downloading and cropping/resizing an Unsplash photo for a design or image pipeline.\n- Need a quick \"which ratio do I use?\"",
  "cost": {
    "context_tokens": 1395
  }
}

Fetch it by URL: GET /api/v1/registry/akillness-jeo-skills-unsplash-asset-images/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.