Bei WildBionics mitmachen

Für wen

Alle mit eigenem Claude-Abo – der empfohlene Weg, um mitzumachen.

Was du brauchst

Ein GitHub-Konto mit Einladung ins Repository und Claude Pro, Max, Team oder Enterprise.

Zeitaufwand

etwa 20 Minuten Einrichtung (einmalig)

1. 1

   Schritt 1: GitHub-Konto anlegen und einladen lassen

   Kostenlos auf github.com/signup. Dann im Repository ein Issue mit dem Titel „Collaborator request“ und deinem GitHub-Benutzernamen öffnen – oder den Maintainer direkt fragen – und die Einladung über die E-Mail von GitHub oder unter github.com/hstoecker/wildbionics/invitations annehmen.
2. 2

   Schritt 2: Bei Claude anmelden und GitHub verbinden

   claude.ai/code öffnen, mit deinem Claude-Abo anmelden und, wenn gefragt, GitHub verbinden. Nimm vorher die Einladung an: Bis dahin taucht hstoecker/wildbionics nicht in der Repository-Liste auf. Fehlt es danach immer noch, GitHub unter claude.ai/connect-github neu verbinden.
3. 3

   Schritt 3: Cloud-Umgebung „WildBionics“ anlegen (einmalig)

   Jede Sitzung läuft auf einem frischen Cloud-Rechner; seine Umgebung legt fest, welche Websites er erreichen darf und was installiert ist. Umgebungsauswahl neben dem Eingabefeld → Add cloud environment (eine bestehende ändern: Umgebungsmenü in der Titelleiste der Sitzung → Edit). Vier Felder ausfüllen:

   Name

   WildBionics

   Network access

   Custom, Haken bei Also include default list of common package managers (RubyGems, für Jekyll) und diese Domains erlauben – ohne sie kann Claude keine Quellen prüfen (Crossref, DOI, PubMed, Semantic Scholar, Wikidata, Wikipedia):

   api.crossref.org
   doi.org
   eutils.ncbi.nlm.nih.gov
   pubmed.ncbi.nlm.nih.gov
   www.ncbi.nlm.nih.gov
   api.semanticscholar.org
   www.wikidata.org
   *.wikipedia.org

   Environment variables

   LANG=C.UTF-8

   Der Cloud-Rechner hat standardmäßig kein UTF-8-Locale – ohne diese Zeile stürzen Jekyll und die Prüfungen beim ersten Umlaut ab.

   Setup script

   #!/bin/bash
   set -e
   gem install github-pages -v 232 --no-document
   ln -sf "$(ruby -e 'print Gem.bindir')/jekyll" /usr/local/bin/jekyll
   python3 -m pip install numpy==2.0.2 scipy==1.13.1 matplotlib==3.9.4 fonttools==4.54.1 brotli==1.1.0

   Installiert Jekyll in genau den Versionen, die GitHub Pages verwendet. Die ln-Zeile legt jekyll in den Suchpfad – der Cloud-Rechner installiert Gem-Programme in einen Ordner, den die Shell nicht durchsucht. Die letzte Zeile installiert die Python-Bibliotheken für die Code-Beispiele, in den Versionen der CI.

   Dann Create environment. Für Screenshots brauchst du nichts weiter: Chromium ist vorinstalliert.
4. 4

   Schritt 4: Sitzung starten

   Mit dem Knopf unten – Repository und Umgebung sind vorausgewählt. Oder selbst hstoecker/wildbionics (Branch main) und die Umgebung WildBionics wählen.

   Claude Code mit WildBionics öffnen

5. 5

   Schritt 5: Einrichtung prüfen

   Schick das als erste Nachricht:

   Führe alle lokalen Prüfungen aus CLAUDE.md aus und prüfe, ob api.crossref.org erreichbar ist.

   Alle fünf Prüfungen sollten 0 Fehler melden. Wenn nicht: siehe „Wenn etwas nicht klappt“ unten.
6. 6

   Schritt 6: Aufgabe beschreiben

   Zum Beispiel:

   Schreibe einen neuen WildBionics-Artikel darüber, wie Fledermäuse ihre Beute mit Echoortung finden. Beginne mit dem Skill wildbionics-contribute und folge den Skills article, figures, translate und graph.

