Skill catalog

Run any Apify actor and get the dataset items back. Defaults to async mode — the actor runs in the background (up to 60 min) and Hearth posts the results into your chat / Telegram when ready. Pass mode='sync' for fast actors under 90s. Bring your own APIFY_API_TOKEN.

Generate a stylised square avatar from a description — useful for profile photos, agent icons, social-handle headshots. Pass `subject` for the person/character description; optional `style` (default 'editorial illustration').

Find B2B leads — emails, phones, LinkedIn URLs — from a free-form search query. Use this for outbound sales prospecting. For LinkedIn-specific employee lists, prefer linkedin_company_employees.

Replace the background of an image while keeping the subject intact. Pass `image_url` of the source + `background` describing the new backdrop. Best with a foreground mask, but works without one on portraits.

Generate a corporate business headshot from a description. Calls the configured image provider (OpenAI by default; KIE / Higgsfield work too) with a preset cinematography prompt — soft natural lighting, neutral background, 35mm portrait lens look. Pass `subject` for the person description; everything else has defaults.

Generate a 9:16 vertical iPhone-style selfie of a cat — deliberately ordinary, with awkward framing or candid imperfection. Uses OpenAI gpt-image-2. The default prompt is editable from Configure Skill (override) and falls back when cleared.

Generate an editorial / dramatic portrait. Same shape as Business Headshot but with cinematic lighting, distinctive composition, artistic styling. Good for actor / musician / agency headshots. Pass `subject` for the person description.

Parse a CSV file or string into structured rows.

Morning briefing — three world headlines, one weather summary, and a one-line outlook for the day. Single Sonnet hop. Schedule it at 7am via hearth_schedule for a daily delivery to chat.

Generate a 9:16 vertical iPhone-style selfie of a dog — deliberately ordinary, with awkward framing or candid imperfection. Uses OpenAI gpt-image-2. The default prompt is editable from Configure Skill (override) and falls back when cleared.

Scrape product pricing and listings from e-commerce sites — Amazon, eBay, Shopify storefronts. Use this for pricing monitoring and competitive intel. NOT for general crawling — use website_content_crawler.

Send transactional email via Resend. Bring your own RESEND_API_KEY and a verified sender domain. Simple POST under the hood — agent supplies to/subject/html/text/attachments.

Scrape Facebook Ads Library to see what ads competitors are running. Use this for marketing intelligence and ad creative research. NOT for organic Facebook posts — use facebook_posts.

Pull recent posts from a Facebook page. Use this for brand monitoring of an organic Facebook presence. NOT for paid ads — use facebook_ads_library.

Image generation via fal.ai — fast serverless inference for Flux, SDXL, SD3, IP-Adapter, ControlNet, and inpaint/outpaint variants. Pass `model` to pick an endpoint (default fal-ai/flux/schnell). Single prompt → image saved to /dashboard/collateral.

Read email from your Gmail inbox via Google OAuth. Search messages, read bodies, list labels. Uses the minimum-privilege gmail.readonly scope — this skill physically cannot send email or modify your mailbox. Pair with Gmail Email — Send for outbound.

Send email through your Gmail account via Google OAuth. Uses the minimum-privilege gmail.send scope — this skill can compose and send email but physically cannot read your inbox. Pair with Gmail Email — Read if your agent also needs inbox visibility.

Find Google Maps businesses — name, address, hours, reviews, rating. Use this for local business research and prospecting. NOT for general web search — use google_search.

Scrape Google SERP results — organic listings, ads, People Also Ask. Use this for research and competitive queries. NOT for crawling content of a specific URL — use website_content_crawler.

Native — create a mission card on the kanban.

Native — pull live state (approvals, missions, financials, agents).

Native — surface notification in dashboard chat + audit log.

Native — schedule a future prompt back to the agent.

Native — detect intent and recommend installed/catalog skills.

Sora-style image + image-to-video generation via Higgsfield.ai. Use this for cinematic / motion-aware stills and short looped videos.

Native — spawn a new agent with role-based skill curation.

Image generation via Ideogram.ai — best-in-class typography handling. Use this when the image needs to render readable text (posters, ads, thumbnails, signage). Pass `model` to pick V_2 (default) or V_2_TURBO. Single prompt → image saved to /dashboard/collateral.

Generate AND edit images with gpt-image-2 (OpenAI). Text-to-image plus image-to-image, inpaint (with mask), and transparent-background cutouts via the /edits endpoint. Saves to /dashboard/collateral. Part of the AI Image Family — sub-skills (headshot_business, background_replace, wardrobe_swap, inpaint, social_post_image, etc.) route here by default.

