Skip to content

Example skills

haiku.skills ships with several entrypoint skill packages under skills/. Each one demonstrates a different pattern and can be used as a reference implementation.

Using example skills

Install them as Python packages and enable entrypoint discovery:

uv add haiku-skills-web

from haiku.skills import SkillToolset

toolset = SkillToolset(use_entrypoints=True)

web

Web search via Brave Search API and page content extraction via trafilatura.

uv add haiku-skills-web

Tools: search, fetch_page. Requires BRAVE_API_KEY environment variable.

image-generation

Image generation via Ollama.

uv add haiku-skills-image-generation

Tools: generate_image. Returns the file path of the generated image.

code-execution

Sandboxed Python execution via pydantic-monty with a built-in await llm(prompt) function for LLM reasoning.

uv add haiku-skills-code-execution

Tools: run_code.

gmail

Gmail access via the Google Gmail API with OAuth2 authentication.

uv add haiku-skills-gmail

Requires Google Cloud OAuth2 credentials. Configure via environment variables:

  • EMAIL_CREDENTIALS_PATH — Path to OAuth2 credentials file (default: ~/.config/haiku-skills-gmail/credentials.json)
  • EMAIL_TOKEN_PATH — Path to cached OAuth2 token (default: ~/.config/haiku-skills-gmail/token.json)

Tools: search_emails, read_email, send_email, reply_to_email, create_draft, list_drafts, modify_labels, list_labels.

notifications

Push notifications via ntfy.sh.

uv add haiku-skills-notifications

Configure via environment variables:

  • NTFY_SERVER — ntfy server base URL (default: https://ntfy.sh)
  • NTFY_TOKEN — Bearer token for authenticated topics (optional)

Tools: send_notification, read_notifications.

sandbox

Docker-based Python execution via pydantic-ai-backend. Runs code in an isolated container with pre-installed data science packages and host filesystem access.

uv add haiku-skills-sandbox

Requires Docker and a pre-built image:

docker build -t haiku-skills-sandbox:latest skills/sandbox/haiku_skills_sandbox/

Configure via environment variables:

  • HAIKU_SKILLS_SANDBOX_WORKSPACE — Host directory mounted at /workspace in the container
  • HAIKU_SKILLS_SANDBOX_IDLE_TIMEOUT — Seconds of inactivity before container is stopped (default: 3600)
  • HAIKU_SKILLS_SANDBOX_IMAGE — Docker image to use (default: haiku-skills-sandbox:latest)

Tools (via ConsoleToolset): ls, read_file, write_file, edit_file, glob, grep, execute.

External: RAG

For retrieval-augmented generation, the separate haiku.rag project provides a RAG skill. Install independently:

uv add haiku.rag