Agnes AI Skill is a free multimodal Agent Skill for Codex, Claude Code,
OpenClaw, Claude Desktop, Hermes, WorkBuddy, Cherry Studio, Opencode, and
similar AI agent tools. It helps agents use Agnes 2.0 APIs for text generation,
image generation, image editing, text-to-video, image-to-video, and API
integration through a single root SKILL.md.
Use this Agnes skill when you want an Agnes AI skill, image generation skill, video generation skill, text to image workflow, image to video workflow, free AI API workflow, or free AI model workflow that fits Codex skills, Claude Code skills, and OpenClaw skills.
中文：Agnes AI 免费文本 / 生图 / 图片编辑 / 生视频 Agent Skill，支持 Codex、 Claude Code、OpenClaw、Claude Desktop、Hermes、WorkBuddy、Cherry Studio、 Opencode 等工具。
Install the skill with a repository-aware skills installer:
npx skills add jomeswang/agnes-ai-skill -gOr copy this sentence to your agent:
Please read and install Agnes AI Skill: https://github.com/jomeswang/agnes-ai-skill
After installation, create an Agnes API key at
platform.agnes-ai.com/settings/apiKeys
and configure it as AGNES_API_KEY. Then tell the agent generate an image,
generate a video, edit this image, or integrate Agnes API, and it can
choose the proper Agnes model and execution path automatically.
This skill helps agents:
- set up Agnes AI and persist an
AGNES_API_KEY - use
agnes-2.0-flashfor chat, coding, streaming, and tool calling - use
agnes-image-2.0-flashandagnes-image-2.1-flashfor AI image generation, image editing, and image-to-image workflows - use
agnes-video-v2.0for text-to-video, image-to-video, and async video generation - prefer the companion
agnes-ai-clifor live requests
Compatible tools: Codex, Claude Code, Claude Desktop, OpenClaw, Hermes, WorkBuddy, Cherry Studio, Opencode, Kimi Work, and other Agent Skills / SKILL.md-compatible environments.
Agnes 2.0 full-modal model APIs are officially open for free global calls.
- No fixed end date, full-modal access, and free API calls within RPM 20
- Register on the official platform, create a key, and call directly
- Text, image, and video are all supported
- Models keep upgrading while free access is maintained
Official platform: https://platform.agnes-ai.com
The live official model docs also include pricing sections. For cost, quota, or commercial use, check the current official docs first.
This repository packages a single root SKILL.md so coding agents can quickly:
- get and persist an Agnes API key
- use
agnes-2.0-flashfor chat, coding, streaming, and tool calling - use
agnes-image-2.0-flashandagnes-image-2.1-flashfor image generation and editing - use
agnes-video-v2.0for asynchronous video generation and polling
It is designed for the exact pitch that makes Agnes easy to try:
- one provider for text, image, and video
- public free-access positioning that lowers experimentation friction
- agent, creative, and prototyping workflows where repeated calls matter
The skill stays intentionally lightweight. It teaches agents how to make Agnes API calls successfully without copying the full docs into the repository.
With a repository-aware skills installer:
npx skills add jomeswang/agnes-ai-skill -gBecause this repository uses a single root SKILL.md, installers that support
repository-root skills can discover it directly.
This repository has been validated with:
npx skills add jomeswang/agnes-ai-skill --list
npx skills add jomeswang/agnes-ai-skill --agent codex --yesThe repository is discoverable as a single root-level skill named
agnes-ai-skill.
The published companion execution layer is:
- npm:
agnes-ai-cli - GitHub:
jomeswang/agnes-ai-cli
Install it when you want stable commands instead of hand-written requests:
npm install -g agnes-ai-cli
agnes --helpUse the repository skill with these defaults:
agnes-2.0-flash- chat, coding, streaming, tool calling, and agent workflows
- default when
text chatruns without--model
agnes-image-2.1-flash- default for new text-to-image and image-to-image work
- strongest fit for denser layouts, richer detail, and better semantic alignment
- default when
image text2img,image img2img, orimage composeruns without--model
agnes-image-2.0-flash- better when you explicitly need its documented
tags: ["img2img"]flow, multi-image composition, orseed-based reproducibility
- better when you explicitly need its documented
agnes-video-v2.0- text-to-video, image-to-video, multi-image guided video, keyframes, and asynchronous polling
- current default when any
videogenerate command runs without--model
The official docs also give each model fairly different best practices:
- Image 2.1 leans into high-information-density visuals and composition preservation
- Image 2.0 is more explicit about edit/composition workflows, response fields, and OpenAI Images-style compatibility
- Video 2.0 is task-based and documents multiple generation modes, task states, result polling, and frame-count constraints
The strongest outside prompt libraries all do the same three things well:
lead with a preview, keep the prompt compact enough to scan, and organize
examples by outcome instead of by raw API parameter lists. This gallery follows
that pattern with 9 compact cases regenerated with Agnes on June 1, 2026. The
image prompts were tightened toward the shorter, more editorial style seen in
awesome-gpt-image-2, the video prompts were rebuilt around ad-film,
animation, and cinematic beats inspired by awesome-seedance, and the HTML
cases were regenerated as brighter, more public-facing product experiences.
agnes-image-2.1-flash
| Preview | Case | Model | Prompt recipe |
|---|---|---|---|
 |
