Communitygithub.com

fkramer690/homepage

Rédiger ou mettre à jour un article de blog pour la page d'accueil de FK Solution Design (EN et DE). À utiliser chaque fois qu'un article de blog, un article technique ou un Fachbeitrag est créé ou modifié.

Qu'est-ce que homepage ?

Ce skill est conçu pour les agents IA afin de créer ou mettre à jour des articles de blog bilingues (anglais et allemand) pour le site web de FK Solution Design. Il garantit le respect des directives éditoriales, la localisation complète du contenu, l'utilisation de termes techniques précis comme "Fachbeitrag", et l'application d'un ton formel en allemand avec "Sie". Le skill gère la création des articles à partir d'un template, la génération d'images de cartes associées, l'exécution de contrôles de qualité (éviter le "AI slop") et la soumission via pull request avec des brouillons LinkedIn. Il fonctionne sur n'importe quelle plateforme d'agent utilisant des skills markdown, comme Claude Code ou Cursor, et nécessite que l'agent lise les fichiers `docs/blog-guidelines.md` et `docs/blog-template.md` avant d'écrire.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/fkramer690/homepage/tree/HEAD/.claude/skills/blog-article

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Rédaction d'un article de blog

  1. Lisez docs/blog-guidelines.md en intégralité. Ses règles sont impératives.
  2. Copiez docs/blog-template.md vers src/content/blog/en/<slug>.md et rédigez la version anglaise.
  3. Rédigez la version allemande dans src/content/blog/de/<slug-allemand>.md avec la même translationKey. Localisez, utilisez "Sie".
  4. Utilisez uniquement les expériences et les exemples que Fabian a confirmés (briefing, mémoire du projet, ses messages). Demandez-lui lorsqu'un exemple manque au lieu d'en inventer un.
  5. Effectuez une revue "AI slop" des deux versions (voir "No AI slop" dans les directives) : supprimez toute phrase qui conviendrait à n'importe quel article, remplacez les affirmations génériques par des faits concrets de Fabian, lisez-le à voix haute une fois.
  6. Dessinez l'image de la carte pour la vue d'ensemble du blog : ajoutez une entrée pour la translationKey de l'article dans src/lib/card-drawings.ts (dessin technique léger, étiquettes EN/DE avec des faits de l'article, voir "Card image" dans les directives). Chaque article en reçoit une ; la build échoue sans elle.
  7. Définissez draft: false lorsque l'article est prêt, puis exécutez npm run build. Corrigez chaque message de check-blog.mjs ou du schéma de contenu.
  8. Regardez la page de l'article construite une fois, et la carte sur /blog/ avec son dessin (boîte des points clés en haut, FAQ pliable, boîte auteur, section contact avec "Book a call" et le formulaire de contact en bas) ainsi que l'image de prévisualisation générée dans dist/og/<lang>/<slug>.png. Suggérez un graphique explicatif lorsque le sujet en bénéficie (voir Images dans les directives).
  9. Ouvrez la pull request et ajoutez 2–3 brouillons de teaser LinkedIn pour Fabian dans la PR ou le fil de discussion.

Ne modifiez pas les composants du template (src/components/BlogPost.astro, BlogIndex.astro) pour un seul article. Les changements de mise en page s'appliquent à tous les articles.

Skills associés