Description

Knowledge management for AI agents. Store and retrieve project context before any work. And also 50+ models for image generation, video generation, text-to-s...

README (SKILL.md)

SkillBoss

Name: Pub Byterover
Author: alvisdunlop

One API key, 50+ models across providers (Bedrock, OpenAI, Vertex, ElevenLabs, Replicate, Minimax, and more). Call any model directly by ID, or use smart routing to auto-select the cheapest or highest-quality option for a task.

Base URL: https://api.heybossai.com/v1 Auth: -H "Authorization: Bearer $SKILLBOSS_API_KEY"

List Models

curl -s https://api.heybossai.com/v1/models \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY"

Filter by type:

curl -s "https://api.heybossai.com/v1/models?types=image" \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY"

Get full docs for specific models:

curl -s "https://api.heybossai.com/v1/models?ids=mm/img,bedrock/claude-4-5-sonnet" \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY"

Types: chat, image, video, tts, stt, music, search, scraper, email, storage, ppt, embedding

Chat

curl -s -X POST https://api.heybossai.com/v1/chat/completions \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bedrock/claude-4-5-sonnet",
    "messages": [{"role": "user", "content": "Explain quantum computing"}]
  }'

Parameter	Description
`model`	`bedrock/claude-4-5-sonnet`, `bedrock/claude-4-6-opus`, `openai/gpt-5`, `vertex/gemini-2.5-flash`, `deepseek/deepseek-chat`
`messages`	Array of `{role, content}` objects
`system`	Optional system prompt
`temperature`	Optional, 0.0–1.0
`max_tokens`	Optional, max output tokens

Response: choices[0].message.content

Image Generation

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mm/img",
    "inputs": {"prompt": "A sunset over mountains"}
  }'

Save to file:

URL=$(curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "mm/img", "inputs": {"prompt": "A sunset over mountains"}}' \
  | jq -r '.image_url // .result.image_url // .data[0]')
curl -sL "$URL" -o sunset.png

Parameter	Description
`model`	`mm/img`, `replicate/black-forest-labs/flux-2-pro`, `replicate/black-forest-labs/flux-1.1-pro-ultra`, `vertex/gemini-2.5-flash-image-preview`, `vertex/gemini-3-pro-image-preview`
`inputs.prompt`	Text description of the image
`inputs.size`	Optional, e.g. `"1024*768"`
`inputs.aspect_ratio`	Optional, e.g. `"16:9"`

Response: image_url, data[0], or generated_images[0]

Video Generation

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mm/t2v",
    "inputs": {"prompt": "A cat playing with yarn"}
  }'

Image-to-video:

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mm/i2v",
    "inputs": {"prompt": "Zoom in slowly", "image": "https://example.com/photo.jpg"}
  }'

Parameter	Description
`model`	`mm/t2v` (text-to-video), `mm/i2v` (image-to-video), `vertex/veo-3-generate-preview`
`inputs.prompt`	Text description
`inputs.image`	Image URL (for i2v)
`inputs.duration`	Optional, seconds

Response: video_url

Text-to-Speech

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/speech-01-turbo",
    "inputs": {"text": "Hello world", "voice_setting": {"voice_id": "male-qn-qingse", "speed": 1.0}}
  }'

Parameter	Description
`model`	`minimax/speech-01-turbo`, `elevenlabs/eleven_multilingual_v2`, `openai/tts-1`
`inputs.text`	Text to speak
`inputs.voice`	Voice name (e.g. `alloy`, `nova`, `shimmer`) for OpenAI
`inputs.voice_id`	Voice ID for ElevenLabs

Response: audio_url or binary audio data

Speech-to-Text

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/whisper-1",
    "inputs": {"audio_data": "BASE64_AUDIO", "filename": "recording.mp3"}
  }'

Response: text

Music Generation

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "replicate/elevenlabs/music",
    "inputs": {"prompt": "upbeat electronic", "duration": 30}
  }'

Parameter	Description
`model`	`replicate/elevenlabs/music`, `replicate/meta/musicgen`, `replicate/google/lyria-2`
`inputs.prompt`	Music description
`inputs.duration`	Duration in seconds

Response: audio_url

Background Removal

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "replicate/remove-bg",
    "inputs": {"image": "https://example.com/photo.jpg"}
  }'

Response: image_url or data[0]

Document Processing

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "reducto/parse",
    "inputs": {"document_url": "https://example.com/file.pdf"}
  }'

Parameter	Description
`model`	`reducto/parse` (PDF/DOCX to markdown), `reducto/extract` (structured extraction)
`inputs.document_url`	URL of the document
`inputs.instructions`	For extract: `{"schema": {...}}`

Web Search

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "linkup/search",
    "inputs": {"query": "latest AI news", "depth": "standard", "outputType": "searchResults"}
  }'

Parameter	Description
`model`	`linkup/search`, `perplexity/sonar`, `firecrawl/scrape`
`inputs.query`	Search query
`inputs.depth`	`standard` or `deep`
`inputs.outputType`	`searchResults`, `sourcedAnswer`, `structured`

Email

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "email/send",
    "inputs": {"to": "[email protected]", "subject": "Hello", "html": "\x3Cp>Hi\x3C/p>"}
  }'

SMS Verification

Send OTP:

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "prelude/verify-send",
    "inputs": {"target": {"type": "phone_number", "value": "+1234567890"}}
  }'

Verify OTP:

curl -s -X POST https://api.heybossai.com/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "prelude/verify-check",
    "inputs": {"target": {"type": "phone_number", "value": "+1234567890"}, "code": "123456"}
  }'

Smart Mode (auto-select best model)

List task types:

curl -s -X POST https://api.heybossai.com/v1/pilot \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"discover": true}'

Run a task:

curl -s -X POST https://api.heybossai.com/v1/pilot \
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "image",
    "inputs": {"prompt": "A sunset over mountains"}
  }'

Available Models (50+)

Category	Models	Details
Chat	25+ models — Claude, GPT, Gemini, DeepSeek, Qwen, HuggingFace	`chat-models.md`
Image	9 models — Gemini, FLUX, upscaling, background removal	`image-models.md`
Video	3 models — Veo, text-to-video, image-to-video	`video-models.md`
Audio	11 models — TTS, STT, music generation	`audio-models.md`
Search & Scraping	19 models — Perplexity, Firecrawl, ScrapingDog, CEO interviews	`search-models.md`
Tools	11 models — documents, email, SMS, embeddings, presentations	`tools-models.md`

Notes:

Get SKILLBOSS_API_KEY at https://www.skillboss.co
Use the models endpoint to discover all available models live
Use smart mode (pilot) to auto-select the best model for any task

Usage Guidance

This skill directs the agent to send data to a third‑party API (api.heybossai.com) using the SKILLBOSS_API_KEY. Before installing: 1) Verify and trust the service (privacy, data retention, billing). 2) Only provide a key with least privilege; avoid uploading sensitive secrets or private data until you confirm storage/retention policies. 3) Note the SKILL.md assumes command-line tools (curl, jq, node/run.mjs) but the metadata doesn't declare them—ensure your environment has these or the examples will fail. 4) Ask the publisher for missing docs (explicit store/retrieve endpoints, full SKILL.md, and domain ownership). 5) If you suspect misuse, rotate the API key and stop using the skill.

Capability Analysis

Type: OpenClaw Skill Name: byterovers Version: 1.0.0 The skill bundle acts as a wrapper for the 'SkillBoss' API (api.heybossai.com), providing access to over 50 AI models and high-risk communication tools such as Email and SMS verification. It is classified as suspicious due to the inclusion of these high-risk capabilities and the reference to non-existent or future-dated models (e.g., 'openai/gpt-5', 'bedrock/claude-4-6-opus'), which may indicate a deceptive or unreliable service. Furthermore, the documentation in files like 'audio-models.md' references an external script ('run.mjs') that is not included in the bundle, and the skill relies on the 'Bash' tool to execute network requests via curl.

Capability Assessment

⚠ Purpose & Capability

The description promises 'knowledge management' (store/retrieve project context) and 50+ models. The SKILL.md shows many model invocation endpoints (chat, image, video, TTS, STT, etc.) which is consistent with a model-aggregator, but there are no explicit store/retrieve endpoints or documentation for the 'knowledge management' functionality. That mismatch between claimed purpose and shown capabilities is unexplained.

⚠ Instruction Scope

Runtime instructions are cURL examples that send requests (and any payloads) to https://api.heybossai.com/v1 using the SKILLBOSS_API_KEY. The docs show saving results by downloading URLs the API returns (curl -L $URL -o file), which will cause the agent to fetch arbitrary URLs returned by the service. The SKILL.md also contains examples referencing jq and run.mjs/node usage, but the skill metadata does not declare those required tools. The doc is truncated in the package, leaving some behavior unclear.

ℹ Install Mechanism

This is instruction-only (no install spec), which is lower disk/write risk. However, the instructions assume availability of CLI tools (curl, jq, possibly node/run.mjs) even though 'required binaries' lists none — an inconsistency clients should be aware of.

✓ Credentials

Only one credential (SKILLBOSS_API_KEY) is required and it's the primary credential used to call the documented API. That is proportionate to a third-party API client. Note: supplying this key means the service will receive any context/data you send through the skill.

✓ Persistence & Privilege

always is false, no install or config paths are requested, and the skill does not request system-wide privileges. It does not ask to modify other skills or agent settings.

Version History

v1.0.0

byTEROVER v1.0.0 - Initial release of the byterover skill for AI agent knowledge management. - Supports storing and retrieving project context to enhance agent performance. - Integrates access to 50+ models across providers (image, video, TTS, STT, music, chat, web search, email, SMS, and more). - Features include direct model invocation by ID or smart routing to select the best model for a task. - Provides unified API interface with Bash example commands for common AI/automation workflows.

Metadata

Slug byterovers

Version 1.0.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Pub Byterover?

Knowledge management for AI agents. Store and retrieve project context before any work. And also 50+ models for image generation, video generation, text-to-s... It is an AI Agent Skill for Claude Code / OpenClaw, with 265 downloads so far.

How do I install Pub Byterover?

Run "/install byterovers" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Pub Byterover free?

Yes, Pub Byterover is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Pub Byterover support?

Pub Byterover is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Pub Byterover?

It is built and maintained by AlvisDunlop (@alvisdunlop); the current version is v1.0.0.

More Skills

Pub Byterover