Y2K golden hour portrait | agnes-image-2.1-flash |
Candid blonde portrait, baby-pink velour tracksuit, butterfly clips, glossy lips, palm trees, warm golden hour, real skin texture, soft film grain. |
 |
Pencil editorial fashion | agnes-image-2.1-flash |
Minimal monochrome pencil-sketch fashion portrait, round sunglasses, rolled white shirt, denim overalls, combat boots, burnt-orange circle, indie magazine composition. |
 |
Brand-envelope perfume ad | agnes-image-2.1-flash |
Dusty-rose brand world, travertine pedestal, translucent perfume bottle, matte cream paper curves, warm studio light, quiet-luxury beauty campaign. |
agnes-video-v2.0
| Preview | Case | Model | Prompt recipe |
|---|---|---|---|
 |
Perfume ad film | agnes-video-v2.0 |
Ten-second luxury commercial with macro bottle details, orbiting reflections, atomizer tension beat, champagne-gold glow, and a final hero reveal built for premium beauty launch pages. |
 |
Mechanical otter animation short | agnes-video-v2.0 |
Ten-second animated short: fearless otter pilot bursts through a clockwork engine room, expressive face, hand-painted adventure energy, cinematic action timing, family-film clarity. |
 |
Desert cinematic film scene | agnes-video-v2.0 |
Ten-second widescreen film moment: lone traveler crosses a dust-heavy desert test site, sculptural machine in the background, restrained grading, prestige sci-fi drama mood. |
agnes-2.0-flash
Single-file HTML demos generated from Agnes text prompts and saved in
examples/apps.
| Preview | Case | Model | Prompt recipe |
|---|---|---|---|
 |
Agnes AI official-style homepage | agnes-2.0-flash |
Fresh one-file official product homepage for Agnes AI, bright premium palette, strong platform nav, enterprise hero copy, high-clarity call-to-action hierarchy. |
 |
Lantern Sprint mini-game | agnes-2.0-flash |
Fresh browser mini-game with bright festival palette, instant start state, arcade score loop, keyboard and touch controls, polished one-file mobile-friendly presentation. |
 |
