Skill Library

BALIA OS agents extend their capabilities through skills — modular tools loaded on demand. This page lists all available skills and explains how to add new ones.

---

How to Add New Skills

There are two ways to expand your agent's skillset.

Option A: Find an Existing Skill

Tell your Security Agent (Security Guardian) what you want to accomplish:

"Security Guardian, I want to scrape product prices automatically. Find a skill for this."

Security Guardian will:

1. Search GitHub communities and use grok-scraper to pull the latest skill discussions on X
2. Run quarantine — scanning for malicious code, backdoors, and API key exfiltration
3. Add approved skills to skills/_SKILL_INDEX.md
4. Your agents can then use the new skill immediately

Option B: Build Your Own (Recommended ✅)

Use skill-creator with Security Guardian to build a custom skill from scratch.

Why self-build is recommended:

• Fits your exact use case — no workarounds needed
• Lower security risk — no external code to vet
• Full ownership — you control updates and logic

"Security Guardian, I want to build a skill that monitors my Notion database for overdue tasks."

Security Guardian and skill-creator handle the scaffolding. You describe the goal; they build it.

💰 Skill Marketplace (Coming Phase 7)

Once the Skill Marketplace launches, skills you build can be listed for sale. If your skill solves a real problem, other BALIA OS users can purchase it — and you earn revenue. All marketplace skills go through Security Guardian quarantine before listing.

---

Core Skill Pack (Included with T1)

Three skills ship with every T1 purchase and are installed via install_core_pack.py.

Skill	Purpose
lightpanda	Fast web search and scraping
summarize	Auto-summarize long text and web pages
clawsec	Security monitoring — fixed to Slot #6, always active

Full installation guide: Section 6 — Core Skills Setup

---

All Available Skills

🔍 Search & Web

lightpanda

Fast headless browser via WSL2. Searches DuckDuckGo and fetches any URL as Markdown. ~10x faster than Chromium, ~1/9 the memory. Bot-detection resistant. OS: Windows (WSL2) / Mac / Linux Usage: "Search the web for X with lightpanda"

blogwatcher

Monitors specific blogs and websites for updates. Agents subscribe to sources and get notified when new content appears. Usage: "Watch this blog and alert me when there's a new post"

goplaces

Searches location and business information via Google Places and similar APIs. Usage: "Find co-working spaces near Shibuya"

grok-scraper

Scrapes Grok AI via Playwright to pull real-time crypto trends, KOL mentions, and project discussions from X — no API required. ⚠️ Requires X Premium account with an active logged-in session. Usage: "Use grok-scraper to find what KOLs are saying about Solana today"

xurl

Stealth scraping of specific X (Twitter) URLs and content extraction. Usage: "Pull the content from this X thread"

---

📝 Text & Document

summarize

Compresses long documents, research reports, and web pages into structured, actionable summaries. Used automatically by agents before nightly AI meetings. Usage: "Summarize today's research findings"

nano-pdf

Lightweight PDF text extraction and reading. Handles scanned documents and multi-page reports. Usage: "Read this PDF and extract the key figures"

---

🤖 AI & Generation

gemini

Google Gemini integration for advanced text reasoning, generation, and analysis. Use when tasks require a second AI perspective or large context windows. Usage: "Analyze this with Gemini and give me a second opinion"

nano-banana-pro

High-quality image generation, editing, and style transfer. Usage: "Generate a banner image in this style"

openai-whisper

Local Whisper model for high-accuracy speech recognition and transcription. Runs fully offline — no API cost, no data sent externally. Usage: "Transcribe this audio file"

sherpa-onnx-tts

Fast, lightweight local text-to-speech (TTS). Agents can read out reports or notifications via voice. Usage: "Read this report aloud"

---

💻 Development & Code

coding-agent

Autonomous source code analysis, writing, and bug fixing assistant. Usage: "Review this Python script and fix any bugs"

github

GitHub repository operations — clone, pull, push, branch management. Usage: "Push the latest changes to the repo"

gh-issues

GitHub Issue creation, search, and status management. Usage: "Create a GitHub issue for this bug"

skill-creator

Scaffolds new custom skills from scratch. Work with Security Guardian to define inputs, outputs, and logic — then register to _SKILL_INDEX.md. Usage: "Security Guardian, let's build a skill that does X"

---

📊 Productivity & Operations

ai_marketing_skills

A collection of marketing workflows modeled on agencies generating 9-figure revenue. Covers: content-ops / growth-engine / finance-ops / conversion-ops / team-ops / sales-pipelineRecommended by agent:

• Maya / Emma / Sophia → content-ops, conversion-ops
• Benjamin → finance-ops
• Leo / Victor → team-ops

Usage: "Run the content-ops workflow for this week's posts"

notion

Read and write Notion databases, create pages, manage tasks. Usage: "Add today's meeting summary to our Notion workspace"

trello

Trello board card creation, list management, task tracking. Usage: "Move the design card to Done in Trello"

himalaya

Command-line email send and receive via IMAP/SMTP. Agents can read inboxes and send replies. Usage: "Check maya@baliaos.com for new messages"

---

🔧 System & Monitoring

model-usage

Monitors token consumption and API usage across all agents. Helps keep costs in check. Usage: "Show me today's API usage breakdown"

healthcheck

Dead-man switch and server health monitoring. Alerts agents when a service goes down. Usage: "Monitor this endpoint and alert me if it goes down"

clawsec

Continuous file integrity monitoring, BOM detection, malicious code scanning, and automatic rollback. Fixed to Security Agent Slot #6 — cannot be removed or swapped.Usage: Runs automatically. No manual invocation needed.

---

🎥 Media

video-frames

Extracts frame images from video files for analysis or processing. Usage: "Extract frames from this video every 5 seconds"

---

Architecture: How Skills Load

BALIA OS uses a Pocket Catalog model to keep API costs low:

1. skills/_SKILL_INDEX.md holds a short index — skill names and one-line descriptions only
2. When an agent receives a task, it loads only the relevant skill file
3. After the task completes, the skill is unloaded from context

Never load all skills simultaneously — this is enforced by IRON RULES.

---

Skill Library last updated: June 2026 · BALIA OS T1 Starter Guide