Skip to content

feat: Add generator skills category + create-agent-tui skill#2

Open
jonisjongithub wants to merge 1 commit into
mainfrom
add-create-agent-tui-v2
Open

feat: Add generator skills category + create-agent-tui skill#2
jonisjongithub wants to merge 1 commit into
mainfrom
add-create-agent-tui-v2

Conversation

@jonisjongithub

Copy link
Copy Markdown

Summary

This PR expands the Venice skills repo to support two types of skills:

1. API Documentation Skills (existing, venice-*)

  • Teach agents how to use specific Venice API endpoints
  • Follow the strict endpoint/curl/errors template
  • Examples: venice-chat, venice-embeddings, venice-audio-speech

2. Generator / Scaffolding Skills (new, create-*)

  • Help agents create new projects using Venice AI
  • Include sample code, references, and interactive checklists
  • More flexible structure, focused on project generation workflows

Changes

README.md

  • Split skill catalog into two sections:
    • API Documentation Skills (existing)
    • Generator / Scaffolding Skills (new)

CONTRIBUTING.md

  • Added "Skill types" section explaining both categories
  • Added "Style for Generator Skills" guidelines
  • Added separate review checklists for each type

New Skill: create-agent-tui

A skill for AI coding agents (Claude Code, Cursor, Codex) that scaffolds complete agent TUI projects targeting Venice AI.

Like create-react-app but for terminal agents.

Inspired by OpenRouter's create-agent-tui skill, but built specifically for Venice with additional features:

Venice-Specific Features

  • 🔍 Web search integration (--web-search auto|on|off)
  • 🐦 X/Twitter search (Grok models only)
  • 🧠 Reasoning effort control (6 levels)
  • 🎫 DIEM cost tracking support
  • ⚡ Model aliases (opus, sonnet, grok, deepseek, llama, etc.)
  • 🔐 Privacy-first with Venice's zero-retention API

TUI Features

  • 7 built-in tools (file read/write/edit, shell, grep, glob, list-dir)
  • 4 tool display styles (grouped, emoji, minimal, hidden)
  • 3 loader animations (spinner, gradient, minimal)
  • 3 input styles (block, bordered, plain)
  • ASCII banner generator with Venice logo option
  • JSONL session persistence with Markdown export

Structure

skills/create-agent-tui/
├── SKILL.md              # Full skill spec with interactive checklists
├── README.md             # Quick start documentation
├── skill.json            # Metadata
├── references/
│   ├── tools.md          # Tool specifications
│   ├── modules.md        # Harness module documentation
│   └── venice-features.md # Venice-specific features
└── sample/               # Complete working TUI (TypeScript)

Testing

  • Sample compiles cleanly (npx tsc --noEmit)
  • All tools tested locally
  • Streaming works with Venice API
  • Session persistence creates valid JSONL

Quick Start

cd skills/create-agent-tui/sample
npm install
VENICE_API_KEY=vn_xxx npm start -- --model grok --banner venice

This PR expands the Venice skills repo to include two types of skills:

1. **API Documentation Skills** (existing, venice-*)
   - Teach agents how to use specific Venice API endpoints
   - Follow the strict endpoint/curl/errors template

2. **Generator / Scaffolding Skills** (new, create-*)
   - Help agents create new projects using Venice AI
   - Include sample code, references, and interactive checklists

Changes:
- README.md: Split skill catalog into two sections
- CONTRIBUTING.md: Add guidelines for both skill types
- Add create-agent-tui skill (like create-react-app for terminal agents)

The create-agent-tui skill scaffolds complete agent TUI projects in TypeScript
with Venice-specific features: web search, X search, model aliases, DIEM
tracking, and 30+ model support.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant