Implements a dynamic, fault-tolerant plugin architecture for Python applications using auto-discovery and zero external dependencies.
- GitHub stars
- 9
- Files
- 19
- Last commit
- Nov 12, 2026
- License
- MIT
- Allowed tools
- —
What does the plugin-system skill do?
plugin-system implements a dynamic, fault-tolerant plugin architecture for Python applications using auto-discovery and zero external dependencies.
Summary generated from the skill's SKILL.md.
About the plugin-system skill
Adding a dynamic and fault-tolerant plugin architecture to Python CLI applications is the primary function of this tool. Developers use it to implement auto-discovery mechanisms that automatically find and load plugin classes from a specified directory. The system relies on a PluginBase abstract base class and a PluginManager to handle the lifecycle of various extensions without requiring any external dependencies beyond the Python standard library.
An agent should load this skill when a project requires extensibility through modular components. It produces a structured environment where plugins must define a name, a version, and an execute method to be considered valid. The architecture is designed so that a single faulty plugin, whether it contains a SyntaxError or missing attributes, will be logged and skipped rather than causing the entire application to crash. This ensures that the rest of the system remains operational even when individual modules fail.
What an agent can do with it
- 1Implement dynamic plugin loadingSet up a system that automatically discovers and loads Python plugins from a local directory.
- 2Build fault-tolerant CLI toolsCreate a command line interface where broken plugins do not stop the main application from running.
- 3Enforce plugin interface standardsEnsure all new extensions provide a name, version, and an execute method.
- 4Develop dependency-free architecturesBuild an extensible framework that only uses the Python standard library.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the plugin-system skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the plugin-system skill in Claude Code
~/.claude/skills/plugin-system/SKILL.md
$ npx degit ellmos-ai/skills/skills/dev/plugin-system ~/.claude/skills/plugin-systemInstall the plugin-system skill in Claude Code (project)
.claude/skills/plugin-system/SKILL.md
$ npx degit ellmos-ai/skills/skills/dev/plugin-system .claude/skills/plugin-systemInstall the plugin-system skill in Codex
~/.agents/skills/plugin-system/SKILL.md
$ npx degit ellmos-ai/skills/skills/dev/plugin-system ~/.agents/skills/plugin-systemInstall the plugin-system skill in Gemini CLI
~/.gemini/skills/plugin-system/SKILL.md
$ npx degit ellmos-ai/skills/skills/dev/plugin-system ~/.gemini/skills/plugin-systemInstall the plugin-system skill in Claude.ai
npx degit ellmos-ai/skills/skills/dev/plugin-system plugin-system && zip -r plugin-system.zip plugin-system # claude.ai → Customize → Skills → + → Create skill → Upload a skill → plugin-system.zip
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work · What to fix for more points
- Source repository linked and reachableellmos-ai/skills/skills/dev/plugin-system is public and reachablegithub.com/ellmos-ai/skills/tree/HEAD/skills/dev/plugin-syst ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-12github.com/ellmos-ai/skills/commits ↗Pass
- No download-and-run or credential theft in scripts5 of 6 scripts read; none of them downloads and runs code, the rest were not readFinding
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/ellmos-ai/skills/blob/HEAD/skills/dev/plugin-syst ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/ellmos-ai/skills/blob/HEAD/skills/dev/plugin-syst ↗Pass
- SKILL.md follows the Agent Skills formatthe description does not say when to use the skillgithub.com/ellmos-ai/skills/blob/HEAD/skills/dev/plugin-syst ↗Finding
SKILL.md
View on GitHubPlugin System
Fehlertolerantes Plugin-System fuer Python-CLI-Anwendungen. Ein fehlerhaftes Plugin stoppt niemals den Rest der Anwendung.
Kernfeatures
- Auto-Discovery: Findet Plugins automatisch in einem Verzeichnis
- Validierung: Prueft
name,version,execute()auf jeder Plugin-Klasse - Fehlertoleranz: Defekte Plugins werden geloggt aber nicht geladen
- Zero Dependencies: Nur Python-Standardbibliothek
Dateien
scripts/
plugin_system.py Kern: PluginBase (ABC) + PluginManager
cli_demo.py Demo-CLI mit argparse
test_plugin_system.py 16+ Unit-Tests
examples/
hello.py Hello-World Plugin
calculator.py Rechner-Plugin
systeminfo.py System-Info Plugin
Schnellstart
1. Plugin erstellen
from plugin_system import PluginBase
class MeinPlugin(PluginBase):
name = "MeinPlugin"
version = "1.0.0"
def execute(self, *args, **kwargs):
return {"status": "ok", "message": "Hallo!"}
2. PluginManager nutzen
from plugin_system import PluginManager
manager = PluginManager(plugins_dir="./meine_plugins")
plugins = manager.discover_plugins()
# Alle Plugins auflisten
manager.list_plugins()
# Plugin ausfuehren
success, result = manager.execute_plugin("MeinPlugin", param="wert")
if success:
print(result)
3. In eigene App integrieren
class MeineApp:
def __init__(self):
self.plugins = PluginManager("./plugins")
self.plugins.discover_plugins()
def run_command(self, command, **params):
success, result = self.plugins.execute_plugin(command, **params)
return result if success else None
Plugin-Interface
Jedes Plugin muss:
| Anforderung | Details |
|---|---|
PluginBase erben |
from plugin_system import PluginBase |
name setzen |
Klassenattribut, nicht leer |
version setzen |
Klassenattribut, Semantic Versioning |
execute() implementieren |
Beliebige *args, **kwargs |
Fehlertoleranz
| Fehlertyp | Verhalten |
|---|---|
| SyntaxError im Plugin | Plugin wird uebersprungen, Rest laedt |
| Fehlende Attribute | Plugin wird als is_valid=False markiert |
Exception in execute() |
Gibt (False, error_message) zurueck |
| Kein Plugin im Verzeichnis | Leere Liste, kein Crash |
Changelog
1.0.0 (2026-03-12)
- Migration aus MODULAR_AGENTS/plugins in Skillbibliothek
- PluginBase ABC + PluginManager
- 3 Beispiel-Plugins (Hello, Calculator, SystemInfo)
- 16+ Unit-Tests
- CLI-Demo mit argparse
Files in this skill
19plugin-system skill questions
How do I install the plugin-system skill in Claude Code?
Run npx degit ellmos-ai/skills/skills/dev/plugin-system ~/.claude/skills/plugin-system. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the plugin-system skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
Does the plugin system require external libraries?
No, it uses only the Python standard library.
What happens if a plugin contains a syntax error?
The plugin is skipped, but the rest of the application continues to load.
How are plugins discovered?
The system automatically finds plugins located within a specified directory.