translator
Translate text between any languages. Supports 100+ languages with automatic source language detection. Use when the user asks to translate text, detect a language, or work with multilingual content.
csv_analyzer
Analyze CSV and Excel files — statistics, filtering, grouping, and data previews. Use when the user asks to read, analyze, query, or summarize tabular data files (CSV, TSV, Excel).
change_soul
Modify the agent's core identity (soul.md). Use when the user wants to change their name, the agent's core values, language preference, or fundamental behavior.
system_time
Get the current date, time, timezone, or convert between timezones. Use when the user asks what time it is, needs a date, or timezone conversion.
news
Search and summarise news on any topic using web search. Use when the user asks about recent news, current events, or wants a news briefing on any subject.
Google Workspace CLI(gog)
Google Workspace CLI — Gmail, Calendar, Drive, Contacts, Sheets, and Docs via the gog command-line tool. Use when the user asks to send email, search Gmail, check calendar events, manage Google Drive files, read or edit Google Sheets, export Google Docs, or look up contacts.
system_random
Generate random numbers, UUIDs, passwords, or pick random items from a list. Use when the user needs any kind of randomness.
finance
Fetch stock quotes, crypto prices, forex rates, and financial data. Use when the user asks about any stock price, market data, company financials, or cryptocurrency price.
onboarding
First-time setup wizard. Asks the user for their preferred name, desired agent personality, and focus area, then writes soul.md and persona.md. Use when the agent starts for the first time with no soul/persona configured, or when the user requests to reconfigure their agent identity.
tavily_search
Advanced web search using the Tavily API. Use when the user asks to search the web, look up current events, find real-time information, research a topic, check facts, or retrieve data from the internet.
weather
Get current weather and forecasts for any city or location worldwide. Use when the user asks about weather, temperature, rain, wind, or forecasts for any place.
trello
Manage Trello boards, lists, and cards via the Trello REST API. Use when: user asks to create/move/list Trello cards, check board status, manage task lists, or organise project work in Trello. NOT for: Notion databases (use notion skill), GitHub issues (use github skill), or local task lists.
skill_creator
Dynamically create new skills when no existing skill can handle the request. Use when: you need a capability that doesn't exist yet — write the code, bundle it as a skill, install dependencies, and make it available. NOT for: one-off tasks existing tools handle, or skills too specific to reuse.
model_usage
Track and display LLM token usage, costs, and model statistics. Use when: user asks about token usage, API costs, how many messages were sent, or model performance stats. NOT for: changing the model or provider (use change_setting), or viewing conversation content (use session_logs).
change_setting
Modify pythonclaw.json configuration at runtime. Use when the user wants to set API keys, tokens, change LLM provider, adjust web port, or update any configuration value.
http_request
Make HTTP requests (GET, POST, PUT, DELETE, PATCH) to any API endpoint. Use when: the user asks to call an API, test an endpoint, fetch JSON/data from a URL, or interact with a REST API. NOT for: web scraping (use web_scraper), web search (use tavily_search), or file downloads (use curl/wget).
YouTube
Get YouTube video information, metadata, and transcripts/subtitles. Use when the user asks about a YouTube video, wants a video summary, needs a transcript, or asks to extract info from a YouTube URL.
slack
Slack API integration — send/read messages, react to messages, pin items, and fetch member info. Use when: user wants to send a Slack message, check Slack channels, react to a message, or manage pins. NOT for: Discord (use Discord channel), email (use email skill), or real-time Slack event streaming.
obsidian
Work with Obsidian vaults (plain Markdown notes). Use when: user asks to search notes, create notes, move/rename notes, or manage their Obsidian vault. NOT for: Notion pages (use notion skill), non-Markdown files, or Obsidian plugin configuration.
image_gen
Generate images via OpenAI Images API (DALL-E 3, GPT-image). Use when: user asks to generate, create, draw, or design an image, illustration, logo, or artwork. NOT for: editing existing images, image format conversion, or screenshots.
pdf_reader
Extract text content from PDF files. Supports multi-page PDFs, page-level extraction, and metadata reading. Use when the user asks to read, extract, or analyze content from a PDF document.
Send emails via SMTP. Supports plain text and HTML, attachments, CC/BCC. Use when the user asks to send any kind of email — notifications, messages, reports, etc. Credentials are read from pythonclaw.json.
summarize
Summarize or extract text from URLs, articles, PDFs, and local files. Use when: user asks to summarize a link, article, web page, or document, or asks 'what is this link about?'. NOT for: YouTube transcripts (use youtube skill), full document editing, or real-time news (use news skill).
notion
Notion API for creating and managing pages, databases, and blocks. Use when: user asks to create a Notion page, query a database, search notes, add content to Notion, or manage Notion workspace items. NOT for: local file editing (use read_file/write_file), Obsidian vaults (use obsidian skill), or real-time collaboration.
code_runner
Execute Python code snippets safely in an isolated subprocess with timeout protection. Use when the user asks to run, test, or evaluate Python code, calculate expressions, or prototype logic.
github
Interact with the GitHub API — list repos, create issues, view PRs, manage releases. Use when the user asks about GitHub repositories, issues, pull requests, or wants to perform any GitHub operation. Requires a GitHub Personal Access Token in pythonclaw.json.
session_logs
Search and analyse your own conversation history from session files. Use when: user references older conversations, asks what was said before, or needs historical context from past sessions. NOT for: current session messages (already in context), non-session files, or external logs.
web_scraper
Scrape and extract content from web pages. Supports extracting text, links, headings, and structured data. Use when the user asks to read a web page, extract information from a URL, or scrape website content.
spotify
Control Spotify playback — play, pause, skip, search, and queue tracks. Use when: user asks to play music, search for songs, control playback, or manage Spotify queue. NOT for: downloading music, non-Spotify services (Apple Music, YouTube Music), or audio file playback.
change_persona
Modify the agent's personality and role (persona.md). Use when: user wants to change agent personality, communication style, focus area, or specialization. NOT for: changing user name or core identity (use change_soul), or first-time setup (use onboarding).
tts
Text-to-speech — convert text to audio using gTTS or edge-tts. Use when: user asks to read text aloud, generate an audio file from text, or create a voiceover. NOT for: speech-to-text/transcription (use Deepgram or whisper), music generation, or audio editing.