image-unsplash

Search Unsplash for landscape hero images using article metadata and brand context.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/pulse-energy-eu/geo-content --skill image-unsplash
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: image-unsplash
Source: https://github.com/pulse-energy-eu/geo-content/tree/main/.claude/skills/image-unsplash
Command: npx skills add https://github.com/pulse-energy-eu/geo-content --skill image-unsplash

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finding a suitable, high-quality hero image for blog posts can be time-consuming and may involve licensing considerations. This skill automates sourcing a relevant Unsplash image that matches the article topic and brand tone, helping you publish faster with visuals that fit your content.

Core Features & Use Cases

  • Automated image search: Generates and searches Unsplash for landscape photos aligned with the article's topic and brand context.
  • Quality & licensing: Selects images available under Unsplash license suitable for commercial use.
  • Workflow integration: Presents candidate images and saves the chosen hero image next to the article file for publishing.
  • Use Case: You publish a post about a new AI workflow and want a hero image that conveys collaboration and a modern aesthetic.

Quick Start

Use the image-unsplash skill to fetch a hero image for the article located at hyperspell/output/context-engineering-final.md.

Frequently Asked Questions about image-unsplash

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch a hero image for blog posts from Unsplash?

To fetch a hero image for blog posts, the skill uses article metadata and brand context to drive 3-5 search queries against the Unsplash API, returning landscape candidates. You need an Unsplash access key to trigger downloads and save the selected image next to your article file.

Can I use Unsplash photography for commercial blog visuals?

Yes, you can use Unsplash photography for commercial blog visuals. The skill specifically selects images available under the Unsplash license that are suitable for commercial use, ensuring your brand context and published content remain compliant.

Does the Unsplash image search require an API access key?

Yes, the Unsplash image search requires an Unsplash access key. The skill uses curl-based API calls to search for landscape photography, trigger downloads, and save the chosen hero image next to the article file.

How does brand context affect automated image search results?

Brand context directly shapes automated image search results by guiding the generation of 3-5 tailored Unsplash queries. This ensures the returned landscape hero candidates match both the article topic and your brand's specific visual tone.

What is the best way to integrate landscape photography into a publishing workflow?

The best way to integrate landscape photography into a publishing workflow is to present candidate images and save the chosen hero image directly next to the article file. This streamlines content creation by matching article metadata with high-quality visuals.

What happens if I do not provide brand context for the hero image search?

Without brand context, the hero image search relies solely on article metadata to generate the 3-5 Unsplash queries. The returned landscape candidates will still match the topic, but may not align as closely with your specific brand tone and visual aesthetic.