7. 7

   Schritt 7: Mit Claude zusammenarbeiten

   Beantworte Rückfragen, lass dir Abbildungen und Seiten als Screenshots zeigen, und zum Schluss: „Führe alle Prüfungen aus und prüfe deine Arbeit mit wildbionics-review.“
8. 8

   Schritt 8: Änderungen prüfen

   Über die Anzeige +/− die Änderungen öffnen. Einzelne Zeilen kommentieren, wenn sich etwas ändern soll.
9. 9

   Schritt 9: Pull Request erstellen

   Oben in der Änderungsansicht auf Create PR klicken. Nach etwa 3 Minuten sind die Prüfungen fertig, und Claude hat ein Review geschrieben; Screenshots der neuen Seiten findest du unter Checks → Build, check & deploy → Artifacts → preview-pr-…. Bitte Claude in der Sitzung, Hinweise zu beheben – es pusht in denselben Pull Request. Der Maintainer gibt frei; wenige Minuten nach dem Merge ist dein Beitrag online.
10. 10

    Schritt 10: Wenn etwas nicht klappt

    „invalid byte sequence in US-ASCII“

    Die Umgebungsvariable LANG=C.UTF-8 fehlt.

    „bundler: command not found: jekyll“

    Das Setup-Skript fehlt oder ist fehlgeschlagen – in den Einstellungen der Umgebung prüfen.

    Crossref, DOI oder PubMed gesperrt (403, „host not allowed“)

    Network access steht nicht auf Custom, oder die Domain fehlt in der Liste.

    Repository fehlt in der Liste, Push abgelehnt

    Einladung annehmen, dann GitHub neu verbinden.

    Umgebung geändert, nichts passiert

    Einstellungen gelten nur für neue Sitzungen – eine neue starten.

    Kommst du nicht weiter? Öffne ein Issue mit der Fehlermeldung.
11. 11

    Schritt 11: Optional: auf dem eigenen Rechner

    Repository klonen und Claude Code darin starten – die Skills laden automatisch:

    git clone https://github.com/hstoecker/wildbionics.git
    cd wildbionics
    claude

    Die Plugin-Befehle /plugin marketplace add hstoecker/wildbionics und /plugin install wildbionics@wildbionics brauchst du nur außerhalb dieses Repositorys.

Tipp: Unter Windows nimm claude.ai/code: Die Skills sind per Symlink verknüpft, und Windows checkt diese manchmal falsch aus.

Für wen

Nur Friends & Family: Claude läuft über das Konto des Maintainers – jede Anfrage verbraucht dessen Claude-Tokens.

Was du brauchst

Ein kostenloses GitHub-Konto und eine Einladung ins Repository.

Zeitaufwand

etwa 10 Minuten Einrichtung

1. 1

   Schritt 1: GitHub-Konto anlegen

   Kostenlos auf github.com/signup. Auf GitHub liegt das ganze Projekt.
2. 2

   Schritt 2: Einladung anfragen

   Im Repository ein Issue mit dem Titel „Collaborator request“ und deinem GitHub-Benutzernamen öffnen – oder den Maintainer direkt fragen.
3. 3

   Schritt 3: Einladung annehmen

   Über den Link in der E-Mail von GitHub oder unter github.com/hstoecker/wildbionics/invitations.
4. 4

   Schritt 4: Neues Issue öffnen

   New issue öffnen und Article idea oder Correction wählen.
5. 5

   Schritt 5: Anfrage schreiben – mit @claude am Anfang

   Sei konkret: welches Phänomen, für wen, welche Quellen du kennst. Beispiel:

   @claude Bitte recherchiere und entwirf einen WildBionics-Artikel darüber, wie Fledermäuse ihre Beute mit Echoortung finden. Folge den WildBionics-Skills, prüfe jede Quelle, schreibe zuerst Englisch, dann Deutsch.

6. 6

   Schritt 6: Absenden und abwarten

   Auf Submit new issue klicken. Claude antwortet in einem Kommentar und hakt beim Arbeiten eine Aufgabenliste ab – ein ganzer Artikel kann eine Weile dauern.
