Agnes AI Skill

Default language: English. Chinese documentation is available in README.zh-CN.md.

This npm package distributes the agnes-ai-media Codex skill for Agnes AI image and video generation workflows.

Install

Install directly into your Codex skills directory:

npx agnes-ai-skill

Install to a custom skills directory:

npx agnes-ai-skill --path /path/to/skills

You can also install manually by copying the included agnes-ai-media folder into ~/.codex/skills.

Use

Invoke the skill in Codex:

Use $agnes-ai-media to create a 5-second product video from this image.

The skill covers:

• Image generation with agnes-image-2.1-flash.
• Image editing or transformation from public URLs or Data URI Base64 input.
• Multi-image composition with agnes-image-2.0-flash.
• Video generation with agnes-video-v2.0.
• Async video task polling by video_id.
• Safe curl/HTTP examples and Agnes media API troubleshooting.

API Key

The skill expects an Agnes AI API key. Prefer using an environment variable:

export AGNES_API_KEY="your_api_key_here"

Do not commit real API keys or include them in public examples.

Skill Files

• agnes-ai-media/SKILL.md: runtime instructions for Codex.
• agnes-ai-media/references/agnes-media-api.md: API details and examples.
• agnes-ai-media/README.md: skill-level English README.
• agnes-ai-media/README.zh-CN.md: skill-level Chinese README.