# Send SnapOG to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "snapog",
    "name": "SnapOG",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/beameasy/snapog",
    "canonicalUrl": "https://clawhub.ai/beameasy/snapog",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/snapog",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=snapog",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "snapog",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-09T04:51:18.913Z",
      "expiresAt": "2026-05-16T04:51:18.913Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=snapog",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=snapog",
        "contentDisposition": "attachment; filename=\"snapog-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "snapog"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/snapog"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/snapog",
    "downloadUrl": "https://openagent3.xyz/downloads/snapog",
    "agentUrl": "https://openagent3.xyz/skills/snapog/agent",
    "manifestUrl": "https://openagent3.xyz/skills/snapog/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/snapog/agent.md"
  }
}
```
## Documentation

### SnapOG — Social Image Generation

Generate OG images, social cards, and marketing visuals from professionally designed templates. Returns pixel-perfect PNGs in under 100ms.

API Base: https://api.snapog.dev

### Authentication

All generation requests require a Bearer token. The API key is read from the SNAPOG_API_KEY environment variable.

Authorization: Bearer $SNAPOG_API_KEY

Preview and template listing endpoints work without authentication.

### Available Templates

TemplateIDBest ForBlog Postblog-postBlog articles, tutorials, documentationAnnouncementannouncementProduct launches, updates, releasesStats CardstatsMetrics dashboards, quarterly resultsQuotequoteTestimonials, pull quotes, social sharesProduct CardproductSaaS products, pricing, featuresGitHub Repogithub-repoOpen source projects, repo cardsEventeventConferences, meetups, webinarsChangelogchangelogRelease notes, version updatesBrand Cardbrand-cardCompany pages, docs, marketingPhoto Herophoto-heroBlog headers, news, portfolios

### 1. List templates and discover parameters

curl https://api.snapog.dev/v1/templates

Returns all templates with their paramSchema (parameter names, types, required fields, defaults). Always call this first if the user hasn't specified a template.

### 2. Generate an image (POST)

Use this for downloading images or advanced options:

curl -X POST https://api.snapog.dev/v1/generate \\
  -H "Authorization: Bearer $SNAPOG_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "template": "blog-post",
    "params": {
      "title": "Building with MCP",
      "author": "Taylor",
      "tags": ["AI", "Tools"],
      "accentColor": "#6366f1"
    }
  }' \\
  --output og-image.png

POST body fields:

template (string, required) — template ID
params (object, required) — template parameters
width (number) — image width in pixels (default: 1200)
height (number) — image height in pixels (default: 630)
format ("png" | "svg" | "pdf") — output format (default: png)
fontFamily (string) — any Google Font family name
webhook_url (string) — URL to POST when generation completes

Save the response body directly to a .png file. The response Content-Type is image/png.

### 3. Generate via URL (GET)

Use this when the user needs a URL to embed in HTML meta tags, markdown, or anywhere an image URL is needed:

https://api.snapog.dev/v1/og/blog-post?title=Building+with+MCP&author=Taylor&tags=AI,Tools

This URL itself serves the image. Parameters are query strings. Requires Authorization header or a signed URL.

### 4. Preview a template (no auth needed)

curl https://api.snapog.dev/v1/preview/blog-post --output preview.png

Renders the template with its default parameters. Useful for showing the user what a template looks like before customizing.

### 5. Create a signed URL (for meta tags)

Signed URLs let you embed images in <meta> tags without exposing the API key:

curl -X POST https://api.snapog.dev/v1/sign \\
  -H "Authorization: Bearer $SNAPOG_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "template": "blog-post",
    "params": { "title": "My Post" },
    "expiresIn": 86400
  }'

Returns { "url": "https://api.snapog.dev/v1/og/blog-post?title=...&token=..." }. This URL works without authentication and can be placed directly in HTML:

<meta property="og:image" content="SIGNED_URL_HERE" />

### 6. Batch generate (multiple sizes)

Generate the same image in multiple sizes at once:

curl -X POST https://api.snapog.dev/v1/batch \\
  -H "Authorization: Bearer $SNAPOG_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "template": "blog-post",
    "params": { "title": "My Post" },
    "sizes": ["og", "twitter", "farcaster", "instagram-square"]
  }'

Size presets: og (1200x630), twitter (1200x628), farcaster (1200x800), instagram-square (1080x1080), instagram-story (1080x1920), linkedin (1200x627), facebook (1200x630), pinterest (1000x1500).

### Common Parameters

Most templates accept these shared parameters:

title (string, required) — main heading
accentColor (color) — theme color, e.g. #6366f1
logo (url) — logo image URL
fontFamily (string) — any Google Font, e.g. "Space Grotesk"

Each template has additional specific parameters. Call /v1/templates to see the full schema for any template.

### Tips

Choosing a template: Match the content type — blog-post for articles, announcement for launches, github-repo for OSS projects, stats for metrics, quote for testimonials.
Colors: Pass hex colors like #6366f1. Most templates support accentColor for theming.
Arrays: For tags and changes, pass as JSON arrays: ["tag1", "tag2"].
Stats: The stats template expects a JSON array: [{"label": "Users", "value": "10K"}].
Images: For logo, image, authorImage — pass a publicly accessible URL.
Output: Default is 1200x630 PNG (standard OG image size). Use width/height to customize.
Formats: Use "svg" for vector output, "pdf" for print-ready documents.

### Full API Docs

For the complete API reference as markdown (useful for deeper integration):

curl https://api.snapog.dev/v1/docs
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: beameasy
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-09T04:51:18.913Z
- Expires at: 2026-05-16T04:51:18.913Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/snapog)
- [Send to Agent page](https://openagent3.xyz/skills/snapog/agent)
- [JSON manifest](https://openagent3.xyz/skills/snapog/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/snapog/agent.md)
- [Download page](https://openagent3.xyz/downloads/snapog)