Initial commit

skills/mxcp-expert/assets/project-templates/plugin/plugins/README.md

@@ -0,0 +1,33 @@
+# MXCP Plugins Directory
+
+This directory contains MXCP plugins that extend DuckDB with custom User Defined Functions (UDFs).
+
+## Structure
+
+Each plugin should be a Python module containing a class named `MXCPPlugin` that inherits from `MXCPBasePlugin`.
+
+```
+plugins/
+├── my_plugin/
+│   └── __init__.py    # Contains MXCPPlugin class
+├── utils/
+│   └── string_utils.py
+└── integrations/
+    └── api_plugin.py
+```
+
+## Usage
+
+Plugins are referenced in `mxcp-site.yml`:
+
+```yaml
+plugin:
+  - name: cipher
+    module: my_plugin
+    config: rot13
+```
+
+The functions are then available in SQL as `{function_name}_{plugin_name}`:
+```sql
+SELECT encrypt_cipher('hello world');
+```