Skill: geeklord/runware-image (version 1.0.0)

--- name: runware-image version: 1.0.0 author: Shobhit Kumar Prabhakar description: Generate high-quality images on-demand via the Runware.ai API. This skill is the default image generator. Use it whenever the user asks to "generate an image", "create a picture", "draw something", or explicitly mentions Runware. It handles text-to-image generation with comprehensive safety checks. --- Runware Image Skill Purpose Provide a secure, documented, and testable integration for generating images via the Runware.ai Image Inference API. IMPORTANT INSTRUCTIONS FOR AGENT: 1. **Do NOT ask the user for the RUNWARE_API_KEY.** The script automatically loads it from the `.env` file in the skill directory. 2. **Do NOT ask clarifying questions** (style, size, etc.) unless the user's prompt is extremely vague. For requests like "generate a man on the moon", use your best judgment for the prompt and run the script immediately. 3. **Execute the script directly.** Do not propose it. What it does - Send text-to-image tasks to Runware's task API (imageInference). - Support synchronous (sync) responses returning base64 image data and asynchronous workflows (webhook/polling) if required. - Save generated images to the user's Downloads folder by default. - Validate prompts for common safety issues (e.g., minors) before sending requests. Included files - scripts/generate_image.py — Primary CLI script (Python 3.8+). Reads RUNWARE_API_KEY from environment, supports sync mode, size/format options, and output filename. - skill-config.json — default parameters (no secrets). Contains default_size and default_format. - SKILL.md — this metadata and usage file. Security & secrets - DO NOT commit API keys. This skill requires RUNWARE_API_KEY to be provided via the environment when executed (export RUNWARE_API_KEY=...) or via a secure secret manager. - The packaged version uploaded to ClawHub must not include any API keys. Before publishing, confirm skill-config.json contains NO sensitive values. - The script performs simple prompt filtering; users should still follow platform content policies. Usage (CLI) 1. Install dependencies - pip install -r requirements.txt (The script uses requests and python-dotenv; keep requirements minimal.) 2. Set your Runware API key. You can create a `.env` file in the skill directory: `RUNWARE_API_KEY=your_key_here` Or set it in your environment: $env:RUNWARE_API_KEY = "<YOUR_KEY>" 3. Run the script (sync mode): python scripts/generate_image.py --prompt "A photorealistic adult portrait (age 25)" --sync --outfile "my_image.png" 4. For non-sync workflows, omit --sync and implement webhook handling or polling as described in the Runware docs. Configuration - skill-config.json fields: - default_size: e.g. "1024x1024" - default_format: e.g. "png" Packaging & publishing (ClawHub) Checklist before publishing: - Remove any plaintext API keys from skill-config.json (already removed). - Add a short one-line license (MIT recommended) in LICENSE file. - Add a small tests/ directory with a smoke test that verifies parsing logic and saved file behavior using temporary directories. Tests may require RUNWARE_API_KEY for live integration or can be skipped in CI if secrets are not provided. - Ensure SKILL.md frontmatter (name + description) is accurate and includes trigger phrases. - Provide example prompts and recommended safety guidance in SKILL.md. Suggested repository structure runware-image/ ├── SKILL.md ├── skill-config.json ├── scripts/ │ └── generate_image.py ├── requirements.txt ├── LICENSE └── tests/ └── test_generate_image.py Tests and CI - Include a minimal pytest-based test that stubs requests.post and verifies parsing logic and saved file behavior using temporary directories. - Add GitHub Actions workflow (optional) that runs tests on push. Contribution & support - Include a short CONTRIBUTING.md describing how to run tests, where to report issues, and how to add features (e.g., support for ControlNet, LoRA, or custom models). - Provide an examples/ folder with 2–3 example prompts and expected CLI commands. Licensing - Recommend MIT license for public sharing unless you prefer another OSI-approved license. Privacy and usage notes - Make it explicit that the skill does not collect or store user prompts or keys on the server. All generation is performed using the user's Runware account. - Recommend users review Runware's terms and ensure they have rights to generate/host the requested imagery.

path: requirements.txt
content: requests>=2.28.0
python-dotenv
pytest>=7.0.0


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)