keboola-git

Welcome to Claude Kit 🚀

This repository is the central library for all AI prompts and agent configurations used across the organization. Its purpose is to foster collaboration, maintain high standards, and accelerate our work by sharing effective and well-tested prompts and specialized agents.

Installation

Install skills using skills tool: npx skills add keboola/ai-kit

Alternatively, install via the Claude Code plugin marketplace:

/plugin marketplace add keboola/claude-kit

After installation, enable the plugins you need:

/plugin install component-developer

Repository Structure

The repository is organized into a plugin-based architecture to make prompts and agents easy to discover and use:

claude-kit/
├── .claude-plugin/
│   └── marketplace.json     # Marketplace configuration
├── plugins/
│   ├── component-developer/ # Keboola Python component development
│   ├── dataapp-developer/   # Data app development & deployment for Keboola
│   ├── keboola-cli/         # Keboola project management and review
│   ├── keboola-git/         # Keboola-managed Git (Forgejo) access for data apps
│   ├── powerbi-to-sl/       # Migrate Power BI semantic models to Keboola
│   └── sl-toolkit/          # Semantic layer inspect, validate, build + conversational CRUD
├── README.md                # This file
└── LICENSE                  # MIT license

Available Plugins

Component Developer Plugin

Location: ./plugins/component-developer

A specialized toolkit for building production-ready Keboola Python components following best practices and architectural patterns.

Features:

• 🎯 Skills: Build component, build UI, debug, test, VCR test, review, backward compatibility review, migrate to UV, getting started
• ⚡ Commands: Init, run, fix, review, migrate-repo, schema-test
• 🔌 MCP Server: Keboola integration
• 📋 Configuration Schemas: JSON Schema with UI elements
• 🚀 CI/CD Integration: Developer Portal and deployment workflows

→ View Component Developer Plugin Documentation

Data App Developer Plugin

Location: ./plugins/dataapp-developer

A toolkit for building and deploying data apps to Keboola — Streamlit development with validate/build/verify workflow, plus deployment guides for Node.js, Python, and any web framework.

Features:

• 🎯 Skills: dataapp-development covering both Streamlit and Python/JS apps with 14 topical references, plus semantic-layer-usage for confirming a semantic model's physical columns before querying
• 🚀 App Types: Streamlit (Code or Git), single Node.js + static (dashboarding default), combined Python + Node
• 💾 Storage: RO workspace (default), RW direct access via Query Service, input mapping (legacy)
• 🔒 Authentication: None / Basic / OIDC / GitHub / GitLab / JumpCloud
• ⚡ Performance: Opinionated DuckDB caching pattern (Python + Node templates included)
• 🎨 Styling: Default Keboola theme + optional bundled React+Vite stack + brand customization paths
• 🤖 Kai Integration: Optional natural-language assistant via kai-client
• 📦 Templates: 5 runnable starters (Streamlit, Python-only, Node-only, Python+Node, DuckDB cache)
• 🔌 MCP Servers: Keboola (remote HTTP) and Playwright (browser automation)
• 🔌 MCP hosting: host any MCP server (Keboola MCP as the worked example) as a single-tenant data app — bearer + OAuth-shape auth, deploy via kbagent / keboola-git / hosted MCP tools

→ View Data App Developer Plugin Documentation

Keboola CLI Plugin

Location: ./plugins/keboola-cli

A project management and review toolkit for Keboola projects. Includes CLI sync commands and a 10-agent review team that audits SQL quality, security, performance, financial logic, data quality, and template readiness.

Features:

• 🤖 Agents: 10 specialized review agents (SQL, Config, DWH Architecture, Data Quality, Financial Logic, Semantic Layer, Security, Performance, Template Readiness, Consolidator) + config analyzer
• ⚡ Commands: /kbc-init, /kbc-pull, /kbc-push, /kbc-diff, /kbc-review
• 🔌 MCP Server: Keboola integration for live project analysis
• 📊 Financial Intelligence: Multi-ERP awareness (NetSuite, SAP, Oracle, D365, QuickBooks, Xero), SaaS metrics, budget variance
• 🔒 Security Audit: Credential scanning, PII detection, GDPR/CCPA compliance checks
• 🦆 DuckDB Transformation: SQL dialect, block orchestration, dynamic backends, Snowflake migration, best practices

→ View Keboola CLI Plugin Documentation

Keboola Git Plugin

Location: ./plugins/keboola-git