Golden Hour Stories promo page | agnes-2.0-flash |
Fresh campaign landing page for Agnes image and video outputs, soft daylight tones, editorial serif hero, luxury launch framing, clear promotional storytelling. |
Agnes is most interesting when one workflow needs all three layers together:
- text for planning, coding, prompting, and agent loops
- image for marketing, e-commerce, and creative visual generation
- video for storyboards, product demos, motion tests, and short-form content
The supplied public writeups consistently frame Agnes as useful for:
- rapid AI product prototyping
- high-frequency agent workflows where repeated model calls matter
- frontend or HTML generation
- marketing and e-commerce creatives
- ad, storyboard, and cinematic short-video iteration
This skill turns that platform surface into one reusable installation target for Codex and other SKILL.md-compatible agents, with guidance that helps the agent choose the right Agnes model and authenticate cleanly.
- Platform and auth flow from the Agnes quickstart docs
- API key creation via the Agnes platform settings page
- Persistent
AGNES_API_KEYsetup for future sessions - OpenAI-style request patterns for text and image endpoints
- Asynchronous task workflow for video generation
- Practical use cases reinforced by the supplied public writeups
- Agnes is unusually compelling when one platform covers text, image, and video together.
- The strongest growth hook in its public messaging is not just quality, but the promise of lower-cost or broadly free experimentation.
- That matters most for agents, prototypes, content pipelines, and repeated A/B-style creative iteration.
- In practice, treat this as a major adoption advantage, while still verifying the current live billing terms before promising zero cost.
| Model | Best for | Endpoint | Required fields | Special fields / caveats |
|---|---|---|---|---|
agnes-2.0-flash |
chat, coding, streaming, tool calling, agent loops | /v1/chat/completions |
model, messages |
OpenAI-style tools, tool_choice, stream |
agnes-image-2.1-flash |
new text-to-image, image-to-image, denser layouts, composition-preserving edits | /v1/images/generations |
model, prompt |
size, extra_body.image, extra_body.response_format; strongest fit for high-information-density scenes |
agnes-image-2.0-flash |
edit-heavy workflows, multi-image composition, compatibility-style image flows | /v1/images/generations |
model, prompt |
often pair with tags: ["img2img"]; supports seed, extra_body.image, extra_body.response_format |
agnes-video-v2.0 |
text-to-video, image-to-video, multi-image guided video, keyframes | create: /v1/videos; poll: /agnesapi?video_id={video_id} |
model, prompt |
asynchronous task workflow; create returns taskId and videoId; use videoId for polling, while older taskId polling remains legacy-compatible |
- The official Image 2.0, Image 2.1, and Video 2.0 docs currently include pricing sections.
- Some public writeups still frame Agnes as broadly free or indefinitely free.
- The Video 2.0 docs are also operationally time-sensitive: the same page can mix concrete price figures with "pricing to be announced" style notes.
- Treat all pricing, free-tier, and billing claims as live-doc verified only.
- The skill checks for
AGNES_API_KEYbefore live requests - If the key is missing, it points the user to the official Agnes quickstart and API key page instead of guessing
- If the user provides a key and wants it remembered, the skill persists
AGNES_API_KEYin the correct shell rc file for future sessions - Live payloads and response handling stay grounded in Agnes docs and real API behavior, not only in marketing copy
Copy this repository into any standard skills location supported by your agent, for example:
- Codex:
~/.codex/skills/agnes-ai-skill - Claude Code:
~/.claude/skills/agnes-ai-skill - Cursor:
~/.cursor/skills/agnes-ai-skill
- How to detect missing Agnes auth before making live calls
- How to guide the user to create an API key
- How to persist
AGNES_API_KEYin shell startup files for future sessions - How to choose between Agnes text, image, and video models
- How to make the smallest reliable live request first
- How to poll Agnes video tasks until they complete
- GitHub repository: jomeswang/agnes-ai-skill
- Public repository topics:
agent-skills,ai-agent-skills,codex-skills,multimodal-ai,agnes-ai - These topics improve discoverability across GitHub-linked skill directories and crawler-based ecosystems.
- The repository is ready for third-party skill hub submission, including
ClawHub-style marketplaces that read
SKILL.mdmetadata.
- Agnes quickstart: https://agnes-ai.com/doc/quickstart
- API key settings: https://platform.agnes-ai.com/settings/apiKeys
- Text model: https://agnes-ai.com/doc/agnes-20-flash
- Image 2.0: https://agnes-ai.com/doc/agnes-image-20-flash
- Image 2.1: https://agnes-ai.com/doc/agnes-image-21-flash
- Video: https://agnes-ai.com/doc/agnes-video-v20
- The public materials supplied with this repository describe Agnes as offering free access to its core multimodal APIs as of June 1, 2026. Treat pricing and promotion details as time-sensitive and verify them in the platform if cost matters.
- ClawHub publishing requires a separate ClawHub login or publish token plus a GitHub OAuth grant.
- This repository is released under the MIT License.