Edit a region of an existing image — provide an image and a mask (white = edit, black = keep), and a prompt describing what to fill in. Routes through any installed provider that declares the inpaint capability (Replicate, fal, Stability, Ideogram).

Scrape posts from an Instagram profile, hashtag, or location. Use for brand monitoring and content research. For a profile's bio + follower count, use instagram_profile instead.

Fetch an Instagram profile snapshot — bio, follower count, recent post count, verified status. Use for quick profile lookups. For actual post content, use instagram_posts.

Image generation via KIE.ai — multi-model proxy for Flux, Stable Diffusion, Midjourney-style outputs. One key unlocks dozens of model endpoints. Single prompt → image, saved to /dashboard/collateral.

Generate a warm lifestyle / outdoor portrait. Same shape as Business Headshot but with golden-hour outdoor lighting, casual styling, environmental background. Pass `subject` for the person description.

Pull all employees from a LinkedIn company page. Use this for sales prospecting at scale or competitive team mapping. NOT for a single person's profile — use linkedin_profile_lookup.

Keyword search across ALL of LinkedIn — finds posts that mention a phrase, by anyone. Use this for 'find posts about X' or 'who's posting about Y'. NOT for 'what did <specific person> post' — use linkedin_profile_posts for that. Returns posts with author + URL + snippet. Reuses APIFY_API_TOKEN.

Fetch a LinkedIn profile's full details — title, work history, education, contact info when available. Use for researching a specific person. NOT for their posts (use linkedin_profile_posts) or for searching employees (use linkedin_company_employees).

Fetch a SPECIFIC person's recent LinkedIn posts from their profile URL. Use this when the founder asks 'what did <person> post on LinkedIn' or 'show me recent posts from <profile URL>'. NOT for keyword search across LinkedIn — use linkedin_mentions for that. Reuses the same APIFY_API_TOKEN.

Generate a logo concept from a description. Routes through Recraft when configured (native vector output); falls back to text-to-image providers for raster. Pass `brand` for the brand name + `concept` for what the logo should convey.

Orchestrate n8n automations from Hearth. Create, list, activate, trigger, and inspect workflows on your own n8n instance (cloud or self-hosted). Use this when the founder wants to wire third-party systems together (Slack, Gmail, Notion, custom webhooks, etc.) or set up a recurring automation that needs more than a single skill call. Pass `action` ∈ list/get/create/update/delete/activate/deactivate/trigger/executions plus the action-specific args.

Public HTTPS ingress for inbound webhooks (Apify callbacks, Twilio SMS, Retell voice, GitHub, Stripe). Supervisor spawns ngrok as a child process at boot, captures the public URL, and exposes it to other skills via INGRESS_PUBLIC_URL. HMAC-signed inbound only — no anonymous traffic.

Extend an image beyond its original frame in one or more directions. Provide an image and a prompt for what should appear in the extended area. Routes through any installed provider that declares the outpaint capability (fal, Stability).

Extract text from a PDF file or URL.

Agent-issued virtual cards via Privacy.com. Mint single-use or merchant-locked cards with spend caps, freeze/unfreeze, list transactions. Bring your own PRIVACY_API_KEY. US-only.

Route the chat's incognito mode to a local LLM you run yourself — LM Studio, Ollama, llama.cpp's server, vLLM, or any OpenAI-compatible endpoint. Two URL slots so you can pin a primary (e.g. localhost or LAN) plus an optional fallback (e.g. Tailscale) — Hearth tries the primary first and falls through. While incognito is active, only save-to-collateral is allowed; nothing else leaves your box.

Generate a clean studio product shot from a description. Calls the configured image provider with a preset prompt — white seamless backdrop, soft three-point lighting, sharp focus, 50mm macro look. Pass `product` for the item description (e.g. 'matte black ceramic coffee mug').

Design-focused image + vector generation via Recraft.ai. Unique among providers: native SVG / vector output, brand-controllable style presets, icon and logo modes. Pass `style` for one of recraft's 30+ presets (realistic_image, digital_illustration, vector_illustration, icon).

Search Reddit posts and comments by keyword. Use this for community pulse and customer research. Optional subreddit narrows scope. NOT for X/Twitter — use twitter_search.