7. 7

   Schritt 7: Pull Request erstellen

   Ist Claude fertig, enthält sein Kommentar einen Link, um den Pull Request zu erstellen. Öffne ihn und klicke auf Create pull request.
8. 8

   Schritt 8: Ergebnis ansehen

   Nach etwa 3 Minuten sind die Prüfungen fertig, und Claude hat ein Review geschrieben. Screenshots der neuen Seiten: Checks → Build, check & deploy → Artifacts → preview-pr-….
9. 9

   Schritt 9: Änderungen wünschen

   Im Pull Request kommentieren und mit @claude beginnen – z. B. „@claude mach die Abbildung größer und ergänze eine FAQ zu …“. Claude pusht die Änderung.
10. 10

    Schritt 10: Freigabe und online

    Der Maintainer prüft und gibt frei. Wenige Minuten nach dem Merge ist dein Beitrag online.

Tipp: Ein Thema pro Issue, und so genau wie möglich – Phänomen, Zielgruppe, bekannte Quellen. Das ergibt bessere Ergebnisse und spart die Tokens des Maintainers.

Für wen

Absolute Experten, die der Maintainer persönlich kennt – git, Jekyll und die Projektregeln sind dir vertraut.

Was du brauchst

Ein GitHub-Konto, git und für die lokale Vorschau und die Prüfungen Ruby 3.3 und Python 3.9 oder neuer.

Zeitaufwand

5 Minuten für eine kleine Korrektur

1. 1

   Schritt 1: Regeln lesen

   CONTRIBUTING.md und die Skills in plugins/wildbionics/skills – einfaches Markdown, für Menschen genauso nützlich.
2. 2

   Schritt 2: Kleine Änderung: im Browser bearbeiten

   Datei auf GitHub öffnen (z. B. einen Artikel in _articles/), auf das Stift-Symbol klicken, bearbeiten, dann Commit changes… → Create a new branch → Propose changes. GitHub legt bei Bedarf einen Fork an. Weiter mit Schritt 6.
3. 3

   Schritt 3: Größere Änderung: Fork und Branch

   Auf der Repository-Seite Fork wählen (Mitwirkende können das überspringen), klonen und einen Branch anlegen:

   git clone https://github.com/<dein-name>/wildbionics.git
   cd wildbionics
   git checkout -b article/bats

4. 4

   Schritt 4: Dateien bearbeiten

   Neue Artikel als _articles/<slug>.en.md und .de.md, Texte der Oberfläche in _data/i18n.yml, deutsche Fachbegriffe in _data/glossary.yml.
5. 5

   Schritt 5: Prüfen und pushen

   Prüfungen und lokale Vorschau laufen lassen, dann committen und pushen:

   bundle install
   python3 -m pip install -r examples/requirements.txt -r .github/scripts/requirements.txt
   ruby .github/scripts/check_terms.rb
   ruby .github/scripts/check_content.rb
   ruby .github/scripts/check_plugin.rb
   python3 .github/scripts/code_examples.py --check
   bundle exec jekyll build && python3 .github/scripts/figures.py _site && python3 .github/scripts/check_site.py _site
   bundle exec jekyll serve   # http://localhost:4000
   git add -A && git commit -m "Add bat article"
   git push -u origin article/bats

6. 6

   Schritt 6: Pull Request öffnen

   Gegen hstoecker/wildbionics · main; die Vorlage ausfüllen.
7. 7

   Schritt 7: Hinweise der Prüfungen beheben

   Eine fehlgeschlagene Prüfung nennt im Log Regel und Datei. Korrigieren und erneut pushen – der Pull Request aktualisiert sich selbst.
8. 8

   Schritt 8: Freigabe und online

   Der Maintainer prüft und gibt frei; nach dem Merge ist deine Änderung online.

Tipp: Sprich größere Änderungen vorher mit dem Maintainer ab. Pull Requests aus Forks bekommen kein automatisches Claude-Review, weil GitHub Forks keine Secrets gibt – der Maintainer prüft sie von Hand.