@opendirectory.dev/skills 0.1.0

package/registry.json

@@ -0,0 +1,226 @@
+[
+  {
+    "name": "blog-cover-image-cli",
+    "description": "A skill for blog-cover-image-cli",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/blog-cover-image-cli"
+  },
+  {
+    "name": "claude-md-generator",
+    "description": "Read the codebase. Write a CLAUDE.md that tells Claude exactly what it needs: no more, no less.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/claude-md-generator"
+  },
+  {
+    "name": "cook-the-blog",
+    "description": "Generate high-converting, deep-dive growth case studies in MDX format. Use this skill when asked to write a case study or blog post about a company's growth, tech stack, or product-led strategy. It handles the full pipeline (researching the company via Tavily, generating a 16:9 cover image, quality checking the draft, uploading assets to cloud storage, and pushing directly to the target repository).",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/cook-the-blog"
+  },
+  {
+    "name": "dependency-update-bot",
+    "description": "Scans your project for outdated npm, pip, Cargo, Go, or Ruby packages. Runs a CVE security audit. Fetches changelogs, summarizes breaking changes with Gemini, and opens one PR per risk group (patch, minor, major). Includes Diagnosis Mode for install conflicts. Use when asked to update dependencies, check for outdated packages, open dependency PRs, scan for package updates, audit for CVEs, or flag breaking changes in upgrades. Trigger when a user says \"check for outdated packages\", \"update my dependencies\", \"open PRs for dependency updates\", \"scan for CVEs\", or \"which packages need upgrading\".",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/dependency-update-bot"
+  },
+  {
+    "name": "docs-from-code",
+    "description": "Generates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas, and architecture. Uses graphify to build a knowledge graph first, then writes accurate docs from it. Use when asked to write docs, generate a README, document an API, update stale docs, create an API reference from code, add an architecture section, or document a project in any language. Trigger when a user says their docs are missing, outdated, or wants to document their codebase without writing it manually.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/docs-from-code"
+  },
+  {
+    "name": "explain-this-pr",
+    "description": "Takes a GitHub PR URL or the current branch and writes a plain-English explanation of what it does and why, then posts it as a PR comment. Use when asked to explain a PR, summarize a pull request, write a plain-English description of a PR, add a summary comment to a PR, or understand what a PR changes. Trigger when a user says \"explain this PR\", \"summarize this pull request\", \"what does this PR do\", \"add a comment explaining the PR\", or shares a GitHub PR URL and asks what it does.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/explain-this-pr"
+  },
+  {
+    "name": "google-trends-api-skills",
+    "description": "A skill for google-trends-api-skills",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/google-trends-api-skills"
+  },
+  {
+    "name": "hackernews-intel",
+    "description": "Monitors Hacker News for user-configured keywords, deduplicates against a local SQLite cache, and sends Slack alerts for new matching posts. Use when asked to monitor Hacker News for mentions, track keywords on HN, get alerts when something is posted about a topic on Hacker News, or set up HN keyword monitoring. Trigger when a user mentions Hacker News alerts, HN monitoring, keyword tracking on HN, or wants to know when a topic appears on Hacker News.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/hackernews-intel"
+  },
+  {
+    "name": "kill-the-standup",
+    "description": "Reads yesterday's Linear issues and GitHub commits for the authenticated user, formats a standup update (done / doing / blockers), and posts it to Slack. Use when asked to write a standup, generate a standup update, post to the standup channel, summarize yesterday's work, or automate the daily standup. Trigger when a user says \"write my standup\", \"post standup\", \"generate standup update\", \"what did I do yesterday\", or \"kill the standup\".",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/kill-the-standup"
+  },
+  {
+    "name": "linkedin-post-generator",
+    "description": "Converts any content, blog post URL, pasted article, GitHub PR description, or a description of something built, into a formatted LinkedIn post with proper hook, story arc, and formatting. Optionally posts directly to LinkedIn via Composio. Use when asked to write a LinkedIn post, turn a blog into a LinkedIn update, announce a shipped feature, share a case study on LinkedIn, or post something professionally. Trigger when a user mentions LinkedIn, wants to share content professionally, says \"post this to LinkedIn\", or asks to repurpose a blog/article/PR for social media.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/linkedin-post-generator"
+  },
+  {
+    "name": "llms-txt-generator",
+    "description": "Generates and maintains a standards-compliant llms.txt file for any website — either by crawling the live site OR by reading the website's codebase directly. Use this skill when asked to create an llms.txt, add AI discoverability to a site, improve GEO (Generative Engine Optimization), make a website readable by AI agents, generate an llms-full.txt, check if a site has llms.txt, or audit a site's AI readiness for generative search. Trigger this skill any time a user mentions llms.txt, AI discoverability, LLM site readability, or wants their site to appear in AI-generated answers. Also trigger when the user is inside a website codebase and asks about SEO, AI readiness, or content structure.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/llms-txt-generator"
+  },
+  {
+    "name": "luma-attendees-scraper",
+    "description": "A skill for luma-attendees-scraper",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/luma-attendees-scraper"
+  },
+  {
+    "name": "meeting-brief-generator",
+    "description": "Takes a company name and optional contact, runs targeted research via Tavily, synthesizes a 1-page pre-call brief with Gemini, and optionally saves it to Notion. Use when asked to prepare for a meeting, research a prospect before a call, generate a company brief, create a pre-call summary, or write a meeting prep doc. Trigger when a user says \"prepare me for a meeting with\", \"research this company before my call\", \"generate a meeting brief for\", \"I have a call with X tomorrow\", or \"create a prospect brief for\".",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/meeting-brief-generator"
+  },
+  {
+    "name": "meta-ads-skill",
+    "description": "A skill for meta-ads-skill",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/meta-ads-skill"
+  },
+  {
+    "name": "newsletter-digest",
+    "description": "Aggregates RSS feeds from the past week, synthesizes the top stories using Gemini, and publishes a newsletter digest to Ghost CMS. Optionally outputs formatted Markdown for Substack or any other platform. Use when asked to generate a newsletter, create a weekly digest, summarize RSS feeds, compile top stories for a newsletter, or publish a digest to Ghost. Trigger when a user mentions newsletter digest, weekly roundup, RSS digest, compile top stories, or publish to Ghost.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/newsletter-digest"
+  },
+  {
+    "name": "noise2blog",
+    "description": "Turns rough notes, bullet points, voice transcripts, or tweet dumps into a polished, publication-ready blog post. Optionally enriches with Tavily research to add supporting data and credibility to claims. Use when asked to write a blog post from notes, turn rough ideas into an article, expand bullet points into a full post, clean up a voice transcript into a blog, or repurpose a tweet thread as an article. Trigger when a user says \"write a blog post from this\", \"turn these notes into a post\", \"expand this into an article\", \"make this publishable\", \"I have rough notes write a blog\", or \"clean up this transcript\".",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/noise2blog"
+  },
+  {
+    "name": "outreach-sequence-builder",
+    "description": "Takes a buying signal and generates a personalized multi-channel outreach sequence across email, LinkedIn, and phone. Outputs 4-6 ready-to-send touchpoints over 10-14 days. Optionally drafts email touchpoints via Composio Gmail. Use when asked to write an outreach sequence, build a sales cadence, create a follow-up sequence, personalize outreach for a signal, or generate cold outreach messages. Trigger when a user says \"build an outreach sequence for\", \"write a sales cadence for\", \"create outreach based on this signal\", \"they just raised a round write me a sequence\", or \"generate personalized outreach for\".",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/outreach-sequence-builder"
+  },
+  {
+    "name": "position-me",
+    "description": "A skill for position-me",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/position-me"
+  },
+  {
+    "name": "pr-description-writer",
+    "description": "Read the current branch diff and write a complete GitHub pull request description. Create or update the PR with one command.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/pr-description-writer"
+  },
+  {
+    "name": "producthunt-launch-kit",
+    "description": "Generate every asset you need for a Product Hunt launch: listing copy, maker comment, and day-one social posts.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/producthunt-launch-kit"
+  },
+  {
+    "name": "reddit-icp-monitor",
+    "description": "Watches subreddits for people describing the exact problem you solve, scores their relevance to your ICP, and drafts a helpful non-spammy reply for each high-signal post. Use when asked to monitor Reddit for ICP signals, find prospects on Reddit, surface pain point posts, draft helpful Reddit replies, or scan subreddits for buying signals. Trigger when a user says \"monitor Reddit for my ICP\", \"find people on Reddit who need my product\", \"scan subreddits for pain points\", \"draft Reddit replies for prospects\", or \"check Reddit for buying signals\".",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/reddit-icp-monitor"
+  },
+  {
+    "name": "reddit-post-engine",
+    "description": "Writes and optionally posts a Reddit post for any subreddit, following that subreddit's specific culture and rules. Drafts a title, body, and first comment using the 90/10 rule. Uses Composio Reddit MCP for optional direct posting. Use when asked to post on Reddit, draft a Reddit post, share a project on Reddit, write a subreddit post, or launch something on Reddit. Trigger when a user says \"post this on Reddit\", \"write a Reddit post for r/...\", \"help me launch on Reddit\", \"draft something for Reddit\", or \"how do I share this on Reddit without getting banned\".",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/reddit-post-engine"
+  },
+  {
+    "name": "schema-markup-generator",
+    "description": "You are an SEO engineer specialising in structured data. Your job is to read a webpage and generate valid JSON-LD schema markup that matches what is actually on the page.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/schema-markup-generator"
+  },
+  {
+    "name": "show-hn-writer",
+    "description": "Draft a Show HN post title and body that follows the unwritten rules of Hacker News: specific, honest, first-person, no marketing.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/show-hn-writer"
+  },
+  {
+    "name": "stargazer",
+    "description": "A skill for stargazer",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/stargazer"
+  },
+  {
+    "name": "tweet-thread-from-blog",
+    "description": "Converts a blog post URL or article into a Twitter/X thread with a strong hook, one insight per tweet, and a CTA. Optionally posts the full thread to X via Composio using a reply chain. Use when asked to turn a blog post into a tweet thread, repurpose an article for Twitter, create a thread from a blog, write a Twitter thread about a topic, or share a blog post as a thread. Trigger when a user mentions Twitter thread, X thread, tweet thread, or wants to repurpose blog content for X/Twitter.",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/tweet-thread-from-blog"
+  },
+  {
+    "name": "twitter-GTM-find-skill",
+    "description": "A skill for twitter-GTM-find-skill",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/twitter-GTM-find-skill"
+  },
+  {
+    "name": "yc-intent-radar-skill",
+    "description": "A skill for yc-intent-radar-skill",
+    "tags": [],
+    "author": "OpenDirectory",
+    "version": "1.0.0",
+    "path": "skills/yc-intent-radar-skill"
+  }
+]

