Repolode
Submit
pyang5166

pyang5166/gbro-cover-design

An AI agent skill that turns an article into a 3:4 vertical cover image prompt for WeChat Official Accounts and Xiaohongshu, with optional face consistency.

View on GitHub
Stars
907
Forks
98
Open issues
1
Last commit
3 months ago

What is it?

gbro-cover-design is a skill for AI coding agents such as Claude Code and Codex. You give the agent an article, and it asks a few rounds of questions about composition, title, reference images, expression, background color and fonts, then outputs a ready-to-use image generation prompt for a cover.

The skill offers 10 composition styles, from dark gradient layouts with large centered text to minimal whitespace and product-focused designs. Each style has its own prompt template loaded on demand, and a set of example prompts is included for reference. The output is fixed to a 3:4 vertical format with a defined safe area.

For cover images featuring a real person, the first reference image is used to keep facial features consistent across generations. The image model you use needs to accept multiple reference images for this to work. The project is a fork of oh-my-cover-design, with a shorter question flow and a first-run configuration step.

Key features

  • 01Turns an article into a cover image prompt after three rounds of questions
  • 02Offers 10 composition styles with separate prompt templates
  • 03Outputs fixed 3:4 vertical images with a defined safe area
  • 04Keeps facial features consistent using a user-provided reference photo
  • 05Includes example prompts for few-shot reference
  • 06Works with Claude Code, Codex and other agents that support custom skills

Use cases

  • Creating WeChat Official Account article covers from written posts
  • Making Xiaohongshu cover images with a consistent presenter's face
  • Generating cover prompts for product screenshots or comparison posts

Quick start

  1. 1

    Clone the repository into your Claude Code skills folder

    git clone https://github.com/pyang5166/gbro-cover-design.git ~/.claude/skills/gbro-cover-design
  2. 2

    Prepare a clear front-facing face photo at assets/my-face.png (optional, for face consistency)

  3. 3

    Send an article to the agent; it asks three rounds of questions and outputs a cover image prompt

Things to know

  • The skill only produces image prompts; you need a separate image model that accepts multiple reference images to generate the cover.
  • Face consistency requires an image model that supports multi-reference input, such as Seedream 4.0, Nano Banana or GPT-Image.
  • The repository must be cloned in full, because the SKILL.md file alone is incomplete without the references folder.
  • The README does not state a license explicitly beyond MIT attribution to the upstream project, and repository metadata reports no clear license.

Topics

#ai-agent#prompt-engineering#image-generation#cover-design#claude-code#skill

FAQ

What is gbro-cover-design?
An AI agent skill that turns an article into a 3:4 vertical cover image prompt for WeChat Official Accounts and Xiaohongshu, with optional face consistency. gbro-cover-design is a skill for AI coding agents such as Claude Code and Codex. You give the agent an article, and it asks a few rounds of questions about composition, title, reference images, expression, background color and fonts, then outputs a ready-to-use image generation prompt for a cover.
Is gbro-cover-design free to use? What license does it have?
gbro-cover-design is open source under the Other license. Check the license terms before using it in commercial products.
Is gbro-cover-design still maintained?
Updated within 6 months. The last commit to gbro-cover-design was on Jul 15, 2026.
What can I use gbro-cover-design for?
Creating WeChat Official Account article covers from written posts Making Xiaohongshu cover images with a consistent presenter's face Generating cover prompts for product screenshots or comparison posts
How do I install gbro-cover-design?
Clone the repository into your Claude Code skills folder: git clone https://github.com/pyang5166/gbro-cover-design.git ~/.claude/skills/gbro-cover-design Prepare a clear front-facing face photo at assets/my-face.png (optional, for face consistency) Send an article to the agent; it asks three rounds of questions and outputs a cover image prompt
Where can I get gbro-cover-design?
The source code and installation instructions are on GitHub: https://github.com/pyang5166/gbro-cover-design

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects