Description

Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud) using vdirsyncer and khal. And also 50+ models for image generation, video generation,...

README (SKILL.md)

SkillBoss

Name: Pub Caldav
Author: tobeyrebecca

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

Do not provide your SKILLBOSS_API_KEY or install this skill until the author clarifies its purpose. Ask the publisher to explain: (1) why a CalDAV sync skill needs SKILLBOSS_API_KEY and what heybossai.com will receive, (2) where the vdirsyncer/khal commands or install instructions are, and (3) provide a source/homepage or repo for review. If you must test, do so in a sandbox with a throwaway API key and no real calendar data. Monitor network traffic and rotate any keys you expose. If the skill will handle calendars, demand explicit CalDAV auth flow (OAuth/app-passwords) and a privacy policy stating how calendar data is used/stored.

Capability Analysis

Type: OpenClaw Skill Name: caldav-calendars Version: 1.0.0 The skill bundle exhibits a significant 'bait-and-switch' discrepancy: while the metadata and description claim it is a CalDAV calendar sync tool, the entire content of SKILL.md and the auxiliary markdown files is dedicated to a third-party AI aggregator API (api.heybossai.com). The documentation references non-existent or future models (e.g., 'openai/gpt-5', 'bedrock/claude-4-6-opus' in chat-models.md) and refers to a missing execution script ('run.mjs'). This misleading configuration, combined with the promotion of a potentially fraudulent service that requires an external API key, poses a high risk of data redirection and agent confusion.

Capability Assessment

⚠ Purpose & Capability

Name/description promise CalDAV sync with vdirsyncer and khal, but SKILL.md contains no vdirsyncer/khal commands, CalDAV endpoints, or calendar-auth instructions. Instead it documents an unrelated third-party API (api.heybossai.com) and many model IDs. The single required env var (SKILLBOSS_API_KEY) and the documented curl calls are unrelated to calendar sync, which is a clear mismatch.

⚠ Instruction Scope

Runtime instructions instruct the agent to call https://api.heybossai.com using curl and an API key and describe many model endpoints. Allowed tools include Bash and Read, so an agent following these instructions could easily send local data (including calendar contents if asked) to the external API. The SKILL.md does not explain how CalDAV credentials are obtained/used and does not confine outgoing network targets to CalDAV services; it explicitly directs traffic to a third-party AI endpoint.

✓ Install Mechanism

Instruction-only skill with no install spec and no code files — nothing is downloaded or written during install. This lowers risk from supply-chain installs, but does not address the behavioral mismatch above.

⚠ Credentials

The skill requires a single env var SKILLBOSS_API_KEY (declared primary credential). That credential is appropriate for calling the documented API but is disproportionate to the claimed CalDAV sync purpose. No CalDAV credentials (CalDAV URL, username, app-specific password, OAuth tokens) are declared or documented. Requesting an unrelated API key is suspicious and could enable exfiltration of calendar or local data to the third-party service.

✓ Persistence & Privilege

The skill does not request always:true or other elevated persistent privileges. It is user-invocable and allowed to be invoked autonomously by default (platform standard). Autonomy combined with the env-var/network mismatch increases risk, but the skill itself doesn't request permanent inclusion or system-level config changes.

Version History

v1.0.0

- Initial release of caldav-calendar skill (v1.0.0). - Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud) using vdirsyncer and khal. - Access 50+ models for image generation, video generation, text-to-speech, speech-to-text, music, chat, web search, document parsing, email, and SMS through the SkillBoss API. - Requires a SKILLBOSS_API_KEY for authentication.

Metadata

Slug caldav-calendars

Version 1.0.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Pub Caldav?

Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud) using vdirsyncer and khal. And also 50+ models for image generation, video generation,... It is an AI Agent Skill for Claude Code / OpenClaw, with 268 downloads so far.

How do I install Pub Caldav?

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

Is Pub Caldav free?

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

Which platforms does Pub Caldav support?

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

Who created Pub Caldav?

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

More Skills

Pub Caldav