Image generation via Replicate — one key, hundreds of community-hosted models (Flux, SDXL, ControlNet, inpaint/outpaint variants, background remover, upscalers). Pass `model` to pick a slug; defaults to black-forest-labs/flux-schnell. Single prompt → image saved to /dashboard/collateral.

Place an outbound phone call via RetellAI with a synthesized agent script. Configure once with API key + a 'from' number + voice model (Hearth enumerates both from your RetellAI account); routines + the agent then dispatch. ~$0.07/min, SOC 2 Type II. Risk-classed destructive — every call goes through the M32 risk gate.

Generate a 1:1 square image sized for Instagram / LinkedIn social posts. Calls the configured image provider with the optimal aspect ratio + a clean social-media composition prompt. Pass `concept` for what the image should show.

Image generation via Stability AI — Stable Diffusion 3, Stable Image Core, Ultra. Strong photorealism and prompt adherence; inpaint + outpaint + upscale endpoints under one key. Pass `model` to pick a tier (default core). Single prompt → image saved to /dashboard/collateral.

Restyle an existing image with a new aesthetic — pass `image_url` of the source + `style` describing the target look (e.g. 'watercolour wash', 'cyberpunk neon', '1920s film grain'). Subject and composition stay; surface treatment shifts.

Send Telegram messages from a bot.

Generate a 16:9 thumbnail (YouTube / blog hero) from a concept. Calls the configured image provider with a high-contrast bold composition preset. Pass `concept` for what the thumbnail should show; optional `headline` for big-text overlay.

Pull TikTok videos by hashtag or profile. Use this for trend monitoring and content intelligence. NOT for Instagram or YouTube — use the platform-specific skills.

Send an SMS via Twilio. Configure once with Account SID + Auth Token + a 'from' number (Hearth enumerates your Twilio account-owned numbers and lets you pick); routines + the agent then dispatch.

Search X/Twitter posts by keyword or hashtag. Use for brand mention monitoring and trend research on X. NOT for LinkedIn or Instagram — use the platform-specific skills.

Change what someone is wearing in an existing portrait while keeping the face, pose, and lighting consistent. Pass `image_url` of the source portrait + `outfit` for the new clothing description.

Fetch a website's text content as clean markdown for RAG, summarization, or 'what does this URL say' questions. Use this when the founder gives a URL and wants the readable content. NOT for SERP results — use google_search.

Parse Excel files — sheets, ranges, formulas.

Pull recent videos from a YouTube channel — title, views, subscriber count, video metadata. Use this for channel research and content tracking. NOT for transcripts — use youtube_transcript.

Fetch the transcript of a YouTube video by URL or ID — plain text from the caption track (human or auto-generated). NOT for channel/video metadata — use youtube_channel.

Describe, transcribe (OCR), or classify an image given a URL, base64 data, or file path. Calls Claude vision.

Search arXiv for papers by topic, author, or category. Returns title, abstract, authors, and PDF link.

Background hygiene — purge stale chat attachments and orphaned files past the retention window.

Live crypto spot prices via CoinGecko. BTC, ETH, and any listed ticker. Free public API.

Random dad joke via icanhazdadjoke.com. The icebreaker every CEO agent secretly wants.

Resolve A, AAAA, MX, TXT, NS, and CNAME records for a hostname. Useful when an agent is triaging email or network issues.

Foreign-exchange spot rates for any currency pair. Free public API.

Read, post, reply, and vote in marketplace forum channels. Bot rules per channel shape how the agent participates.

Registers this agent with the Hearth Marketplace so it can discover peers, receive MOTD pushes, and accept invites.

Nightly LLM pass over agent memory — proposes merge / rescore / prune mutations. High-importance changes route through approvals.

Top headlines + per-topic queries against public news feeds. Returns title, source, snippet, and link.

Send transactional email via a configured SMTP relay. Alternative to the Resend skill for self-hosted senders.

Look up equity quotes by ticker. Returns price, change, and basic intraday range.

Summarize long-form text or transcripts using a chunked map-reduce pass. Returns headline + key bullets.

Current conditions and a 3-day forecast for a city or zip code via wttr.in. Free public API, no key required.

Fetch and clean any public URL — readability extraction, HTML → markdown, with timeouts and size caps.

General-purpose web search via DuckDuckGo HTML — no API key required. Returns ranked snippets the agent can cite.

WHOIS lookup for a domain — registrar, registration date, expiry, and nameservers.

Look up a topic on Wikipedia. Returns title, summary extract, page link, and thumbnail.