// Generiert und validiert README.md-Dateien nach FassadenFix Corporate Design mit CI-konformen Farben, Logos und Tonalität. Verwenden für: Projektdokumentation, Repository-README, Skill-Dokumentation, Software-Anleitungen, Open-Source-Projekte, interne Dokumentation.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | ff-project-readme |
| description | Generiert und validiert README.md-Dateien nach FassadenFix Corporate Design mit CI-konformen Farben, Logos und Tonalität. Verwenden für: Projektdokumentation, Repository-README, Skill-Dokumentation, Software-Anleitungen, Open-Source-Projekte, interne Dokumentation. |
| default_enabled | true |
| priority | 75 |
| scope | global |
| platforms | ["claude","manus","chatgpt_codex","gemini","antigravity"] |
| required_skills | ["fassadenfix-branding","fassadenfix-identity"] |
| optional_skills | ["fassadenfix-assets","fassadenfix-copywriting"] |
Dieser Skill erstellt professionelle, markenkonformen README.md-Dateien für FassadenFix-Projekte. Er kombiniert die Dokumentationsstruktur des ursprünglichen project-readme Skills mit den FassadenFix CI-Richtlinien.
Status: STANDARD-SKILL (Opt-Out-Prinzip) Priorität: Mittel (75) Geltungsbereich: Global - alle Projektdokumentationen
WICHTIG: Alle README-Dateien für FassadenFix-Projekte müssen den CI-Richtlinien entsprechen.
| Farbe | Pantone | HEX | Verwendung |
|---|---|---|---|
| FassadenFix Grün | 368 C | #77bc1f | Badges, Akzente, Links |
| Dunkelgrau | 445 C | #4e5758 | Text, Sekundärelemente |
Pfad:
/home/ubuntu/skills/fassadenfix-assets/templates/logos/
| Kontext | Logo-Datei |
|---|---|
| README Header | standard/FassadenFix_Logo_bunt_transparent_300px.png |
| GitHub Badge | varianten/FassadenFix_Logo_96x96.jpg |
Alle Texte folgen der FassadenFix Markensprache aus fassadenfix-identity:
README-Erstellung erfolgt in diesen Schritten:
Wähle das passende Template basierend auf dem Projekttyp:
| Projekttyp | Template | Referenz |
|---|---|---|
| Skill/Agent | Skill-README | templates/skill-readme.md |
| Webanwendung | Web-README | templates/web-readme.md |
| Internes Tool | Tool-README | templates/tool-readme.md |
| API/Service | API-README | templates/api-readme.md |
| Allgemein | Standard-README | templates/standard-readme.md |
Jede README folgt dieser Grundstruktur:
<div align="center">
<img src="[Logo-Pfad]" alt="FassadenFix Logo" width="300">
# [Projektname]
**[Kurzbeschreibung - max. 2 Sätze]**
[](https://fassadenfix.de)
[]()
</div>
Kurze, prägnante Zusammenfassung nach FassadenFix Tonalität.
Beispiel:
"Dieses Projekt unterstützt Sie bei [Zweck]. Wie bei allen FassadenFix-Lösungen steht Qualität und Transparenz im Vordergrund."
Liste der Hauptfunktionen mit FassadenFix-Bezug:
## Funktionen
| Funktion | Beschreibung |
|----------|--------------|
| **[Feature 1]** | [Beschreibung] |
| **[Feature 2]** | [Beschreibung] |
Schrittweise Anleitung mit klaren Anweisungen:
## Installation
### Voraussetzungen
- [Voraussetzung 1]
- [Voraussetzung 2]
### Schnellstart
\`\`\`bash
# Schritt 1: [Beschreibung]
[Befehl]
# Schritt 2: [Beschreibung]
[Befehl]
\`\`\`
Codebeispiele und Anwendungsfälle:
## Verwendung
### Grundlegende Verwendung
\`\`\`[sprache]
[Codebeispiel]
\`\`\`
### Erweiterte Optionen
[Weitere Beispiele nach Bedarf]
## Konfiguration
| Parameter | Beschreibung | Standard |
|-----------|--------------|----------|
| `[param]` | [Beschreibung] | `[wert]` |
## Beitrag
Wir freuen uns über Beiträge! Bitte beachten Sie:
1. Fork des Repositories erstellen
2. Feature-Branch anlegen (`git checkout -b feature/AmazingFeature`)
3. Änderungen committen (`git commit -m 'feat: Add AmazingFeature'`)
4. Branch pushen (`git push origin feature/AmazingFeature`)
5. Pull Request erstellen
## Lizenz
Dieses Projekt ist unter der [Lizenztyp] lizenziert. Siehe [LICENSE](LICENSE) für Details.
## Kontakt
**FassadenFix GmbH**
- Website: [www.fassadenfix.de](https://www.fassadenfix.de)
- E-Mail: [kontakt@fassadenfix.de](mailto:kontakt@fassadenfix.de)
---
<div align="center">
<sub>Erstellt mit 💚 von FassadenFix</sub>
</div>
<!-- Projekt-Badge -->
[](https://fassadenfix.de)
<!-- Status-Badges -->
[]()
[]()
[]()
<!-- Versions-Badge -->
[]()
<!-- CI-Badge -->
[]()
| Prüfpunkt | Erfüllt |
|---|---|
Logo korrekt eingebunden (aus fassadenfix-assets) | ☐ |
| Farben CI-konform (#77bc1f, #4e5758) | ☐ |
Tonalität entspricht fassadenfix-identity | ☐ |
| Alle Abschnitte vollständig | ☐ |
| Code-Beispiele getestet | ☐ |
| Links funktionieren | ☐ |
# README-Struktur prüfen
python /home/ubuntu/skills/ff-project-readme/scripts/validate_readme.py [README-Pfad]
Erstelle eine README für den neuen FassadenFix-Skill
→ Template: templates/skill-readme.md
→ Logo: FassadenFix_Logo_bunt_transparent_300px.png
→ Tonalität: fassadenfix-identity
Erstelle eine README für die FassadenFix-Webapp
→ Template: templates/web-readme.md
→ Badges: FassadenFix-Projekt, Status, Version
→ Installation: npm/pnpm Befehle
Erstelle eine README für die FassadenFix-API
→ Template: templates/api-readme.md
→ Endpunkte: Tabellen-Format
→ Authentifizierung: Klar dokumentiert
| Skill | Integration |
|---|---|
| fassadenfix-branding | Farben, Typografie, UI-Elemente |
| fassadenfix-identity | Tonalität, Kernbotschaften |
| fassadenfix-assets | Logo-Dateien, Icons |
| fassadenfix-copywriting | Textbausteine, Claims |
--no-readme-branding
--skip-ff-project-readme
"ohne FassadenFix README-Stil"
"neutrale README"
Dieser Skill basiert auf dem ursprünglichen project-readme Skill und wurde erweitert um die FassadenFix Corporate Design Richtlinien aus den Skills fassadenfix-branding, fassadenfix-identity und fassadenfix-assets.