package/skills/blog-cover-image-cli/.github/workflows/publish.yml

@@ -0,0 +1,19 @@
+name: Publish to NPM
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm ci
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/skills/blog-cover-image-cli/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, Fariz Anjum
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/skills/blog-cover-image-cli/README.md

@@ -0,0 +1,126 @@
+# Blog Cover Image CLI
+
+A modern, AI-powered CLI tool designed to automatically generate high-converting, minimalist blog cover images and thumbnails using **Gemini 3.1 Flash Image Preview**. 
+
+
+<img width="1280" height="640" alt="blog-cover-image-cli-cover" src="https://github.com/user-attachments/assets/20336e16-a838-4281-9c48-af023fc84b4c" />
+
+
+It handles everything from fetching company logos to pixel-perfect typography integration, all from your terminal or directly via an AI Agent using the included OpenCode Skill.
+
+![Banner](https://img.shields.io/badge/AI-Gemini%203.1-blue)
+![Format](https://img.shields.io/badge/Format-16:9-success)
+![Platform](https://img.shields.io/badge/Platform-Node.js-green)
+
+---
+
+## Features
+- **Full AI Generation**: Uses `gemini-3.1-flash-image-preview` to generate the entire image.
+- **Smart Logo Fetching**: Pass a domain (like `vercel.com`) and the CLI automatically fetches the logo using `Brandfetch`, normalizes it to PNG via `sharp`, and injects it into the AI context.
+- **Aesthetic Control**: Bundled with `examples/` that automatically guide the model to produce clean, white-background, heavy-typography styles.
+- **Google Search Grounding**: The image generation is hooked into Google Search to pull real-time data if your title involves current events.
+- **Agent Ready**: Includes an OpenCode `SKILL.md` so your favorite AI agents can use this CLI autonomously.
+- **Self-Healing AI Generator**: Automatically validates generated images using Gemini Pro Vision to detect typos or layout issues, retrying up to 3 times with corrective feedback.
+- **Automated Publishing**: Built-in CI/CD workflow for seamless NPM releases via GitHub Actions.
+
+---
+
+## Installation
+
+You can install this globally via npm:
+
+```bash
+npm install -g blog-cover-image-cli
+```
+
+*(Note: Ensure you are using Node.js v18+)*
+
+---
+
+## Configuration
+
+The CLI securely stores your API key on your local machine using the `conf` package so you don't have to export it every time.
+
+```bash
+# 1. Set your Gemini API Key (Required for image generation)
+blog-cover-cli config set-key <YOUR_GEMINI_API_KEY>
+
+# 2. Set your Brandfetch Client ID (Required to fetch high-res logos)
+blog-cover-cli config set-brandfetch-id <YOUR_BRANDFETCH_CLIENT_ID>
+
+# Check your keys (masked)
+blog-cover-cli config get-key
+blog-cover-cli config get-brandfetch-id
+```
+
+*If you run the generate command without a key, a secure, interactive prompt will ask you for it.*
+
+---
+
+## Usage
+
+Generate a 16:9 cover image by providing a title and a domain name for the logo.
+
+```bash
+# Example 1: Cursor
+blog-cover-cli generate -t "Why Cursor is the Ultimate AI Code Editor" -l "cursor.com"
+
+# Example 2: Lovable
+blog-cover-cli generate -t "Building Apps in Minutes with Lovable" -l "lovable.dev"
+
+# Example 3: X (Twitter)
+blog-cover-cli generate -t "The Future of Real-time Information" -l "x.com"
+```
+
+### Options
+
+| Flag | Full Name | Description | Required | Default |
+|---|---|---|---|---|
+| `-t` | `--title` | The exact text to render on the cover | **Yes** | |
+| `-l` | `--logo` | The domain to fetch the logo from (e.g. `google.com`) | No | |
+| `-o` | `--output` | The output path for the PNG file | No | `./output/<auto-name>.png` |
+
+If you omit the `--output` flag, the CLI automatically creates an `output/` directory in your current path and names the file intelligently based on the logo domain or title (e.g., `output/cursor-cover.png`).
+
+---
+
+## For AI Agents (OpenCode Skill)
+
+This package includes a structured OpenCode skill! Agents can install this package and read the instructions in `agent-skill/blog-cover-generator/SKILL.md` to learn how to generate cover images for users autonomously. 
+
+**Workflow for Agents:**
+1. Execute `npx -p blog-cover-image-cli blog-cover-cli config set-key $KEY`
+2. Execute `npx -p blog-cover-image-cli blog-cover-cli generate -t "Title" -l "domain.com"`
+3. Return the generated image to the user.
+
+---
+
+## Self-Healing AI Generator
+
+The CLI features a built-in Automated QA (Critic) loop to ensure high-quality results. 
+
+1. **Generation**: The tool generates an image based on your title and logo.
+2. **Validation**: It uses `gemini-3.1-pro-preview` to OCR the generated image and check for typos, layout issues, or missing elements.
+3. **Self-Correction**: If the validation fails, the CLI automatically retries (up to 3 times), passing the specific "critical feedback" back to the generator to fix the errors.
+
+This ensures that common AI image generation issues, like misspelled words in typography, are caught and corrected before you even see the file.
+
+---
+
+## Automated Publishing (CI/CD)
+
+This repository includes a GitHub Action workflow for automated NPM publishing. To set this up for your fork:
+
+1. **Generate Token**: Go to [npmjs.com](https://www.npmjs.com/), navigate to **Access Tokens**, and generate a new "Automation" token.
+2. **Add Secret**: In your GitHub repository, go to **Settings > Secrets and variables > Actions**.
+3. **Save Secret**: Create a new repository secret named `NPM_TOKEN` and paste your token.
+
+The workflow will automatically publish a new version to NPM whenever you create a new GitHub Release.
+
+---
+
+## How it works under the hood
+1. **Logo Fetcher**: Hits `Brandfetch`, parses WebP/SVGs/AVIFs, and converts to strict PNGs.
+2. **Context Assembly**: Loads aesthetic examples from the `./examples` folder to ground the style.
+3. **Multimodal Prompting**: Assembles the exact text instructions, the visual examples, and the fetched logo into a single unified payload.
+4. **Google GenAI SDK**: Sends the payload with `tools: [{ googleSearch: {} }]` to the Gemini 3.1 Flash Image model.

package/skills/blog-cover-image-cli/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: blog-cover-image-cli
+description: A skill for blog-cover-image-cli
+author: OpenDirectory
+version: 1.0.0
+---
+

package/skills/blog-cover-image-cli/agent-skill/blog-cover-generator/README.md

@@ -0,0 +1,30 @@
+# Blog Cover Generator Skill
+
+This directory contains an OpenCode Skill for the `blog-cover-image-cli`. It allows AI agents to automatically generate blog cover images using the CLI tool.
+
+## Overview
+
+The skill provides a structured interface for agents to:
+1. Generate cover images with specific titles and subtitles.
+2. Use predefined themes (e.g., 'modern', 'minimal', 'tech').
+3. Handle output paths and file naming conventions.
+
+## Installation & Distribution
+
+### For Users
+To use this skill in your OpenCode environment:
+
+1. **Direct Path**: Point your agent to this directory path in your configuration.
+2. **Skill Package**: Zip the contents of this folder (including `SKILL.md`) into a `.skill` file.
+   ```bash
+   zip -r blog-cover-generator.skill agent-skill/blog-cover-generator/*
+   ```
+3. **Import**: Use the OpenCode skill import command to add it to your library.
+
+### For Developers
+- `SKILL.md`: This is the core definition file used by the AI agent to understand its capabilities. **Do not modify its structure unless you are updating the skill's logic.**
+- `README.md`: This file (you are reading it) is for human developers and users to understand deployment.
+
+## Requirements
+- `blog-cover-image-cli` must be installed and available in the system PATH.
+- Node.js environment for running the CLI.

package/skills/blog-cover-image-cli/agent-skill/blog-cover-generator/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: blog-cover-generator
+description: Use when the user asks to generate a blog cover image, thumbnail, or article header. Automatically uses modern typography, brand logos, and Google Search grounding to create beautiful 16:9 images with Gemini 3.1 Flash Image Preview.
+---
+
+# Blog Cover Generator Skill
+
+This skill provides AI agents with the ability to generate stunning, minimalist, technical blog cover images using the `blog-cover-image-cli`. The CLI leverages Gemini 3.1 Flash Image Preview, automatically fetches brand logos from domains, uses local aesthetic reference images, and employs Google Search grounding to inject real-time context.
+
+## Setup & Configuration
+
+**Agent Pre-requisites:**
+Before using this tool, verify it is installed. If `blog-cover-cli --help` fails, install it globally:
+```bash
+npm install -g blog-cover-image-cli
+```
+
+If the user wants you to generate an image and you haven't set up the API key yet, you must first configure the CLI using a Gemini API Key. The CLI stores this securely via the `conf` package.
+
+```bash
+# 1. Set your Gemini API Key (Required for image generation)
+npx -p blog-cover-image-cli blog-cover-cli config set-key <YOUR_GEMINI_API_KEY>
+
+# 2. Set your Brandfetch Client ID (Required to fetch high-res logos)
+npx -p blog-cover-image-cli blog-cover-cli config set-brandfetch-id <YOUR_BRANDFETCH_CLIENT_ID>
+
+# Check your keys (masked)
+npx -p blog-cover-image-cli blog-cover-cli config get-key
+npx -p blog-cover-image-cli blog-cover-cli config get-brandfetch-id
+```
+
+## Usage: Generating an Image
+
+When a user asks for a cover image (e.g., "Create a cover image for my blog about Vercel v0"), you should use the `generate` command.
+
+```bash
+npx -p blog-cover-image-cli blog-cover-cli generate -t "The Title of the Blog Post" -l "example.com"
+```
+
+### Arguments
+- `-t, --title <text>`: **(Required)** The title text to display on the cover image. Do not use excessively long titles (keep it under 3 lines of text visually).
+- `-l, --logo <domain>`: **(Optional but recommended)** The domain to fetch the brand logo from (e.g., `vercel.com`, `google.com`, `cursor.com`). The CLI automatically converts WebP/SVG/AVIF to PNG for compatibility.
+- `-o, --output <path>`: **(Optional)** The file path where the generated image will be saved. If omitted, the CLI automatically saves it to an `output/` directory in the current working folder (e.g., `./output/vercel-cover.png`).
+
+### Examples
+
+**Example 1: Cursor**
+```bash
+npx -p blog-cover-image-cli blog-cover-cli generate -t "Why Cursor is the Ultimate AI Code Editor" -l "cursor.com"
+```
+
+**Example 2: Lovable**
+```bash
+npx -p blog-cover-image-cli blog-cover-cli generate -t "Building Apps in Minutes with Lovable" -l "lovable.dev"
+```
+
+**Example 3: Custom Output Path**
+```bash
+npx -p blog-cover-image-cli blog-cover-cli generate -t "Mastering React in 2026" -l "reactjs.org" -o "./assets/react-cover.png"
+```
+
+## How It Works Under the Hood
+As an agent, you should know what the CLI is doing so you can inform the user:
+1. **Logo Fetching**: It fetches logos from `Brandfetch` and processes them via `sharp`.
+2. **References**: It loads curated reference images from its `examples/` directory to ensure the output is always a clean, minimalist white background with bold typography.
+3. **Grounding**: It has `googleSearch` tools enabled, meaning if the title relates to a recent event, Gemini can look it up before generating the image.
+4. **Text Enforcement**: It forces Gemini to output the exact title string using typographic placement rules.
+
+## Edge Cases / Troubleshooting
+- **No API Key Error**: If you see an API key error, run the `config set-key` command.
+- **Logo Fetch Warning**: If the CLI says `Warning: Could not fetch logo`, it will still generate the image but without the logo. You do not need to crash or stop.
+- **Strict Modality Limits**: Because it uses Gemini's experimental image models, generation may occasionally fail due to strict safety filters. If this happens, notify the user.