{
  "markdown": "# AI Agent Skills\n\nSammlung wiederverwendbarer Skills für AI Agenten im offenen SKILL.md Format.\n\n---\n\n## Über das SKILL.md Format\n\nDas SKILL.md Format besteht aus Markdown-Dateien mit strukturierten Metadaten im sogenannten Frontmatter-Bereich (YAML zwischen `---`). Diese Dateien stellen einem AI Agenten Anweisungen, Kontext und verfügbare Werkzeuge für eine bestimmte Aufgabe bereit.\n\nDas Format wurde ursprünglich von Anthropic für Claude entwickelt, ist jedoch bewusst offen und textbasiert gehalten. Jedes AI System, das strukturierte Textdateien einlesen und Befehle ausführen kann, kann dieses Format grundsätzlich nutzen.\n\n---\n\n## KI-Agnostische Nutzbarkeit\n\nDie Skills in diesem Repository sind bewusst so gestaltet, dass sie **keine Claude-spezifischen Abhängigkeiten** enthalten. Stattdessen greifen sie ausschliesslich auf Standardwerkzeuge zurück:\n\n- **git** – Versionskontrolle und Repository-Operationen\n- **gh** – GitHub CLI für Issues, PRs und Repository-Management\n- **Shell-Befehle** – Universelle Unix/Linux-Kommandos\n\nJedes AI System, das:\n\n- Markdown-basierte Kontextdateien einlesen kann\n- Shell-Befehle ausführen und deren Ausgabe verarbeiten kann\n- Dateien erstellen, lesen und modifizieren kann\n\nkann diese Skills grundsätzlich nutzen. Dazu gehören unter anderem:\n\n- Claude (Anthropic)\n- GPT-basierte Agenten mit Tool-Nutzung (OpenAI)\n- Gemini (Google)\n- Open-Source-Agentenframeworks (z.B. LangChain, AutoGPT, MetaGPT)\n\nDie SKILL.md Dateien können direkt als Kontextdatei in einen Chat hochgeladen, als Systemprompt-Ergänzung eingefügt oder per Dateiverweis in eigene Agenten-Frameworks eingebunden werden.\n\n---\n\n## Enthaltene Skills\n\n| Skill                  | Beschreibung                                                                                                                                                |\n| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `cc-best-practices`    | Anleitung zur effektiven Nutzung von Claude Code: Kontextmanagement, Explore-Plan-Implement-Workflow, Prompting-Techniken und häufige Fehlermuster.         |\n| `skill-best-practices` | Leitfaden zum Erstellen, Strukturieren und Verbessern von SKILL.md Dateien: Frontmatter, Trigger-Beschreibungen, Testen und Troubleshooting.                |\n| `project-references`   | Konventionen und Implementierungsmuster aus eigenen GitHub-Repositories nachschlagen, die lokal unter `~/projects/referenzen/` ausgecheckt sind.            |\n| `camel-matrix`         | Erzeugt eine AsciiDoc-Kompatibilitätsmatrix für Apache Camel Spring Boot, Spring Boot und Apache CXF. Unterstützt optional einen Versionsbereich (min max). |\n\n---\n\n## Installation für Claude Code\n\n### Option 1: npm global — Empfohlen\n\nInstalliert Skills, `statusline.sh` und den Formatter-Hook automatisch. Skills werden als Symlinks (Linux/macOS/WSL) bzw. Directory-Junctions (Windows) eingebunden — Reinstall genügt für Updates.\n\nEinmalig npm für Git-URL-Installs freischalten:\n\n```bash\nnpm config set allow-git all\n```\n\n#### Linux / macOS / WSL\n\nInstallieren und Setup-Script ausführen:\n\n```bash\nnpm install -g --ignore-scripts https://github.com/dboeckli/ai-agent-skills.git#master && \\\n  bash \"$(npm root -g)/@dboeckli/ai-agent-skills/scripts/install-skills.sh\"\n```\n\nInstallation prüfen:\n\n```bash\ntree ~/.claude/skills && ls ~/.claude/statusline.sh ~/.claude/settings.json\n```\n\nErwartete Ausgabe:\n\n```\n~/.claude/skills\n├── camel-matrix -> ~/.nvm/.../node_modules/@dboeckli/ai-agent-skills/.claude/skills/camel-matrix/\n├── cc-best-practices -> ~/.nvm/.../node_modules/@dboeckli/ai-agent-skills/.claude/skills/cc-best-practices/\n├── project-references -> ~/.nvm/.../node_modules/@dboeckli/ai-agent-skills/.claude/skills/project-references/\n└── skill-best-practices -> ~/.nvm/.../node_modules/@dboeckli/ai-agent-skills/.claude/skills/skill-best-practices/\n\n~/.claude/statusline.sh\n~/.claude/settings.json\n```\n\nAktualisieren (gleicher Befehl):\n\n```bash\nnpm install -g --ignore-scripts https://github.com/dboeckli/ai-agent-skills.git#master && \\\n  bash \"$(npm root -g)/@dboeckli/ai-agent-skills/scripts/install-skills.sh\"\n```\n\n#### Windows (PowerShell)\n\nInstallieren und Setup-Script ausführen:\n\n```powershell\nnpm install -g --ignore-scripts https://github.com/dboeckli/ai-agent-skills.git#master\n& \"$(npm root -g)/@dboeckli/ai-agent-skills/scripts/install-skills.ps1\"\n```\n\nSkills werden als Directory-Junctions eingebunden (kein Admin-Recht nötig). Ausserdem wird in `%USERPROFILE%\\.claude\\settings.json` ein Stop-Hook eingetragen, der nach jeder Session Dateien formatiert.\n\nInstallation prüfen:\n\n```powershell\nGet-ChildItem \"$HOME\\.claude\\skills\"\nTest-Path \"$HOME\\.claude\\statusline.sh\", \"$HOME\\.claude\\settings.json\"\n```\n\nAktualisieren (gleicher Befehl):\n\n```powershell\nnpm install -g --ignore-scripts https://github.com/dboeckli/ai-agent-skills.git#master\n& \"$(npm root -g)/@dboeckli/ai-agent-skills/scripts/install-skills.ps1\"\n```\n\n### Option 2: skills CLI — Alternative\n\nNützlich um Skills aus mehreren Repos zu kombinieren. Installiert **nicht** `statusline.sh` und den Formatter-Hook.\n\n```bash\n# Global installieren\nnpx skills add -g https://github.com/dboeckli/ai-agent-skills\n\n# Aktualisieren\nnpx skills update ai-agent-skills\n```\n\n> **Installationsmethode:** Bei der Abfrage _Installation method_ **Copy to all agents** wählen.\n>\n> **WSL-Hinweis:** **Space** zum Auswählen, dann **Enter** zum Bestätigen.\n>\n> **Statusline manuell installieren:**\n>\n> ```bash\n> curl -fsSL https://raw.githubusercontent.com/dboeckli/ai-agent-skills/master/scripts/statusline.sh \\\n>   -o ~/.claude/statusline.sh && chmod +x ~/.claude/statusline.sh\n> ```\n\n---\n\n## Installation für Opencode\n\nSkills installieren:\n\n```bash\nnpx skills add -g https://github.com/dboeckli/ai-agent-skills.git\n```\n\nContext7 für aktuelle API-Dokumentation einrichten:\n\n```bash\nnpx ctx7 setup --opencode\n```\n\n---\n\n## Sandbox (lokale Dev-Umgebung)\n\nDie Sandbox wird durch das opencode-sandbox-kit provisioniert und läuft als Docker-Container. Sie mounted dieses Repo, startet opencode und verbindet den IntelliJ-MCP-Server.\n\n### Sandbox starten (opencode-sandbox-kit)\n\nKit-Quelle freischalten (GitHub ohne Klonen):\n\n```powershell\nsbx settings set kit.allowedSources --% \"[\\\"docker.io/\\\",\\\"github.com/dboeckli/\\\"]\"\n```\n\nNeue Sandbox starten:\n\n```powershell\nsbx run opencode --name ai-agent-skills --kit \"git+https://github.com/dboeckli/opencode-sandbox-kit.git#dir=opencode-agent\" \"C:\\development\\projects\\ai-agent-skills\"\n```\n\nKit auf eine bestehende Sandbox anwenden (startet die Sandbox neu, VM-Zustand bleibt erhalten):\n\n```powershell\nsbx kit add ai-agent-skills \"git+https://github.com/dboeckli/opencode-sandbox-kit.git#dir=opencode-agent\"\n```\n\n---\n\n## Konfiguration\n\nNach der Installation die Datei `~/.claude/settings.json` (Linux/WSL) bzw. `%USERPROFILE%\\.claude\\settings.json` (Windows) manuell öffnen und folgende Einstellungen ergänzen oder anpassen.\n\n### Linux / WSL (`~/.claude/settings.json`)\n\n```json\n{\n  \"model\": \"claude-sonnet-4-6\",\n  \"theme\": \"light\",\n  \"permissions\": {\n    \"allow\": [\"Bash(npx ctx7@latest *)\", \"Bash(ctx7 *)\"]\n  },\n  \"skillOverrides\": {\n    \"skill-creator\": \"off\"\n  },\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"/home/<username>/.claude/statusline.sh\"\n  },\n  \"sandbox\": {\n    \"enabled\": true,\n    \"autoAllowBashIfSandboxed\": false\n  }\n}\n```\n\n`<username>` durch den eigenen Linux-Benutzernamen ersetzen (oder `~` verwenden, falls Claude Code das auflöst).\n\n### Windows (`%USERPROFILE%\\.claude\\settings.json`)\n\n```json\n{\n  \"model\": \"claude-sonnet-4-6\",\n  \"theme\": \"light\",\n  \"permissions\": {\n    \"allow\": [\"Bash(npx ctx7@latest *)\", \"Bash(ctx7 *)\"]\n  },\n  \"skillOverrides\": {\n    \"skill-creator\": \"off\"\n  },\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"bash \\\"C:/Users/<username>/.claude/statusline.sh\\\"\"\n  },\n  \"sandbox\": {\n    \"enabled\": true,\n    \"autoAllowBashIfSandboxed\": false\n  }\n}\n```\n\n`<username>` durch den Windows-Benutzernamen ersetzen. Die `statusLine` ruft `bash` auf (Git Bash oder WSL), damit das `.sh`-Script ausgeführt werden kann.\n\n> **Hinweis:** Der Stop-Hook für `format.sh` wird automatisch durch `install-skills.ps1` (Windows) bzw. `install-skills.sh` (Linux/WSL) eingetragen — dieser muss nicht manuell gesetzt werden.\n\n---\n\n## Nutzung mit anderen AI Systemen\n\n### Als Kontextdatei hochladen\n\nLade die gewünschte SKILL.md Datei direkt in den Chat hoch. Das AI System kann den Inhalt als Kontext für die Aufgabenbearbeitung nutzen.\n\n### In Systemprompt einfügen\n\nKopiere den Inhalt einer SKILL.md Datei (oder ausgewählte Abschnitte) in den Systemprompt deines AI Systems, um die definierten Anweisungen und Werkzeuge zu aktivieren.\n\n### Einbindung in Custom-GPTs oder Agenten-Frameworks\n\nVerweise in deiner Konfiguration auf die SKILL.md Datei(en) aus diesem Repository. Die strukturierten Metadaten und Anweisungen können von den meisten modernen Agenten-Frameworks direkt interpretiert werden.\n\n---\n\n## Lizenz\n\nDieses Repository ist unter der **MIT-Lizenz** veröffentlicht.\n\nDu darfst die Skills in diesem Repository nutzen, modifizieren und weiterverwenden – sowohl für private als auch für kommerzielle Projekte. Eine Namensnennung ist nicht erforderlich, wird aber geschätzt.\n\nDie Nutzung, Modifikation und Weiterverwendung durch Dritte ist **unabhängig vom eingesetzten AI System** ausdrücklich erlaubt. Die Skills stehen allen zur Verfügung, die ein AI System betreiben, das das SKILL.md Format verarbeiten kann.\n",
  "bytes": 9584,
  "sha": "c96116b9ca43a4700bfe5c9b4e2297d70c522b61fa846a160741e199fb4f381e",
  "repo_slug": "dboeckli/ai-agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_dboeckli_ai_agent_skills_project_referen_8cb269c2/readme"
}