Agent skill

openai

Integrate OpenAI API for AI capabilities including ChatGPT conversations, text generation, image creation, and audio conversion. Core Scenario: When the user needs to interact with OpenAI models for chat, translation, image generation, or audio processing.

View SKILL.md on GitHub Repository
Stars 19
Forks 4

Install this agent skill to your Project

npx add-skill https://github.com/x-cmd/skill/tree/main/data/x-cmd/openai

SKILL.md

openai - OpenAI API Integration

The openai module provides a comprehensive CLI interface for OpenAI services, enabling users to perform complex AI tasks like text generation, translation, image creation, and audio conversion directly from the terminal.

When to Activate

  • When the user wants to use OpenAI for chat or text generation (e.g., generating commit messages).
  • When the user needs to translate file contents using AI.
  • When the user wants to generate images based on text prompts.
  • When the user needs to convert text to speech or transcribe audio.
  • When managing OpenAI API keys or model configurations.

Core Principles & Rules

  • API Key Management: Use init or --cfg apikey=<key> to set up the environment.
  • File Input: Use the --file flag to provide context from local files to the chat/generation subcommands.
  • Reproducibility: Be aware that AI outputs can vary; use appropriate parameters for consistent results if needed.

Additional Scenarios

  • Git Commit Messages: Pipe git diff into @gpt to generate standardized commit messages.
  • Audio Processing: Use the audio subcommand for TTS (Text-to-Speech) or transcription tasks.
  • Embedding & Fine-tuning: Advanced users can manage fine-tuned models or calculate text embeddings.

Patterns & Examples

Chat with File Context

bash
# Translate multiple files to Chinese using OpenAI
x openai chat request --file ./abstract.en.md --file ./content.en.md "Translate to chinese"

Image Generation

bash
# Generate an image based on a prompt
x openai image create --prompt "a high-quality digital art of a futuristic city"

Text to Speech

bash
# Convert text to an audio file
x openai audio generate --input "Welcome to x-cmd" --model tts-1 --voice alloy

Generate Commit Message

bash
# Pipe diff into gpt for commit message generation
git diff | @gpt "generate a suitable Git commit message that follows the Conventional Commits format"

Checklist

  • Ensure the OpenAI API key is configured using x openai init.
  • Verify the input files exist when using the --file flag.
  • Confirm the desired model and voice for audio generation.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

x-cmd/skill

pufferlib

High-performance reinforcement learning framework optimized for speed and scale. Use when you need fast parallel training, vectorized environments, multi-agent systems, or integration with game environments (Atari, Procgen, NetHack). Achieves 2-10x speedups over standard implementations. For quick prototyping or standard algorithm implementations with extensive documentation, use stable-baselines3 instead.

19 4
Explore
x-cmd/skill

fluidsim

Framework for computational fluid dynamics simulations using Python. Use when running fluid dynamics simulations including Navier-Stokes equations (2D/3D), shallow water equations, stratified flows, or when analyzing turbulence, vortex dynamics, or geophysical flows. Provides pseudospectral methods with FFT, HPC support, and comprehensive output analysis.

19 4
Explore
x-cmd/skill

metabolomics-workbench-database

Access NIH Metabolomics Workbench via REST API (4,200+ studies). Query metabolites, RefMet nomenclature, MS/NMR data, m/z searches, study metadata, for metabolomics and biomarker discovery.

19 4
Explore
x-cmd/skill

geniml

This skill should be used when working with genomic interval data (BED files) for machine learning tasks. Use for training region embeddings (Region2Vec, BEDspace), single-cell ATAC-seq analysis (scEmbed), building consensus peaks (universes), or any ML-based analysis of genomic regions. Applies to BED file collections, scATAC-seq data, chromatin accessibility datasets, and region-based genomic feature learning.

19 4
Explore
x-cmd/skill

zinc-database

Access ZINC (230M+ purchasable compounds). Search by ZINC ID/SMILES, similarity searches, 3D-ready structures for docking, analog discovery, for virtual screening and drug discovery.

19 4
Explore
x-cmd/skill

astropy

Comprehensive Python library for astronomy and astrophysics. This skill should be used when working with astronomical data including celestial coordinates, physical units, FITS files, cosmological calculations, time systems, tables, world coordinate systems (WCS), and astronomical data analysis. Use when tasks involve coordinate transformations, unit conversions, FITS file manipulation, cosmological distance calculations, time scale conversions, or astronomical data processing.

19 4
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results