Agent-JAE/default-skills/README.md
jae c42cd9a062 feat: add 11 Venice AI skills as bundled defaults
Skills included:
- venice-chat: Chat with Venice LLM models, vision, reasoning
- venice-chat-benchmark: Benchmark chat models with infographics
- venice-image-gen: Generate images via Venice API
- venice-list-image-models: List available image models
- venice-list-text-models: List available text models
- venice-list-video-models: List available video models
- venice-tts: Text-to-speech via Venice API
- venice-video-generate: Generate videos from text/images
- venice-video-queue: Queue video generation jobs
- venice-video-quote: Get video generation cost quotes
- venice-video-retrieve: Retrieve completed videos

All rebranded from Agent Zero paths to Agent JAE (~/.jae/agent/skills/).
Requires VENICE_API_KEY environment variable.
2026-03-23 18:47:33 +01:00

86 lines
3.2 KiB
Markdown

# Venice Skills
A collection of skills that wrap the [Venice.ai](https://venice.ai/) API for chat, image generation, video generation, text-to-speech, and model discovery. All skills require the `VENICE_API_KEY` environment variable.
## Skills
| Skill | Description |
|-------|-------------|
| [venice-chat](./venice-chat/) | Chat with Venice.ai LLMs with vision, reasoning mode, and web search |
| [venice-chat-benchmark](./venice-chat-benchmark/) | Benchmark Venice.ai chat models with tool_choice stress testing, timing stats, and 4K infographic |
| [venice-image-gen](./venice-image-gen/) | Generate images from text prompts (1K/2K/4K, multiple formats and aspect ratios) |
| [venice-tts](./venice-tts/) | Text-to-speech with 50+ voices across 9 languages |
| [venice-video-generate](./venice-video-generate/) | Full-lifecycle video generation (queue + poll + retrieve + save) |
| [venice-video-queue](./venice-video-queue/) | Queue a video for generation (text/image/video-to-video) |
| [venice-video-retrieve](./venice-video-retrieve/) | Retrieve and download a queued video by polling until complete |
| [venice-video-quote](./venice-video-quote/) | Get cost estimates for video generation with parameter validation |
| [venice-list-text-models](./venice-list-text-models/) | List available LLM models with capabilities, context windows, and pricing |
| [venice-list-image-models](./venice-list-image-models/) | List available image generation models with pricing and constraints |
| [venice-list-video-models](./venice-list-video-models/) | List available video models with durations, resolutions, and audio capabilities |
## Prerequisites
- Python 3.10+
- `requests` (`pip install requests`)
- `pydantic` (required by video and model-listing skills)
- `VENICE_API_KEY` environment variable set to your Venice.ai API key
```bash
pip install requests pydantic
export VENICE_API_KEY="your_venice_api_key"
```
## Structure
Each skill follows a consistent layout:
```
skill-name/
SKILL.md # Agent-facing documentation (frontmatter + usage)
README.md # Human-facing GitHub documentation
scripts/ # Executable Python scripts
```
- **`SKILL.md`** -- YAML frontmatter (name, description, version, tags, trigger patterns) plus agent-facing usage instructions.
- **`README.md`** -- Human-readable documentation with examples.
- **`scripts/`** -- Python scripts that work both as CLI tools (via `argparse`) and as importable modules.
## Quick Start
### Chat
```bash
python venice-chat/scripts/chat.py "What is the capital of France?"
```
### Generate an image
```bash
python venice-image-gen/scripts/generate_image.py "A sunset over mountains"
```
### Generate a video
```bash
python venice-video-generate/scripts/generate_video.py "A timelapse of a blooming flower"
```
### Text-to-speech
```bash
python venice-tts/scripts/text_to_speech.py "Hello, world!"
```
### List available models
```bash
python venice-list-text-models/scripts/list_text_models.py
python venice-list-image-models/scripts/list_image_models.py
python venice-list-video-models/scripts/list_video_models.py
```
## Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| `VENICE_API_KEY` | Yes | Venice.ai API key |