![BDB DEV Media | Event – Optimized Agent Skills](header.png)

🌐 **Sprache / Language / Idioma**: [ 🇬🇧 English ](README.md) | **Deutsch** | [ 🇵🇹 Português ](README.pt.md)

---

```text
██████╗ ██████╗ ██████╗      █████╗  ██████╗ ███████╗███╗   ██╗████████╗     ██████╗ ███████╗
██╔══██╗██╔══██╗██╔══██╗    ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝    ██╔═══██╗██╔════╝
██████╔╝██║  ██║██████╔╝    ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║       ██║   ██║███████╗
██╔══██╗██║  ██║██╔══██╗    ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║       ██║   ██║╚════██║
██████╔╝██████╔╝██████╔╝    ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║       ╚██████╔╝███████║
╚═════╝ ╚═════╝ ╚═════╝     ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝        ╚═════╝ ╚══════╝

                         O P T I M I Z E D   A G E N T   S K I L L S
```

# 🚀 BDB DEV - Optimiertes Creative & Full-Stack Skills Pack

[![CI](https://github.com/hybridlabor-api/bdb-dev-optimized-agent-skills/actions/workflows/ci.yml/badge.svg)](https://github.com/hybridlabor-api/bdb-dev-optimized-agent-skills/actions)
[![NPM Version](https://img.shields.io/npm/v/@hybridlabor-api/bdb-dev-optimized-agent-skills.svg)](https://www.npmjs.com/package/@hybridlabor-api/bdb-dev-optimized-agent-skills)
[![runtime](https://img.shields.io/badge/node-20+-blue.svg)](https://github.com/hybridlabor-api/bdb-dev-optimized-agent-skills)
[![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![skills](https://img.shields.io/badge/skills-144%20kuratiert-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-dev-optimized-agent-skills)

> **Supercharging von KI-Coding-Agenten mit 144 hochkuratierten Skills, 22 lokalen MCPs und tiefgreifenden Integrationen für die Creative-Technology-Branche.**

Willkommen im **BDB DEV Skills & MCP Configuration** Repository. Dieses Projekt dient als Rückgrat unseres Entwicklungs-Ecosystems für Creative & Full-Stack Development. Es erweitert KI-Agenten um hochspezialisierte Fähigkeiten, die speziell auf die Event- und Medientechnologie-Branche sowie auf allgemeine Software-Entwicklung zugeschnitten sind.

Obwohl für **Google Antigravity** optimiert, ist dieses Skill-Paket und die MCP-Konfiguration **100% universell** und funktioniert nahtlos mit allen modernen KI-Agenten und Entwickler-Schnittstellen, einschließlich **ChatGPT Codex / Codex CLI, Claude Desktop, Claude Code, Cursor, Aider, Roo Code, Cline und Windsurf**.

> 🎙 **Audio Deep Dive: "Give AI Agents Control of Creative Software"**  
> <video src="assets/Give_AI_Agents_Control_of_Creative_Software.mp4" controls></video>

---

![BDB v3 Core Tools Overview](assets/bdb_v3_core_tools_overview_sketch.jpg)

### 🪐 Universal Agent Harness (v3.0.0)
Der Installer verfügt jetzt über eine vollautomatische Universal Sync Engine. Er scannt Ihr System nach **Claude Desktop, Cursor, Windsurf, Aider, Roo/Cline** und injiziert die kuratierte MCP-Konfiguration sowie die Godmode-Regeln gleichzeitig in alle Umgebungen.

### 🧩 Ecosystem-Integrationen (v3.0.0)
Dieses Paket dient als Brücke zu zwei gewaltigen vorgelagerten Funktionen (verfügbar als direkte Installationsziele über den Installer):
- **BDB OS Agent Workspace:** Die Orchestrierungsschicht für parallele KI-Agenten. Starten Sie mehrere isolierte Agenten-Sitzungen über Git-Worktrees mit Live-Terminalsteuerung, automatischen CI/CD-Feedbackschleifen und PR-Review-Routing.
- **BDB Creator Extension:** Die leistungsstarke Agentic Media Pipeline. Verleiht Agenten lokale ComfyUI MCP-Fähigkeiten (FLUX, SDXL), Image-to-3D-Generierung (TripoSR, TRELLIS) und automatisierte Videoproduktion über OpenMontage und Remotion.

## 🌟 ~154+ Optimierte Skills (Aktualisiert für v3.6.0)

Wir haben mit einem gewaltigen Pool von über 1.400 rohen KI-Skills begonnen. Nach intensiven Tests, Filterungen und Verfeinerungen haben wir sie zu einem hochkuratierten Set von **154+ Optimierten Skills** destilliert (mit nativer OpenWiki-Dokumentationsengine, dem **lokalen semantischen Gedächtnis memB** und jetzt der **Universal Agent Harness Synchronisation in v3.6.0**).

Diese Skills sind präzise optimiert, damit Agenten keine Zeit mit redundanten Aufgaben verschwenden, sondern mit maximaler Autonomie, strengen Architekturvorgaben und robustem Kontextbewusstsein agieren.

### 🛡️ Die 6 Godmodes (Apex Layer)
Anstatt Agenten durch generische Anweisungen irren zu lassen, setzt die oberste Ebene dieses Repositories sechs **Hochkuratierte Godmodes** durch. Diese fungieren als ultimative Wächter für Ihre Codebasis:
- **`godmode-engineering`**: Erzwingt Domain-Driven Design, strenge TypeScript-Prüfungen, Clean Architecture und systematisches Debugging.
- **`godmode-ui-ux`**: Der Frontend-Goldstandard. Erzwingt BDB "Anti-Slop"-Prinzipien, Barrierefreiheit (Accessibility) und fluide Bewegungsdynamiken.
- **`godmode-shipping`**: Der finale Wächter für Production Releases. Erzwingt Spec-Driven Development, Pre-Launch-Prüfungen und sichere Rollbacks.
- **`godmode-eventtech`**: Das oberste Regelwerk für die BDB Creator Engine, das 3D, Medien und 22 Creative-Tech MCPs steuert.
- **`godmode-eventtech`**: Das oberste Regelwerk für die BDB Creator Engine, das 3D, Medien und 22 Creative-Tech MCPs steuert.
- **`godmode-3d-creation`**: Steuert die Agentic-3D-Pipeline (TripoSR, TRELLIS) für generative Modelle und CAD-Strukturen.
- **`godmode-media-creation`**: Orchestriert automatisierte Videoproduktion, Storytelling und ComfyUI-Generierungsschleifen.

### 💻 Jenseits von Events: Full-Stack Software & Web Agenten
Obwohl stark für die Kreativtechnologie-Branche optimiert, sind diese Skills tief in der Kern-Softwareentwicklung verwurzelt:
- **Autonome Web-Operationen**: Vollständige Suite von Firecrawl-basierten spezialisierten Agenten für strukturierte Datenextraktion, automatisierte Web-Interaktion und komplexe Scraping-Operationen.
- **Full-Stack Entwicklung**: Erstellen von Next.js App Router Boilerplates, Aufbau skalierbarer Node.js Microservices und Gestaltung interaktiver Frontends.
- **App-Entwicklung**: Datenbankarchitektur mit Prisma/Drizzle, Design von REST/GraphQL-APIs und Erstellung von Standard-Web- und Mobilanwendungen von Grund auf.
- **Design & Qualitätssicherung**: Auditierung von UI/UX-Mustern (unter Verwendung von `ui-ux-pro-max`), Durchsetzung von Clean-Code-Prinzipien und Einrichten strenger CI/CD-Pipelines.

---

## 🗂️ Die Umfassende Skill-Bibliothek

Nachfolgend finden Sie die vollständige Übersicht aller in diesem Paket enthaltenen kuratierten Agent-Skills. Diese werden durch den interaktiven Installer automatisch in den Workspace Ihres Agenten einsortiert.

<details>
<summary><strong>👑 Core Godmodes</strong></summary>

| Skill-Name | Beschreibung |
|------------|-------------|
| `godmode-3d-creation` | Orchestrierungs-Master-Skill für alle 3D-Generierungs-, Modellierungs- und Rekonstruktionsaufgaben. Agiert als 3D-Gehirn für die BDB Creator Extension. |
| `godmode-engineering` | BDB Engineering Godmode. Erzwingt strenges Domain-Driven Design, TypeScript-Striktheit, Clean Architecture und systematisches 5-Stufen-Debugging. |
| `godmode-eventtech` | BDB EventTech Godmode. Das oberste Regelwerk für die BDB Creator Engine, das Godmode-3D, Godmode-Media und die 22 Creative-Tech MCPs steuert. |
| `godmode-media-creation` | Orchestrierungs-Master-Skill für alle Medienerstellungsaufgaben (Video, Audio, Bild, Motion Design). Agiert als Gehirn für die BDB Creator Extension. |
| `godmode-shipping` | BDB Shipping Godmode. Der finale Wächter für Production Releases. Erzwingt Spec-Driven Development, strenge Pre-Launch-Prüfungen, Feature Flags und Rollback-Strategien. |
| `godmode-ui-ux` | BDB UI/UX Godmode. Der absolute Goldstandard für Frontend-Design. Erzwingt Anti-Slop-Prinzipien, Enterprise-Barrierefreiheit, fluide Bewegungsdynamiken und datengestützte Design-Generierung über alle Agent-Harnesses hinweg. |

</details>

<details>
<summary><strong>⚙️ System & Konfiguration</strong></summary>

#### 🤖 Agenten & Automatisierung
| Skill-Name | Beschreibung |
|------------|-------------|
| `agent-manager-skill` | Manage multiple local CLI agents via tmux sessions (start/stop/monitor/assign) with cron-friendly scheduling. |
| `agent-memory-mcp` | A hybrid memory system that provides persistent, searchable knowledge management for AI agents (Architecture, Patterns, Decisions). |
| `agent-orchestrator` | Meta-skill que orquestra todos os agentes do ecossistema. Scan automatico de skills, match por capacidades, coordenacao de workflows multi-skill e registry management. |
| `agent-pipeline` | Defines the 6-stage BDB Software Engineering Pipeline (DEFINE, PLAN, BUILD, VERIFY, REVIEW, SHIP) with corresponding slash commands (/spec, /plan, /build, /test, /review, /ship) for AI agent orchestration. |
| `agent-tool-builder` | Tools are how AI agents interact with the world. A well-designed tool is the difference between an agent that works and one that hallucinates, fails silently, or costs 10x more tokens than necessary. This skill covers tool design from schema to error handling. |
| `ai-agent-development` | AI agent development workflow for building autonomous agents, multi-agent systems, and agent orchestration with CrewAI, LangGraph, and custom agents. |
| `apify-lead-generation` | Scrape leads from multiple platforms using Apify Actors. |
| `apify-ultimate-scraper` | AI-driven data extraction from 55+ Actors across all major platforms. This skill automatically selects the best Actor for your task. |
| `bdbrainstorm` | Combines multi-agent brainstorming, the /grill-me slash command, subagent-driven-development, and ui-ux-pro-max to force a comprehensive, multi-agent ideation and UI/UX design workflow. |
| `browser-automation` | Browser automation powers web testing, scraping, and AI agent interactions. The difference between a flaky script and a reliable system comes down to understanding selectors, waiting strategies, and anti-detection patterns. |
| `crewai` | Expert in CrewAI - the leading role-based multi-agent framework used by 60% of Fortune 500 companies. |
| `documentation` | Documentation generation workflow covering API docs, architecture docs, README files, code comments, and technical writing. |
| `git-advanced-workflows` | Master advanced Git techniques to maintain clean history, collaborate effectively, and recover from any situation with confidence. |
| `github-actions-templates` | Production-ready GitHub Actions workflow patterns for testing, building, and deploying applications. |
| `github-repo` | Standards and workflows for writing, formatting, sanitizing, and publishing high-quality GitHub repositories, complementing openwiki-skill. |
| `github-workflow-automation` | Patterns for automating GitHub workflows with AI assistance, inspired by [Gemini CLI](https://github.com/google-gemini/gemini-cli) and modern DevOps practices. |
| `go-playwright` | Expert capability for robust, stealthy, and efficient browser automation using Playwright Go. |
| `google-sheets-automation` | Lightweight Google Sheets integration with standalone OAuth authentication. No MCP server required. Full read/write access. |
| `n8n-code-javascript` | Write JavaScript code in n8n Code nodes. Use when writing JavaScript in n8n, using $input/$json/$node syntax, making HTTP requests with $helpers, working with dates using DateTime, troubleshooting Code node errors, or choosing between Code node modes. |
| `n8n-code-python` | Write Python code in n8n Code nodes. Use when writing Python in n8n, using _input/_json/_node syntax, working with standard library, or need to understand Python limitations in n8n Code nodes. |
| `n8n-expression-syntax` | Validate n8n expression syntax and fix common errors. Use when writing n8n expressions, using {{}} syntax, accessing $json/$node variables, troubleshooting expression errors, or working with webhook data in workflows. |
| `n8n-mcp-tools-expert` | Expert guide for using n8n-mcp MCP tools effectively. Use when searching for nodes, validating configurations, accessing templates, managing workflows, or using any n8n-mcp tool. Provides tool selection guidance, parameter formats, and common patterns. |
| `n8n-workflow-patterns` | Proven architectural patterns for building n8n workflows. |
| `notion-automation` | Automate Notion tasks via Rube MCP (Composio): pages, databases, blocks, comments, users. Always search tools first for current schemas. |
| `os-scripting` | Operating system and shell scripting troubleshooting workflow for Linux, macOS, and Windows. Covers bash scripting, system administration, debugging, and automation. |
| `rag-implementation` | RAG (Retrieval-Augmented Generation) implementation workflow covering embedding selection, vector database setup, chunking strategies, and retrieval optimization. |
| `slack-automation` | Automate Slack workspace operations including messaging, search, channel management, and reaction workflows through Composio's Slack toolkit. |
| `subagent-driven-development` | Use when executing implementation plans with independent tasks in the current session |
| `tdd-workflow` | Test-Driven Development workflow principles. RED-GREEN-REFACTOR cycle. |
| `tmux` | Expert tmux session, window, and pane management for terminal multiplexing, persistent remote workflows, and shell scripting automation. |

#### 🎨 Frontend & UI/UX
| Skill-Name | Beschreibung |
|------------|-------------|
| `MCP_Manage` | Manages the BDB specialized MCP servers including Unreal Engine, Rhino 7/8, DaVinci Resolve, grandMA3, Resolume, GitHub, Chrome DevTools, and TouchDesigner. |
| `api-design-principles` | Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time. |
| `api-patterns` | API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination. |
| `database-design` | Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases. |
| `design-taste-frontend` | Use when building high-agency frontend interfaces with strict design taste, calibrated color, responsive layout, and motion rules. |
| `drizzle-orm-expert` | Expert in Drizzle ORM for TypeScript — schema design, relational queries, migrations, and serverless database integration. Use when building type-safe database layers with Drizzle. |
| `frontend-design` | You are a frontend designer-engineer, not a layout generator. |
| `frontend-dev-guidelines` | You are a senior frontend engineer operating under strict architectural and performance standards. Use when creating components or pages, adding new features, or fetching or mutating data. |
| `landing-page-generator` | Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO. |
| `llm-application-dev-ai-assistant` | You are an AI assistant development expert specializing in creating intelligent conversational interfaces, chatbots, and AI-powered applications. Design comprehensive AI assistant solutions with natur |
| `nextjs-app-router-patterns` | Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development. |
| `nextjs-best-practices` | Next.js App Router principles. Server Components, data fetching, routing patterns. |
| `openapi-spec-generation` | Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance. |
| `postgres-best-practices` | Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations. |
| `postgresql` | Design a PostgreSQL-specific schema. Covers best-practices, data types, indexing, constraints, performance patterns, and advanced features |
| `prisma-expert` | You are an expert in Prisma ORM with deep knowledge of schema design, migrations, query optimization, relations modeling, and database operations across PostgreSQL, MySQL, and SQLite. |
| `programmatic-seo` | Design and evaluate programmatic SEO strategies for creating SEO-driven pages at scale using templates and structured data. |
| `react-best-practices` | Comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. Use when writing new React components or Next.js pages, implementing data fetching (client or server-side), or reviewing code for performance issues. |
| `react-component-performance` | Diagnose slow React components and suggest targeted performance fixes. |
| `react-patterns` | Modern React patterns and principles. Hooks, composition, performance, TypeScript best practices. |
| `schema-markup` | Design, validate, and optimize schema.org structured data for eligibility, correctness, and measurable SEO impact. |
| `senior-frontend` | Frontend development skill for React, Next.js, TypeScript, and Tailwind CSS applications. Use when building React components, optimizing Next.js performance, analyzing bundle sizes, scaffolding frontend projects, implementing accessibility, or reviewing frontend code quality. |
| `shadcn` | Manages shadcn/ui components and projects, providing context, documentation, and usage patterns for building modern design systems. |
| `software-architecture` | Guide for quality focused software architecture. This skill should be used when users want to write code, design architecture, analyze code, in any case that relates to software development. |
| `spline-3d-integration` | Use when adding interactive 3D scenes from Spline.design to web projects, including React embedding and runtime control API. |
| `tailwind-patterns` | Tailwind CSS v4 principles. CSS-first configuration, container queries, modern patterns, design token architecture. |
| `tanstack-query-expert` | Expert in TanStack Query (React Query) — asynchronous state management. Covers data fetching, stale time configuration, mutations, optimistic updates, and Next.js App Router (SSR) integration. |
| `ui-component` | Generate a new UI component that follows StyleSeed Toss conventions for structure, tokens, accessibility, and component ergonomics. |
| `ui-page` | Scaffold a new mobile-first page using StyleSeed Toss layout patterns, section rhythm, and existing shell components. |
| `ui-pattern` | Generate reusable UI patterns such as card sections, grids, lists, forms, and chart wrappers using StyleSeed Toss primitives. |
| `ui-review` | Review UI code for StyleSeed design-system compliance, accessibility, mobile ergonomics, spacing discipline, and implementation quality. |
| `ui-tokens` | List, add, and update StyleSeed design tokens while keeping JSON sources, CSS variables, and dark-mode values in sync. |
| `ui-ux-pro-max` | Comprehensive design guide for web and mobile applications. Use when designing new UI components or pages, choosing color palettes and typography, or reviewing code for UX issues. |
| `ux-audit` | Audit screens against Nielsen's heuristics and mobile UX best practices using the StyleSeed Toss design language as the implementation context. |
| `ux-feedback` | Add loading, empty, error, and success feedback states to StyleSeed components and pages with practical mobile-first rules. |
| `ux-flow` | Design user flows and screen structure using StyleSeed UX patterns such as progressive disclosure, hub-and-spoke navigation, and information pyramids. |
| `ux-persuasion-engineer` | One sentence - what this skill does and when to invoke it |
| `vercel-ai-sdk-expert` | Expert in the Vercel AI SDK. Covers Core API (generateText, streamText), UI hooks (useChat, useCompletion), tool calling, and streaming UI components with React and Next.js. |
| `wcag-audit-patterns` | Comprehensive guide to auditing web content against WCAG 2.2 guidelines with actionable remediation strategies. |
| `web-artifacts-builder` | To build powerful frontend claude.ai artifacts, follow these steps: |
| `zustand-store-ts` | Create Zustand stores following established patterns with proper TypeScript types and middleware. |

#### 🗄️ Backend & Datenbanken
| Skill-Name | Beschreibung |
|------------|-------------|
| `gemini-api-dev` | The Gemini API provides access to Google's most advanced AI models. Key capabilities include: |
| `gemini-api-integration` | Use when integrating Google Gemini API into projects. Covers model selection, multimodal inputs, streaming, function calling, and production best practices. |
| `github` | Use the `gh` CLI for issues, pull requests, Actions runs, and GitHub API queries. |
| `go-concurrency-patterns` | Master Go concurrency with goroutines, channels, sync primitives, and context. Use when building concurrent Go applications, implementing worker pools, or debugging race conditions. |
| `golang-pro` | Master Go 1.22+ with modern patterns, advanced concurrency, performance optimization, and production-ready microservices. |
| `llm-structured-output` | Get reliable JSON, enums, and typed objects from LLMs using response_format, tool_use, and schema-constrained decoding across OpenAI, Anthropic, and Google APIs. |
| `microservices-patterns` | Master microservices architecture patterns including service boundaries, inter-service communication, data management, and resilience patterns for building distributed systems. |
| `neon-postgres` | Expert patterns for Neon serverless Postgres, branching, connection pooling, and Prisma/Drizzle integration |
| `python-patterns` | Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying. |
| `python-performance-optimization` | Profile and optimize Python code using cProfile, memory profilers, and performance best practices. Use when debugging slow Python code, optimizing bottlenecks, or improving application performance. |
| `python-pro` | Master Python 3.12+ with modern features, async programming, performance optimization, and production-ready practices. Expert in the latest Python ecosystem including uv, ruff, pydantic, and FastAPI. |
| `rag-engineer` | Expert in building Retrieval-Augmented Generation systems. Masters embedding models, vector databases, chunking strategies, and retrieval optimization for LLM applications. |
| `using-neon` | Neon is a serverless Postgres platform that separates compute and storage to offer autoscaling, branching, instant restore, and scale-to-zero. It's fully compatible with Postgres and works with any language, framework, or ORM that supports Postgres. |
| `vector-database-engineer` | Expert in vector databases, embedding strategies, and semantic search implementation. Masters Pinecone, Weaviate, Qdrant, Milvus, and pgvector for RAG applications, recommendation systems, and similar |
| `web-scraper` | Web scraping inteligente multi-estrategia. Extrai dados estruturados de paginas web (tabelas, listas, precos). Paginacao, monitoramento e export CSV/JSON. |
| `webapp-testing` | To test local web applications, write native Python Playwright scripts. |

#### 🚀 DevOps & Infrastruktur
| Skill-Name | Beschreibung |
|------------|-------------|
| `bash-linux` | Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems. |
| `cloudflare-workers-expert` | Expert in Cloudflare Workers and the Edge Computing ecosystem. Covers Wrangler, KV, D1, Durable Objects, and R2 storage. |
| `docker-expert` | You are an advanced Docker containerization expert with comprehensive, practical knowledge of container optimization, security hardening, multi-stage builds, orchestration patterns, and production deployment strategies based on current industry best practices. |
| `git-pr-review` | Generate a concise and structured PR description from commit history with minimal token usage |
| `llm-app-patterns` | Production-ready patterns for building LLM applications, inspired by [Dify](https://github.com/langgenius/dify) and industry best practices. |
| `local-llm-expert` | Master local LLM inference, model selection, VRAM optimization, and local deployment using Ollama, llama.cpp, vLLM, and LM Studio. Expert in quantization formats (GGUF, EXL2) and local AI privacy. |
| `posix-shell-pro` | Expert in strict POSIX sh scripting for maximum portability across Unix-like systems. Specializes in shell scripts that run on any POSIX-compliant shell (dash, ash, sh, bash --posix). |
| `turborepo-caching` | Configure Turborepo for efficient monorepo builds with local and remote caching. Use when setting up Turborepo, optimizing build pipelines, or implementing distributed caching. |
| `vercel-deployment` | Expert knowledge for deploying to Vercel with Next.js |

#### 🧠 KI & LLM
| Skill-Name | Beschreibung |
|------------|-------------|
| `ai-product` | Every product will be AI-powered. The question is whether you'll build it right or ship a demo that falls apart in production. |
| `llm-prompt-optimizer` | Use when improving prompts for any LLM. Applies proven prompt engineering techniques to boost output quality, reduce hallucinations, and cut token usage. |
| `openwiki-skill` | Direct Gemini-native integration of OpenWiki for autonomous, high-agency documentation management and release notes maintenance. |
| `prompt-engineer` | Transforms user prompts into optimized prompts using frameworks (RTF, RISEN, Chain of Thought, RODES, Chain of Density, RACE, RISE, STAR, SOAP, CLEAR, GROW) |
| `prompt-engineering-patterns` | Master advanced prompt engineering techniques to maximize LLM performance, reliability, and controllability. |

#### 📝 Dokumentation & Planung
| Skill-Name | Beschreibung |
|------------|-------------|
| `architect-review` | Master software architect specializing in modern architecture |
| `concise-planning` | Use when a user asks for a plan for a coding task, to generate a clear, actionable, and atomic checklist. |
| `copywriting` | Write rigorous, conversion-focused marketing copy for landing pages and emails. Enforces brief confirmation and strict no-fabrication rules. |
| `deep-research` | Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports. |
| `executing-plans` | Use when you have a written implementation plan to execute in a separate session with review checkpoints |
| `linear-claude-skill` | Manage Linear issues, projects, and teams |
| `memb-skill` | BDB local-first long-term memory engine (memB). Query, remember, and adapt preferences, code architectures, and developer patterns across tasks. |
| `modern-javascript-patterns` | Comprehensive guide for mastering modern JavaScript (ES6+) features, functional programming patterns, and best practices for writing clean, maintainable, and performant code. |
| `planning-with-files` | Work like Manus: Use persistent markdown files as your "working memory on disk." |
| `product-manager-toolkit` | Essential tools and frameworks for modern product management, from discovery to delivery. |
| `readme` | You are an expert technical writer creating comprehensive project documentation. Your goal is to write a README.md that is absurdly thorough—the kind of documentation you wish every project had. |
| `test-driven-development` | Use when implementing any feature or bugfix, before writing implementation code |
| `writing-plans` | Use when you have a spec or requirements for a multi-step task, before touching code |

#### 🧊 3D & Motion
| Skill-Name | Beschreibung |
|------------|-------------|
| `remotion` | Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays |
| `threejs-skills` | Create 3D scenes, interactive experiences, and visual effects using Three.js. Use when user requests 3D graphics, WebGL experiences, 3D visualizations, animations, or interactive 3D elements. |

#### 📈 SEO & Marketing
| Skill-Name | Beschreibung |
|------------|-------------|
| `geo-fundamentals` | Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity). |
| `seo` | Run a broad SEO audit across technical SEO, on-page SEO, schema, sitemaps, content quality, AI search readiness, and GEO. Use as the umbrella skill when the user asks for a full SEO analysis or strategy. |
| `seo-audit` | Diagnose and audit SEO issues affecting crawlability, indexation, rankings, and organic performance. |
| `seo-technical` | Audit technical SEO across crawlability, indexability, security, URLs, mobile, Core Web Vitals, structured data, JavaScript rendering, and related platform signals like robots.txt and AI crawler access. |

#### 🔧 Core Programmierung & Debugging
| Skill-Name | Beschreibung |
|------------|-------------|
| `clean-code` | This skill embodies the principles of "Clean Code" by Robert C. Martin (Uncle Bob). Use it to transform "code that works" into "code that is clean." |
| `debugger` | Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues. |
| `playwright-skill` | IMPORTANT - Path Resolution: This skill can be installed in different locations (plugin system, manual installation, global, or project-specific). Before executing any commands, determine the skill directory based on where you loaded this SKILL.md file, and use that path in all commands below. |
| `simplify-code` | Review a diff for clarity and safe simplifications, then optionally apply low-risk fixes. |
| `systematic-debugging` | Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes |
| `typescript-pro` | Master TypeScript with advanced types, generics, and strict type safety. Handles complex type systems, decorators, and enterprise-grade patterns. |

#### 📦 Weitere Utilities
| Skill-Name | Beschreibung |
|------------|-------------|
| `bdb-updater` | Proactively check for and install updates to the BDB Antigravity Skills package via NPM. |
| `monorepo-management` | Build efficient, scalable monorepos that enable code sharing, consistent tooling, and atomic changes across multiple packages and applications. |
| `obsidian-markdown` | Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes. |
| `senior-fullstack` | Complete toolkit for senior fullstack with modern tools and best practices. |
| `token-saver-config` | Context window output compression engine for CLI commands (60-99% token reduction). |
| `web-performance-optimization` | Optimize website and web application performance including loading speed, Core Web Vitals, bundle size, caching strategies, and runtime performance |

</details>

<details>
<summary><strong>🌀 BDB Ökosystem & Methodiken</strong></summary>

| Skill-Name | Beschreibung |
|------------|-------------|
| `bdbmediastorm` | The ultimate creative-tech and show-control brainstorming engine. Orchestrates multi-agent ideation focused on signal flow, hardware constraints, protocols, and BDB MCP integrations. Now strictly governed by the 3 Core Godmodes (engineering, ui-ux, shipping). |
| `bdbrainstorm` | Combines multi-agent brainstorming, the /grill-me slash command, and the 3 Core Godmodes (godmode-engineering, godmode-ui-ux, godmode-shipping) to force a comprehensive, multi-agent ideation and technical design workflow. |
| `github-repo` | Standards and workflows for writing, formatting, sanitizing, and publishing high-quality GitHub repositories, complementing openwiki-skill. |
| `memb-ingest` | Deep scan and ingest project files (.md, .json, agent.md, .openwiki) and past conversation logs into the local memB vector memory engine. |

</details>

<details>
<summary><strong>🔥 Spezialisierte Workspace-Agenten</strong></summary>

#### 🤖 Agenten & Automatisierung
| Skill-Name | Beschreibung |
|------------|-------------|
| `firecrawl-agent` | AI-powered autonomous data extraction that navigates complex sites and returns structured JSON. Use this skill when the user wants structured data from websites, needs to extract pricing tiers, product listings, directory entries, or any data as JSON with a schema. Triggers on "extract structured data", "get all the products", "pull pricing info", "extract as JSON", or when the user provides a JSON schema for website data. More powerful than simple scraping for multi-page structured extraction. |
| `firecrawl-build-onboarding` | Get Firecrawl credentials and SDK setup into a project. Use when an application needs `FIRECRAWL_API_KEY`, when an agent should add Firecrawl to `.env`, when the user wants to authenticate Firecrawl for app code, or when choosing the first SDK and docs for a new Firecrawl integration. This skill includes its own browser auth flow, so it does not depend on the website onboarding skill. |
| `firecrawl-build-search` | Integrate Firecrawl `/search` into product code and agent workflows. Use when an app needs discovery before extraction, when the feature starts with a query instead of a URL, or when the system should search the web and optionally hydrate result content. |

#### 🗄️ Backend & Datenbanken
| Skill-Name | Beschreibung |
|------------|-------------|
| `firecrawl-build` | Integrate Firecrawl into product code for web scraping, crawling, searching, and interaction. Use this skill when an application needs to access web data, extract content, or automate web interactions. |
| `firecrawl-build-interact` | Integrate Firecrawl `/interact` into product code for dynamic pages and browser actions after scraping. Use when a feature needs clicks, form fills, pagination, authentication-aware flows, or other multi-step interactions that plain `/scrape` cannot complete. |
| `firecrawl-download` | Download an entire website as local files — markdown, screenshots, or multiple formats per page. Use this skill when the user wants to save a site locally, download documentation for offline use, bulk-save pages as files, or says "download the site", "save as local files", "offline copy", "download all the docs", or "save for reference". Combines site mapping and scraping into organized local directories. |
| `firecrawl-interact` | Control and interact with a live browser session on any scraped page — click buttons, fill forms, navigate flows, and extract data using natural language prompts or code. Use when the user needs to interact with a webpage beyond simple scraping: logging into a site, submitting forms, clicking through pagination, handling infinite scroll, navigating multi-step checkout or wizard flows, or when a regular scrape failed because content is behind JavaScript interaction. Also useful for authenticated scraping via profiles. Triggers on "interact", "click", "fill out the form", "log in to", "sign in", "submit", "paginated", "next page", "infinite scroll", "interact with the page", "navigate to", "open a session", or "scrape failed". |

#### 🚀 DevOps & Infrastruktur
| Skill-Name | Beschreibung |
|------------|-------------|
| `firecrawl` | Search, scrape, and interact with the web via the Firecrawl CLI. Use this skill whenever the user wants to search the web, find articles, research a topic, look something up online, scrape a webpage, grab content from a URL, get data from a website, crawl documentation, download a site, or interact with pages that need clicks or logins. Also use when they say "fetch this page", "pull the content from", "get the page at https://", or reference external websites. This provides real-time web search with full page content and interact capabilities — beyond what Claude can do natively with built-in tools. Do NOT trigger for local file operations, git commands, deployments, or code editing tasks. |

#### 🧠 KI & LLM
| Skill-Name | Beschreibung |
|------------|-------------|
| `firecrawl-scrape` | Extract clean markdown from any URL, including JavaScript-rendered SPAs. Use this skill whenever the user provides a URL and wants its content, says "scrape", "grab", "fetch", "pull", "get the page", "extract from this URL", or "read this webpage". Handles JS-rendered pages, multiple concurrent URLs, and returns LLM-optimized markdown. Use this instead of WebFetch for any webpage content extraction. |

#### 📝 Dokumentation & Planung
| Skill-Name | Beschreibung |
|------------|-------------|
| `firecrawl-crawl` | Bulk extract content from an entire website or site section. Use this skill when the user wants to crawl a site, extract all pages from a docs section, bulk-scrape multiple pages following links, or says "crawl", "get all the pages", "extract everything under /docs", "bulk extract", or needs content from many pages on the same site. Handles depth limits, path filtering, and concurrent extraction. |

#### 📦 Weitere Utilities
| Skill-Name | Beschreibung |
|------------|-------------|
| `firecrawl-build-scrape` | Integrate Firecrawl `/scrape` into product code for single-page extraction. Use when an app already has a URL and needs markdown, HTML, links, screenshots, metadata, or structured page output. Prefer this skill over broader crawl patterns when the feature is page-level. |
| `firecrawl-map` | Discover and list all URLs on a website, with optional search filtering. Use this skill when the user wants to find a specific page on a large site, list all URLs, see the site structure, find where something is on a domain, or says "map the site", "find the URL for", "what pages are on", or "list all pages". Essential when the user knows which site but not which exact page. |
| `firecrawl-search` | Web search with full page content extraction. Use this skill whenever the user asks to search the web, find articles, research a topic, look something up, find recent news, discover sources, or says "search for", "find me", "look up", "what are people saying about", or "find articles about". Returns real search results with optional full-page markdown — not just snippets. Provides capabilities beyond Claude's built-in WebSearch. |

</details>


---

## 🔄 BDB Software Engineering Pipeline & Slash-Befehle

```text
 IDEATE & MEDIA STORM     DEFINE & SCAFFOLD      PLAN & SPEC      BUILD & MCPs       VERIFY        SHIP
 ┌──────────────────┐    ┌─────────────────┐    ┌───────────┐    ┌────────────┐   ┌──────────┐   ┌──────────┐
 │ Grill Me & Media │ ──▶│  Folder Select  │ ──▶│ Spec &    │ ──▶│ Subagents  │──▶│ QA Gate  │──▶│ OpenWiki │
 │   Brainstorming  │    │ OpenWiki & Repo │    │   Plan    │    │ & MCP Dev  │   │ Review   │   │  & Push  │
 └──────────────────┘    └─────────────────┘    └───────────┘    └────────────┘   └──────────┘   └──────────┘
/grill-me /bdbmediastorm  /openwiki /github-repo    /plan          /subagents       /review        /ship
```

KI-Agenten folgen diesem strukturierten Lebenszyklus, der tief in die Philosophie von **BDBrainstorm** und **BDBMediaStorm** integriert ist:

- **1. IDEATE & MEDIA STORM (`/grill-me`, `/bdbrainstorm`, `/bdbmediastorm`)**: Ideen aktiv hinterfragen oder Multi-Agenten-Medien/Event-Tech-Brainstorming durchführen. Startet spezialisierte Subagenten (CI/Design Expert, Real Time Architect, MCP Implementer) zur Validierung von Hardware, 3D-Szenografie (Rhino, Blender, Unreal), Protokollen (OSC, Art-Net) und MCP-Kompatibilität.
- **2. DEFINE & SCAFFOLD (`openwiki-skill`, `github-repo`)**: Ziel-Workspace-Verzeichnis mit dem Benutzer bestätigen, anschließend autonom Projektdokumentation, `agent.md`, `.openwiki/`-Strukturen und GitHub-Repo-Standards initialisieren.
- **3. PLAN (`/plan`)**: Technische Design-Spezifikationen, PRD und dateiweise Entwicklungspläne unter strikter Einhaltung der `ui-ux-pro-max`-Standards erstellen.
- **4. BUILD (`/subagents`)**: Subagenten-gesteuerte Entwicklung. Der Master-Orchestrierer delegiert spezifische Komponentenerstellung, Node-Patching und Refactoring-Aufgaben an unabhängige Subagenten.
- **5. VERIFY & REVIEW (`/review`)**: Durchführung von QA-Gate-Reviews, Secret-Scans, Unit-Test-Suites und strengen UI/UX- oder Signalfluss-Audits.
- **6. SHIP (`/ship`)**: Committen, private Repositories pushen, OpenWiki-Dokumente autonom aktualisieren und live deployen.

---

## 🧠 BDBrainstorm: Die Ultimative Ideations-Engine

Teil dieses optimierten Arsenals ist unsere proprietäre **BDBrainstorm**-Skill.

BDBrainstorm kombiniert Multi-Agenten-Brainstorming, den Slash-Befehl `/grill-me`, Subagenten-Entwicklung und extrem hochstehende UI/UX-Design-Workflows, um einen umfassenden Multi-Agenten-Ideationsprozess zu erzwingen. Es unterzieht Designs einem Stresstest, architekturiert die dahinterstehenden Systeme und liefert umsetzbare, hochpräzise Entwicklungspläne.

---

## 🔌 22 Custom Lokale MCP Integrationen

![BDB Architecture Sketch](bdb_architecture_sketch.jpg)

Anstatt sich auf rudimentäre Python-Mocks oder fehlerhafte Remote-APIs zu verlassen, bündelt dieses Repository **22 eigene, lokale MCP-Wrapper** (im Ordner `mcps/`). Diese werden automatisch erstellt/aufgewärmt und ermöglichen Ihrem KI-Assistenten das Lesen, Schreiben und Ausführen von Befehlen in der führenden Kreativsoftware der Branche.

<details>
<summary><strong>🎨 Adobe Creative Cloud (Illustrator, Photoshop, After Effects, Premiere Pro)</strong></summary>

Wir bieten eine Dual-Engine-Architektur, die für macOS- und Windows-Umgebungen optimiert ist:
- **Direct OS-Native Bridge (`bdb_adobe_mcp`)**: Führt Skripte ohne Installation aus.
  - **macOS:** Spricht Anwendungs-Bundle-IDs direkt über AppleScript `do javascript` / `DoScript`-Befehlsstreams an.
  - **Windows:** Fragt lokale COM-Objekte über PowerShell-Wrapper-Skripte automatisch ab, instanziiert sie und führt temporären `.jsx` ExtendScript-Code aus.
- **Cross-Platform UXP WebSocket Bridge (`bdb_adobe_uxp_mcp`)**: Ein Drei-Stufen-WebSocket-Proxy (Node.js-Server auf Port 8080 + native UXP-Entwickler-Plugins) für tiefe DOM-Manipulation und persistente WebSocket-Sitzungen in Photoshop und Premiere Pro, der auf Windows und macOS identisch läuft.
</details>

<details>
<summary><strong>🎬 DaVinci Resolve (Dreifachabdeckung)</strong></summary>

- **Hauptserver: `bdb_davinci_mcp`**: Funktioniert sowohl in der **Free- als auch Studio-Version** über eine Skript-Menüschleife im Workspace. Stellt 162 Tools bereit (Timeline, Clips, Marker, Color Grades, Fusion) und enthält lokale CPU-basierte KI-Modelle (Meta Demucs v4 für Stimmisolierung, faster-whisper für Auto-Untertitel und rembg für Hintergrundentfernung).
- **Studio: `bdb_davinci_mcp_studio`**: Der offizielle Node.js-Server (basiert auf samuelgursky) für fortgeschrittenes, direktes Timeline- und Projektmanagement in Resolve Studio.
- **Fallback: `bdb_davinci_mcp_fallback`**: Professioneller Hoyt-Harness-Python-Server für Studio-Scripting.
</details>

<details>
<summary><strong>📐 Rhino 3D & Grasshopper (Twin-Engine)</strong></summary>

- **Hauptserver: `bdb_rhino_mcp`**: Offizieller McNeel-Konnektor (verwaltet über Yak-Router) zum nativen Lesen/Schreiben von Rhino-Geometrielayouts.
- **Fallback: `bdb_rhino_mcp_fallback`**: Der GOLEM 3D-Server mit 105 Tools zur dynamischen Manipulation von Rhino 8 Assets, Skriptausführung und Lösung von Grasshopper-Definitionen.
</details>

<details>
<summary><strong>🏗️ Weitere Spezialisierte Integrationen (Unreal, TouchDesigner, Vectorworks etc.)</strong></summary>

### 🏗️ Vectorworks
- **Hauptserver: `bdb_vectorworks_mcp`**: Semantischer RAG-basierter Suchindex über VectorScript- und Vectorworks-API-Dokumentation (Port 8765) für automatisiertes CAD-Drafting.

### 🎮 Unreal Engine
- **Hauptserver: `bdb_unreal_mcp`**: Verbindet sich über die Unreal Engine 5 Web Remote Control API (Port 30010) und das `gimmeDG`-Toolset. Ermöglicht dem Agenten das Abfragen, Spawnen von Actoren, Bearbeiten von Materialien, Schreiben von Blueprints und Automatisieren von Level/Sequencer-Steuerungen.

### 🧊 Blender (Twin-Engine)
- **Hauptserver: `bdb_blender_mcp`**: BlenderMCP Socket-Integration für Szenenlayout, Mesh-Generierung und Viewport-Steuerung.
- **Fallback: `bdb_blender_mcp_fallback`**: djeadas Python-Server zur Verwaltung von Blender TCP-Verbindungen und rohem Python-Scripting.

### 🎛️ TouchDesigner (Twin-Engine)
- **Hauptserver: `bdb_touchdesigner_mcp`**: MindDesigner-Bridge (`tdmcp`) auf Port 9980 zum Lesen und Schreiben von Netzwerken über eigene `.tox`-Strukturen.
- **Fallback: `bdb_touchdesigner_mcp_fallback`**: Fallback-TCP-basierte Knotenabfrage und Inspector.

### 💡 grandMA3 & Resolume
- **grandMA3**: `bdb_ma3_mcp` sendet OSC/UDP-Befehlsstreams direkt an Ihre grandMA3-Konsole (Port 8000), um Cues, Makros und Fixture-Patching zu automatisieren.
- **Resolume**: `bdb_resolume_mcp` bindet Arenas REST-API ein (Port 8080), um Ebenen zu steuern, Status abzufragen und Clips auszulösen.

### 🖥️ OS Control (Dual-Engine)
- **macOS/Linux: `zavora_computer_use`**: Ausgeliefert mit vorkompilierten nativen Rust NAPI-Binärobjekten (macOS arm64/x64, Linux) zur Steuerung von Maus, Tastatur, Fenstern und Apps ohne Laufzeit-Kompilierungsfehler.
- **Windows: `bdb_windows_computer_use`**: Nativer Python-basierter Win32 / COM / UIAutomation-Controller mit lokaler OCR-Unterstützung (Tesseract) für fortgeschrittene Windows GUI-Automatisierung.

### 🧠 Local Semantic Brain (memB)
- **`memb_mcp`**: Stellt Standard-Langzeitgedächtnis-Tools (`add_memory`, `search_memory`, `delete_memory`, `list_memories`) über eine vollständig lokale, Offline-First Vektor-Engine bereit (angetrieben von einem mitgelieferten 30MB ONNX-Modell und SQLite).
</details>

---

## 📖 14 Spezialisierte System-Skills

Dieses Repository enthält außerdem 14 Tiefensystem-Konfigurationen und Dokumentationsrichtlinien, die automatisch zugewiesen werden. Wenn ein KI-Agent dieses Paket importiert, liest er sofort diese Markdown-Dateien, um Tool-Signaturen, erwartete Argumente, ExtendScript-Hooks und häufige Fehlerbehebungsschritte für jede Anwendung zu lernen.

<details>
<summary><strong>System-Skill-Liste anzeigen</strong></summary>

- [`bdb-unreal-mcp.md`](skills/global_config/bdb-unreal-mcp.md)
- [`bdb-rhino-mcp.md`](skills/global_config/bdb-rhino-mcp.md)
- [`bdb-davinci-mcp.md`](skills/global_config/bdb-davinci-mcp.md)
- [`bdb-blender-mcp.md`](skills/global_config/bdb-blender-mcp.md)
- [`bdb-after-effects-mcp.md`](skills/global_config/bdb-after-effects-mcp.md)
- [`bdb-vectorworks-mcp.md`](skills/global_config/bdb-vectorworks-mcp.md)
- [`bdb-touchdesigner-mcp.md`](skills/global_config/bdb-touchdesigner-mcp.md)
- [`bdb-computer-use-mcp.md`](skills/global_config/bdb-computer-use-mcp.md)
- [`bdb-grandma3-mcp.md`](skills/global_config/bdb-grandma3-mcp.md)
- [`bdb-resolume-mcp.md`](skills/global_config/bdb-resolume-mcp.md)
- [`bdb-adobe-suite-mcp.md`](skills/global_config/bdb-adobe-suite-mcp.md)
- [`bdb-memb-mcp.md`](skills/global_config/bdb-memb-mcp.md)
- [`openwiki-skill`](skills/global_config/openwiki-skill/SKILL.md): Direct Gemini-native integration of OpenWiki for autonomous, high-agency documentation management and release notes maintenance.
- [`memb-skill`](skills/global_config/memb-skill/SKILL.md): BDB local-first long-term memory engine (memB). Query, remember, and adapt preferences, code architectures, and developer patterns across tasks.
</details>

---

## 🌐 OpenWiki & RepoGraph Code Health Engine (v2.4.0)

Die **OpenWiki Engine** verwaltet autonom lebendige Codebasis-Dokumentation, Architektur-Spezifikationen, ADRs, Release Notes und Echtzeit-Code-Health-Analysen über alle Ihre aktiven Projekte hinweg.

### 📚 Dokumentation & Dashboard
- **Entrypoint & Setup:** [.openwiki/quickstart.md](.openwiki/quickstart.md)
- **Architecture & Ecosystem:** [.openwiki/architecture.md](.openwiki/architecture.md)
- **Design Decisions (ADRs):** [.openwiki/decisions.md](.openwiki/decisions.md)
- **Changelog & History:** [.openwiki/release_notes.md](.openwiki/release_notes.md)
- **Code Health Report:** [.openwiki/code_health.md](.openwiki/code_health.md)
- **Interactive Live Dashboard:** [.openwiki/code_health_dashboard.html](.openwiki/code_health_dashboard.html)

<details>
<summary><strong>🧠 Multi-Provider LLM & Zero-Token RepoGraph Architektur</strong></summary>

1. **Multi-Provider LLM Agility:** Decoupled from single-vendor lock-in. Configure any LLM backend via environment variables:
   - **Google GenAI:** `gemma-4-26b-a4b-it` (Standard via `google-genai` SDK, mit automatischem Modell-Discovery-Fallback)
   - **Groq:** `llama-3.3-70b-versatile` (ultra-low latency)
   - **Grok / xAI:** `grok-2-latest`
   - **Nvidia NIM:** `meta/llama-3.3-70b-instruct`
   - **OpenRouter:** `anthropic/claude-3.5-sonnet` (200+ models)
   - **OpenAI:** `gpt-4o-mini` / `gpt-4o`
   - **Offline / Local:** Ollama (`llama3`), LM Studio, or any OpenAI-compatible endpoint.
2. **RepoGraph Zero-Token Git Analytics:** Analyzes 90-day hotspot velocity, single-author bus factor risk, and maintainability index purely through deterministic local Git analysis—costing **0 LLM tokens**.
3. **Repowise-Grade Live HTML Dashboard:** `.openwiki/code_health_dashboard.html` provides 6 visual SVG panels (Galaxy Cluster Map, Risk Donut, Bus Factor Matrix, Commit Velocity Churn, Hotspot Leaderboard, Architecture Health Radar) with **60-second live auto-refresh** and integrated memB ADR telemetry.
</details>

<details>
<summary><strong>⚙️ Einrichten des Hintergrund-Daemons</strong></summary>

Um sicherzustellen, dass Ihre Projektdokumentation und Code-Health-Dashboards niemals veralten, konfigurieren Sie den Hintergrund-Daemon:

#### On macOS (LaunchAgent)
```bash
bash ~/.gemini/config/skills/openwiki-skill/scripts/install_daemon.sh
```

#### On Windows (Task Scheduler)
```powershell
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.gemini\config\skills\openwiki-skill\scripts\install_daemon.ps1"
```

#### Für alle Plattformen: Projekte registrieren & überwachen
**Projekte registrieren:** Fügen Sie Workspace-Pfade zu Ihrer Konfigurationsdatei unter `~/.openwiki/projects.json` hinzu:
```json
{
  "projects": [
    "~/bdb-dev/bdb-dev-optimized-agent-skills",
    "~/Projects/your-active-project"
  ],
  "interval_seconds": 3600
}
```

**Ausführung überwachen:** Verfolgen Sie die aktiven Logs, um den Rebuild-Status der Hintergrund-Dokumentation zu prüfen:
```bash
tail -f ~/.openwiki/daemon.log
```
</details>

---

## 🖥️ BDB OS Agent Workspace: Parallele Multi-Agenten-Orchestrierung (v3.0.0)

[![Repo](https://img.shields.io/badge/repo-bdb--os--agent--workspace-blue.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
[![harness](https://img.shields.io/badge/orchestrierung-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
[![terminal](https://img.shields.io/badge/terminal-Live%20Steuerung-purple.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
[![license](https://img.shields.io/badge/lizenz-Apache%202.0-blue.svg)](LICENSE)

**BDB OS Agent Workspace** ist der Desktop-Meta-Harness und die Orchestrierungsschicht für parallele KI-Agenten. Er ermöglicht Entwicklern das gleichzeitige Starten, Verwalten und Koordinieren mehrerer isolierter Agenten-Sitzungen über unabhängige Git-Worktrees mit Echtzeit-Terminal-Feedbackschleifen und automatisiertem PR-Review-Routing.

```mermaid
flowchart TD
    A[Desktop IDE Meta-Harness] --> B[Git Worktree Orchestrator]
    B --> C[Agenten-Sitzung 1: Feature Entwicklung]
    B --> D[Agenten-Sitzung 2: Refactoring]
    B --> E[Agenten-Sitzung N: Test & Verifikation]
    C --> F[Live-Terminalsteuerung & Prozessmonitor]
    D --> F
    E --> F
    F --> G[Automatische CI/CD-Feedbackschleifen]
    G --> H[PR-Review & Merge-Routing]
    H --> I[Zentrales Git-Repository]
```

<details>
<summary><strong>⚙️ Architektur & Worktree-Orchestrierung</strong></summary>

- **Git-Worktree-Isolierung:** Instanziiert dedizierte, saubere Arbeitsbäume für jede Subagenten-Sitzung, was Dateistatus-Korruption und Lockfile-Kollisionen bei parallelen Bearbeitungen verhindert.
- **Desktop Meta-Harness:** Koordiniert Multi-Workspace-Setups, Umgebungsvariablen und lokale Server-Ports über parallele Entwicklungsumgebungen hinweg.
- **Parallele Agenten-Ausführung:** Startet autonome Agenten, die gleichzeitig an separaten Modulen, Features oder Bugfixes arbeiten, ohne den Hauptzweig des Workspaces zu beeinträchtigen.
</details>

<details>
<summary><strong>🔬 Technische Spezifikationen & Automatisiertes Routing</strong></summary>

- **Live-Terminalsteuerung:** Erfasst Stdout/Stderr-Streams von Subagenten mit aktiver Prozessüberwachung, Sitzungs-Lebenszyklussteuerung und Statusberichten in Echtzeit.
- **Automatische CI/CD-Feedbackschleifen:** Überwacht Testausgaben und Build-Aufgaben und leitet Fehlerspuren direkt in den Kontext des ausführenden Subagenten zur sofortigen Reparatur zurück.
- **PR-Review-Routing:** Bündelt fertiggestellte Features, führt automatisierte Sicherheits- und Code-Health-Prüfungen durch und leitet generierte Pull Requests zur Überprüfung oder zum automatischen Mergen weiter.
</details>

<details>
<summary><strong>🔌 Unterstützte Harnesses & Direkter Repository-Link</strong></summary>

- **Unterstützte Agenten-Harnesses:**
  - **Google Antigravity / AGY CLI**
  - **Claude Desktop & Claude Code**
  - **Cursor & Windsurf**
  - **Roo Code & Cline**
  - **ChatGPT Codex / Codex CLI**
  - **Aider & VS Code**
- **Direktes Repository:** Greifen Sie auf den Workspace-Orchestrator unter [github.com/hybridlabor-api/bdb-os-agent-workspace](https://github.com/hybridlabor-api/bdb-os-agent-workspace) zu.

```bash
git clone https://github.com/hybridlabor-api/bdb-os-agent-workspace.git
```
</details>

---

## 🎨 BDB Creator Extension: Heavy-Lifting Medien- & 3D-Compute-Pipeline (v3.0.0)

[![Repo](https://img.shields.io/badge/repo-bdb--dev--creator--extension-blue.svg)](https://github.com/hybridlabor-api/bdb-dev-creator-extension)
[![compute](https://img.shields.io/badge/compute-CUDA%20%2F%20ML-orange.svg)](https://github.com/hybridlabor-api/bdb-dev-creator-extension)
[![3D Engine](https://img.shields.io/badge/3D-TRELLIS%20%7C%20TripoSR-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-dev-creator-extension)
[![ComfyUI](https://img.shields.io/badge/ComfyUI-FLUX%20%7C%20SDXL%20%7C%20Wan2.1-red.svg)](https://github.com/hybridlabor-api/bdb-dev-creator-extension)
[![license](https://img.shields.io/badge/lizenz-Apache%202.0-blue.svg)](LICENSE)

**BDB Creator Extension** (`bdb-dev-creator-extension`) ist die hochleistungsfähige Medien-Compute-Pipeline, die entwickelt wurde, um das Kern-Skill-Paket schnell, leichtgewichtig und reaktionsschnell zu halten (<25MB). Sie kapselt CUDA/ML-Neuronale Netze, 3D-Mesh-Synthese, parametrische CAD-Generierung, automatisierten Videoschnitt und lokale ComfyUI-Rendering-Engines aus.

```mermaid
flowchart LR
    A[Kern-Skills Agent] -->|MCP-Anfrage| B[BDB Creator Extension Router]
    B --> C[3D-Generierungs-Suite]
    B --> D[Cinema-Video-Suite]
    B --> E[Lokale ComfyUI MCP Engine]
    C --> C1[TRELLIS: High-Fidelity 3D]
    C --> C2[TripoSR: Schnelles Mesh <0,5s]
    C --> C3[CadQuery: Text-to-CAD]
    D --> D1[OpenMontage AI Director]
    D --> D2[Remotion Video-Shotcraft]
    D --> D3[Palmier Pro NLE MCP Server]
    E --> E1[FLUX.1 Bildgenerierung]
    E --> E2[SDXL Pipeline]
    E --> E3[Wan2.1 Video Diffusion]
    C1 & C2 & C3 & D1 & D2 & D3 & E1 & E2 & E3 --> F[Gerenderte Medien & Räumliche Assets]
```

<details>
<summary><strong>🔷 3D-Generierungs-Suite (`engines/3d/`)</strong></summary>

- **Microsoft TRELLIS:** Hochpräzise Image-to-3D-Asset-Generierung zur Erstellung texturierter 3D-Meshes und NeRF/Gaussian-Splat-Darstellungen.
- **Stability AI TripoSR:** Ultraschnelle Single-Image-zu-3D-Mesh-Generierung unter einer halben Sekunde (<0,5s) für zügiges räumliches Prototyping.
- **CadQuery Parametrisches Text-to-CAD:** Generiert präzise Ingenieursmodelle und architektonische Geometrie in den Formaten STEP, STL und URDF.
</details>

<details>
<summary><strong>🎬 Cinema-Video-Suite (`engines/video/`)</strong></summary>

- **OpenMontage AI Orchestrator:** Automatisiertes Video-Storytelling, Skript-zu-Timeline-Montage und Shot-Sequenzierung.
- **Remotion Video-Shotcraft:** Über 100 erstklassige programmatische Videokomponenten und Motion-Graphics-Templates auf React-Basis.
- **Palmier Pro NLE MCP Server:** Echtzeit-HTTP-MCP-Brücke (`http://127.0.0.1:19789/mcp`), die native macOS NLE-Videobearbeitungsfunktionen bereitstellt.
</details>

<details>
<summary><strong>🎨 Lokale ComfyUI MCP Engine & Direkter Repository-Link (`mcps/comfyui-mcp/`)</strong></summary>

- **Model Context Protocol Integration:** Stellt lokale ComfyUI-Workflows als ausführbare Tools für KI-Agenten über MCP bereit.
- **Unterstützte Generative Modelle:**
  - **FLUX.1:** Hochauflösende Bildsynthese und präzise Prompt-Befolgung.
  - **SDXL:** Latent-Diffusion-Workflow-Steuerung mit benutzerdefinierten LoRAs und ControlNets.
  - **Wan2.1:** Generative Video-Diffusionsmodelle für die Erstellung von Clips mit hoher Bildrate.
- **Direktes Repository:** Greifen Sie auf die Extension-Suite unter [github.com/hybridlabor-api/bdb-dev-creator-extension](https://github.com/hybridlabor-api/bdb-dev-creator-extension) zu.

```bash
git clone https://github.com/hybridlabor-api/bdb-dev-creator-extension.git
```
</details>

---

## 🧠 memB: Eigenes Semantisches Gedächtnis (v2.2.1)

BDB OS führt ein vollständig integriertes, lokales Offline-First Semantisches Gedächtnis auf Basis von **memB** ein. Es bietet Zero-Compute-Kontext für SLMs und eine AI-First Flat-File-Vault-Architektur.

<details>
<summary><strong>⚙️ Wie das Ökosystem funktioniert (Skills, Vaults & Obsidian)</strong></summary>

### 1. Ingestion via the `/memb-ingest` Skill
The ecosystem includes a deeply integrated skill (`/memb-ingest`). When an agent runs this, the `memb_ingest.py` script recursively scans your project (reading `.openwiki`, `agent.md`, transcripts, and architecture files). 
* **Offline Vector Embeddings:** It bundles a pre-quantized 30MB `all-MiniLM-L6-v2` ONNX model to chunk and store these learnings natively in a fast SQLite vector store (`~/.MemBDB/memb.db`), all without hitting external APIs.

### 2. Autonomous AI-First Vault Generation
Once ingestion completes, memB natively generates a **physical Markdown Vault** (`~/.MemBDB/memB_Vault`) structured around a strict "God Mode" radial topology:
* **Zero-Compute Context:** A universal `agent.md` and a master `God_Mode.md` are written to the root. Small 30MB local inference models can instantly orient themselves macroscopically by reading these physical files without spending context tokens on complex database calls.
* **Micro-Targeted RAG:** For precise execution, the small LLMs query the vector DB to retrieve just the exact 3-5 sub-files needed.

### 3. The Obsidian Visualization Plugin
memB includes a native **Obsidian Plugin** (`obsidian-memb-plugin`) that acts as a visual UI over your physical vault.
* **Top-Down Radial Tree:** It reads the generated `memB_Vault` and maps it visually using Obsidian's graph view. 
* By strictly using directional parent-to-child links (e.g., God Mode -> Projects -> Category -> Neuron), the Obsidian graph blossoms outward like a flower, completely preventing the "black hole" context clustering seen in unstructured graph databases.

### 4. Data Sovereignty & Security
* **Zero Telemetry:** Absolute data sovereignty with no remote tracking.
* **Secret Filtration:** Blocks passwords, raw API keys, and connection strings before injection.
</details>

---

## ⚡ Heimdall Token Saver: CLI Kontext-Komprimierung (v2.6.3)

![Heimdall Savings Graph](bdb_savings_graph_sketch.jpg)

**Heimdall Token Saver** ist eine ultraschnelle Kontext-Komprimierungsengine, die entwickelt wurde, um die Kontextfenster-Nutzung bei CLI-Tool-Ausgaben in KI-Agenten-Workflows drastisch zu reduzieren.

<details>
<summary><strong>⚙️ Zweck & Leistung</strong></summary>

- **Automatic CLI Output Context Compression:** Reduces token overhead by **60–99%** on high-volume CLI tool outputs without impacting agent understanding.
- **Zero Information Loss Guarantee:** Preserves all error messages, failed assertions, stack traces, exit codes, and actionable debugging context while stripping redundant whitespace, progress spinners, and repetitive logs.
- **Automatic Secret Redaction:** Automatically detects and redacts passwords, tokens, API keys, and sensitive environment variables prior to inserting command output into agent context windows.
</details>

<details>
<summary><strong>🔬 Technische Spezifikationen & Prozessoren</strong></summary>

- **36 Specialized Processors:** Includes tailored compression rules for:
  - **Version Control & Dev Tools:** `git` (status, diff, log, branch)
  - **Testing Frameworks:** `pytest`, `jest`, `cargo test`, `vitest`, `go test`
  - **Containers & Infrastructure:** `docker`, `kubectl`, `terraform`
  - **Package Managers & Build Systems:** `npm`, `yarn`, `pnpm`, `pip`, `cargo`, `go` package listings and build outputs
- **Preservation Rules:** Guarantees line numbers, error traces, and exact failure sites remain 100% intact for immediate root-cause diagnosis.
</details>

<details>
<summary><strong>🔌 Agenten-Integration & Hooks</strong></summary>

- **Automated Hook Installation:** Configured and installed seamlessly via `installer.js`.
- **Supported Harnesses:**
  - **Claude Code:** Integrated via `PreToolUse` hook.
  - **Google Antigravity CLI:** Integrated via `AfterTool` hook.

### 📊 CLI-Diagnose & Tooling
Sie können Diagnose- und Benchmarking-Befehle direkt in Ihrem Terminal ausführen:
- **Version prüfen:** `token-saver version`
- **Einsparungen & Nutzungsstatistiken anzeigen:** `token-saver stats`
- **Befehlseinsparungen benchmarken:** `token-saver benchmark '<command>'`
</details>

---

## 🛠️ Installation

### 🆚 Welche Version sollte ich verwenden?

- **Agent Skills Version (`bdb-dev-optimized-agent-skills`)**: Enthält alle optimierten Skills, eine interaktive MCP-Auswahl-UI und **aktive Hintergrund-Daemons**. Es installiert und orchestriert automatisch die lokale semantische Speicher-Engine `memB` und die selbstdokumentierenden `OpenWiki` Git-Hooks. Ideal für vollständig autonomes, langfristiges Projektmanagement.
- **Legacy Antigravity Version (`bdb-antigravity-skills@legacy`)**: Das ursprüngliche Antigravity-Paket.

Der Installer basiert auf einem interaktiven Node-Menü. Er ermöglicht Ihnen:
1. **Backup & Überschreiben**: Sichert bestehende Konfigurationsdateien sicher und überschreibt sie.
2. **Merge**: Führt die neuen Skills, Konfigurationen und benutzerdefinierten lokalen MCP-Pfade mit Ihren bestehenden zusammen.

### Option 1: Fragen Sie Ihren KI-Agenten (Am einfachsten)
Sagen Sie Ihrem Assistenten einfach:
> "Bitte führe `npx -y @hybridlabor-api/bdb-dev-optimized-agent-skills@latest` aus, um das Skills-Paket zu installieren und die lokalen MCP-Server zu konfigurieren."

### Option 2: Kommandozeile (Global via NPX - Empfohlen)
Führen Sie das Skript global in Ihrem Terminal aus. Wir empfehlen, immer `@latest` anzuhängen, um die neueste Version zu laden:

```bash
npx -y @hybridlabor-api/bdb-dev-optimized-agent-skills@latest
```
*(Dieser Befehl funktioniert sowohl auf Mac/Linux-Terminals als auch in der Windows PowerShell!)*

### Option 3: Über Homebrew (macOS)
Wenn Sie auf einem Mac arbeiten und Homebrew bevorzugen, können Sie das Paket hinzufügen und installieren:
```bash
brew tap hybridlabor-api/bdb-skills
brew install bdb-skills
bdb-skills
```

### Option 4: Manuelles Shell-Skript (Git Clone)
Klonen Sie das Repository und führen Sie das Installer-Skript aus:
```bash
git clone https://github.com/hybridlabor-api/bdb-dev-optimized-agent-skills.git
cd bdb-dev-optimized-agent-skills
chmod +x installer.sh
./installer.sh
```

**Das Installer-Skript führt automatisch folgende Schritte aus:**
1. Sichere Sicherung Ihrer bestehenden globalen und Workspace-Skills.
2. Bereitstellung der neuen kuratierten globalen Konfigurations-Skills.
3. Installation der workspace-spezifischen Agent-Skills.
4. Kopieren der angepassten `GEMINI.md` nach `~/.gemini/GEMINI.md`.
5. Vorwärmen der Python-Abhängigkeiten via `uv run`, um KI-Agenten-Timeouts beim ersten Start zu verhindern.

---
*Elevate your agency. Dominate the workflow.*
