← Back to Skills Marketplace
vveerrgg

social-card

by vveerrgg · GitHub ↗ · v0.2.1 · MIT-0
cross-platform ✓ Security Clean
408
Downloads
0
Stars
1
Active Installs
7
Versions
Install in OpenClaw
/install social-card
Description
Generate social preview images (OG, Twitter, GitHub) with a fluent builder API. Single dependency — Pillow.
Usage Guidance
This package appears coherent and light-weight, but before installing: (1) confirm where the 'social-card' package will be fetched from (PyPI or your organization's registry) and verify the publisher/maintainer, (2) review the upstream package source on GitHub (the metadata points to Humanjava Enterprises) for unexpected network calls or telemetry, (3) if you run in a sensitive environment, install and test in a sandbox/virtualenv to ensure no unexpected side effects. If you need higher assurance, inspect the full package code published to the registry you will install from.
Capability Analysis
Type: OpenClaw Skill Name: social-card Version: 0.2.1 The social-card skill is a legitimate utility for generating social media preview images (OG, Twitter, GitHub) using the Pillow library. The documentation in SKILL.md and the example in examples/generate_og.py align with the stated purpose, and the package includes explicit security claims such as path traversal protection and input length limits. No evidence of malicious intent, data exfiltration, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description match the artifacts: SKILL.md documents a Pillow-based API for OG/Twitter/GitHub images, the example invokes SocialCard, and metadata lists Pillow as the dependency. Required binaries (pip) and the uv package install are proportional to installing a Python package.
Instruction Scope
The SKILL.md only instructs installing the package and using the library API; it does not direct the agent to read unrelated files, environment variables, or contact external endpoints at runtime. The example script simply renders a local image file.
Install Mechanism
Install uses an 'uv' package installer for package 'social-card' rather than a direct URL; this is reasonable for a registry install but you should confirm what 'uv' maps to in your environment and that the package comes from a trusted Python index/source. No download-from-IP or extract-from-arbitrary-URL patterns are present in the bundle.
Credentials
The skill declares no required environment variables or credentials and the code/instructions do not access secrets. Dependency on Pillow is appropriate for image generation.
Persistence & Privilege
The skill does not request always:true or any elevated persistence. It is user-invocable and allows normal autonomous invocation, which is expected for skills of this type.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install social-card
  3. After installation, invoke the skill by name or use /social-card
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.1
Security hardening: SecretStr, sanitized exceptions, input validation
v0.2.0
- Skill name changed from socialcard to social-card for consistency. - PyPI package and import instructions updated: now use social-card / social_card instead of socialcard. - All code examples revised to match the new import path and package name. - Links and metadata adjusted to reflect the new name throughout documentation. - No API or feature changes, only renaming and documentation updates.
v0.1.4
Entity-aware SKILL.md — visual presence and controlling perception
v0.1.3
Standardized SKILL.md template
v0.1.2
Security hardening: hex color validation, path traversal protection, format allowlist, dimension and text length limits
v0.1.1
Fix font fallback to SF Pro display, add skill_cards() method for structured cards with accent names and code lines
v0.1.0
Initial release of socialcard - Generate social card images for OG, Twitter, GitHub, and other platforms using a fluent builder API. - Choose from preset sizes and themes (dark, light, midnight). - Customize cards with title, subtitle, badges, tags, footer, accent color, grid, and glow effects. - Output images as PNG files or bytes. - Designed for easy integration and programmatic use.
Metadata
Slug social-card
Version 0.2.1
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 7
Frequently Asked Questions

What is social-card?

Generate social preview images (OG, Twitter, GitHub) with a fluent builder API. Single dependency — Pillow. It is an AI Agent Skill for Claude Code / OpenClaw, with 408 downloads so far.

How do I install social-card?

Run "/install social-card" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is social-card free?

Yes, social-card is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does social-card support?

social-card is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created social-card?

It is built and maintained by vveerrgg (@vveerrgg); the current version is v0.2.1.

💬 Comments