Agent skill

Agnes Free Image

by kangarooking in kangarooking/agnes-free-model-skills

Generate free images with Agnes Image 2.1 Flash through the Agnes API, including text-to-image, image-to-image, high-density visual prompts, URL results, and local downloads.

MITAuto-check passedMedia & Creative

Install Agnes Free Image

skills CLI
$ npx skills add kangarooking/agnes-free-model-skills --skill agnes-free-image -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kangarooking/agnes-free-model-skills agnes-free-image --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kangarooking/agnes-free-model-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agnes-free-image .claude/skills/agnes-free-image && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agnes-free-image
GitHub stars
199
Token cost
~687 tokens
SKILL.md length
199 words
Files
4 (incl. scripts, references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Generate free images with Agnes Image 2.1 Flash through the Agnes API, including text-to-image, image-to-image, high-density visual prompts, URL results, and local downloads.

  • Works in 5 steps: Decide whether the request is… → Turn vague visual requests into a… → Use scripts/agnes_image.py generate.… → …
  • The user asks for 免费图片
  • SKILL.md covers Credential Rule, Quick Start, Prompt Pattern and Workflow, plus 2 more sections
  • Runs Python scripts from its folder; calls python3; reaches apihub.agnes-ai.com; needs AGNES_TOKEN and AGNES_API_KEY

What it does

Agnes Free Image is an agent skill from kangarooking/agnes-free-model-skills. Generate free images with Agnes Image 2.1 Flash through the Agnes API, including text-to-image, image-to-image, high-density visual prompts, URL results, and local downloads. Use when the user asks for 免费图片, 免费的图片模型, free image API, Agnes image, Agnes Image 2.1 Flash, free AI image generation, image-to-image via Agnes, or wants a free image model Agent skill.

Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/api.md` and `scripts/agnes_image.py`).

It sits in Media & Creative, covering Image generation. The repository describes itself as: Agnes AI 免费文本、图片、视频模型的 Codex/Agent Skills. The licence is MIT.

When your agent uses it

  • The user asks for 免费图片
  • Agnes Image 2.1 Flash
  • Free AI image generation
  • Image-to-image via Agnes

Example prompts

  • “/agnes-free-image”

Requirements

  • Python 3
  • A credential in AGNES_API_KEY
  • A credential in AGNES_TOKEN

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Decide whether the request is text-to-image or image-to-image.
  2. Turn vague visual requests into a concrete prompt with subject, environment, style, lighting, composition, and detail level.
  3. Use scripts/agnes_image.py generate. Prefer --dry-run first for complex prompts or reference images.
  4. Save returned image URLs locally with --output-dir when the response includes downloadable URLs.
  5. Read references/api.md when the raw response shape or advanced parameters matter.

What it can do on your machine

Read from SKILL.md and the folder at commit f5cb579. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • apihub.agnes-ai.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AGNES_TOKEN
    • AGNES_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agnes Free Image loads about 687 tokens when it runs, and up to ~1.4k if it reads all its reference files. Until then it costs about 95 tokens; SKILL.md has 199 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~687
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from kangarooking/agnes-free-model-skills at commit f5cb579, republished under its MIT licence (© kangarooking). 199 words, ~687 tokens.

Download SKILL.mdSave it as .claude/skills/agnes-free-image/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
agnes-free-image
description
Generate free images with Agnes Image 2.1 Flash through the Agnes API, including text-to-image, image-to-image, high-density visual prompts, URL results, and local downloads. Use when the user asks for 免费图片, 免费的图片模型, free image API, Agnes image, Agnes Image 2.1 Flash, free AI image generation, image-to-image via Agnes, or wants a free image model Agent skill.

Agnes Free Image

Use this skill to generate or transform images with agnes-image-2.1-flash.

Credential Rule

Read the API key from the environment. Do not hardcode keys in prompts, scripts, skill files, commits, or shell history.

Preferred variable:

bash
export AGNES_API_KEY="..."

The helper also accepts AGNES_TOKEN as a fallback.

Quick Start

Text-to-image:

bash
python3 scripts/agnes_image.py generate \
  --prompt "A luminous floating city above a misty canyon at sunrise, cinematic realism" \
  --size 1024x768 \
  --output-dir ./outputs/agnes-free-image

Image-to-image with a public image URL:

bash
python3 scripts/agnes_image.py generate \
  --prompt "Transform the scene into a rain-soaked cyberpunk night while preserving the composition" \
  --image-url "https://example.com/input.png" \
  --size 1024x768 \
  --output-dir ./outputs/agnes-free-image

Validate the request shape without calling the API:

bash
python3 scripts/agnes_image.py generate \
  --prompt "A detailed AI workflow dashboard poster, clean editorial style" \
  --size 1024x1024 \
  --dry-run

Prompt Pattern

Use this structure for text-to-image:

text
[Subject] + [Scene / Environment] + [Style] + [Lighting] + [Composition] + [Quality Requirements]

For image-to-image, say both what should change and what should remain unchanged.

Workflow

  1. Decide whether the request is text-to-image or image-to-image.
  2. Turn vague visual requests into a concrete prompt with subject, environment, style, lighting, composition, and detail level.
  3. Use scripts/agnes_image.py generate. Prefer --dry-run first for complex prompts or reference images.
  4. Save returned image URLs locally with --output-dir when the response includes downloadable URLs.
  5. Read references/api.md when the raw response shape or advanced parameters matter.

Notes

  • Endpoint: POST https://apihub.agnes-ai.com/v1/images/generations
  • Model: agnes-image-2.1-flash
  • Default size in the helper is 1024x768.
  • For image-to-image, input images must be URL-accessible and are sent under extra_body.image.
  • The helper asks for URL responses with extra_body.response_format: "url".

Reference

Read references/api.md when you need request fields, response handling, or prompt examples from the source docs.

© kangarooking, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in agnes-free-image of kangarooking/agnes-free-model-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/api.md
  • scripts/agnes_image.py

Open the folder on GitHubat commit f5cb579

Compare with similar skills

Agnes Free Image next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agnes Free Image compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agnes Free Image this skillkangarooking/agnes-free-model-skills199—~687Automated safety check: PassMIT
AI Image Generation and Editingzhayujie/CowAgent47k—~1.3kAutomated safety check: PassMIT
Structured Image Generationbytedance/deer-flow84k4 repos~2.9kAutomated safety check: PassMIT
Canghe Comicfreestylefly/canghe-skills4618 repos~3.2kAutomated safety check: PassNone
Generate Imageynulihao/AgentSkillOS61710 repos~1.7kAutomated safety check: NotesNone
GPT Image Generation CLIwuyoscar/GPT-Image2-Skill5.7k—~2.5kAutomated safety check: NotesMIT

Similar skills

  • Generates or edits images from text prompts through a Python script that picks an image backend based on which API keys are configured.

    47k GitHub stars~1.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Structured Image Generation

    bytedance/deer-flow

    Turns an image request into a structured JSON prompt and runs a bundled Python script to generate the picture, optionally guided by reference images.

    84k GitHub starsUsed in 4 repos~2.9k tokens
    Media & CreativeAuto-check passed
  • Canghe Comic

    freestylefly/canghe-skills

    Knowledge comic creator supporting multiple art styles and tones.

    461 GitHub starsUsed in 8 repos~3.2k tokens
    Media & CreativeAuto-check passed
  • Generate Image

    ynulihao/AgentSkillOS

    Generate or edit images using AI models (FLUX, Gemini). An agent skill from ynulihao/AgentSkillOS.

    617 GitHub starsUsed in 10 repos~1.7k tokens
    Media & CreativeAuto-check: notes
  • GPT Image Generation CLI

    wuyoscar/GPT-Image2-Skill

    Generates and edits images with GPT Image 2 or 2.5 through a packaged CLI and a prompt gallery, after settling which model fits the request.

    5.7k GitHub stars~2.5k tokensUpdated 9 days ago
    Media & CreativeAuto-check: notes
  • Minimal Zine Poster Generator

    LiamGvchi/gc-minimal-zine-poster

    Creates or analyzes quiet, paper-texture zine posters with big negative space, one color accent and experimental type, returning an image prompt and the generated poster.

    7.3k GitHub stars~2.9k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed

More from kangarooking/agnes-free-model-skills

  • Agnes Free Text

    kangarooking/agnes-free-model-skills

    Call the free Agnes text model API for chat completions, streaming answers, coding help, tool-calling experiments, and OpenAI-compatible text generation.

    199 GitHub stars~630 tokensUpdated 4 mo ago
    Auto-check passed
  • Agnes Free Video

    kangarooking/agnes-free-model-skills

    Create free Agnes video generation tasks and retrieve video results through Agnes-Video-V2.0, including text-to-video, image-to-video, multi-image video, keyframe animation, async polling, and video…

    199 GitHub stars~754 tokensUpdated 4 mo ago
    Auto-check passed

Questions about Agnes Free Image

What does Agnes Free Image do?

Generate free images with Agnes Image 2.1 Flash through the Agnes API, including text-to-image, image-to-image, high-density visual prompts, URL results, and local downloads. Agnes Free Image is an agent skill from kangarooking/agnes-free-model-skills.1 Flash through the Agnes API, including text-to-image, image-to-image, high-density visual prompts, URL results, and local downloads.

When should I use Agnes Free Image?

Agnes Free Image fits situations like: the user asks for 免费图片; agnes Image 2.1 Flash; free AI image generation; image-to-image via Agnes.

How do I install Agnes Free Image in Claude Code?

Run `npx skills add kangarooking/agnes-free-model-skills --skill agnes-free-image -a claude-code`. Or copy the skill folder (agnes-free-image in kangarooking/agnes-free-model-skills) into .claude/skills/agnes-free-image in your project. Claude Code loads it when a task matches its description.

How do I install Agnes Free Image in Codex?

Run `npx skills add kangarooking/agnes-free-model-skills --skill agnes-free-image -a codex`. Or copy the skill folder (agnes-free-image in kangarooking/agnes-free-model-skills) into .agents/skills/agnes-free-image in your project. Codex loads it when a task matches its description.

Can I use Agnes Free Image in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kangarooking/agnes-free-model-skills --skill agnes-free-image -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agnes-free-image, .gemini/skills/agnes-free-image, .github/skills/agnes-free-image and .opencode/skills/agnes-free-image in your project.

What does Agnes Free Image need to run?

Going by SKILL.md and its folder, Agnes Free Image needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named AGNES_TOKEN and AGNES_API_KEY. Our summary lists: Python 3; A credential in AGNES_API_KEY; A credential in AGNES_TOKEN.

Does Agnes Free Image access the network?

SKILL.md names 1 domain. In commands or code: apihub.agnes-ai.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Agnes Free Image safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Agnes Free Image use?

Agnes Free Image is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agnes Free Image use?

About 687 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 670 tokens, read only when the agent opens those files.

What are the alternatives to Agnes Free Image?

Skills that share tags, products or a category with Agnes Free Image: AI Image Generation and Editing (zhayujie/CowAgent, 47k stars), Structured Image Generation (bytedance/deer-flow, 84k stars), Canghe Comic (freestylefly/canghe-skills, 461 stars) and Generate Image (ynulihao/AgentSkillOS, 617 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agnes Free Image?

kangarooking (a GitHub user) maintains it in kangarooking/agnes-free-model-skills, which has 199 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on June 1, 2026.

Source: kangarooking/agnes-free-model-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.