Suggest Keywords

---
name: suggest-keywords
description: Use when improving the findability of a GitHub profile and its repos. Generates keyword-rich repo descriptions and topics, optimizes the profile bio for search, and proposes cross-platform linking. Triggers on "améliore mes keywords", "make my repo findable", "seo for my github".
---

# suggest-keywords

Travaille la findability d'un dev : un recruteur ou un pair doit te trouver via Google et Perplexity, pas seulement via la recherche GitHub. C'est du SEO concret appliqué à un profil. La grille de signaux est dans `signals.md` à la racine du plugin.

## Entrée

Un `username`, ou la fiche profil déjà produite par `analyze-github-profile`. Si rien n'est fourni, récupérer repos et bio via `gh`.

## Procédure

1. Récupérer la bio du profil, et pour chaque repo non-fork : nom, description actuelle, topics actuels, langage principal.
```
gh api "users/{username}/repos?per_page=100" --paginate \
  --jq '.[] | select(.fork==false) | {name, desc: .description, topics: .topics, lang: .language, stars: .stargazers_count}'
```
2. Pour chaque repo phare, proposer une description courte et dense en mots-clés réels (ce que quelqu'un taperait pour trouver ce projet), et une liste de topics GitHub pertinents.
3. Proposer une bio de profil optimisée : rôle, stack, et un ou deux mots-clés de niche qui te différencient.
4. Vérifier le cross-platform linking : le profil pointe-t-il vers LinkedIn, et inversement, et vers un blog ou Medium si présent. Une chaîne de liens cohérente renforce le SEO et la findability.
5. Vérifier la présence d'un fichier LLM (`llms.txt`, `llms-full.txt`). Absent sur un projet outil, proposer de l'ajouter : c'est de l'AEO, les moteurs de réponse et les assistants s'en servent pour citer le projet. Format sur llmstxt.org.

## Règles

- Des mots-clés réels, pas du bourrage. Une description doit rester lisible par un humain.
- Coller au vocabulaire que la cible utilise vraiment (un recruteur cherche "React Native", pas "application mobile cross-platform moderne").
- Topics GitHub : entre 5 et 10 par repo, du général au spécifique.
- Pas de promesse marketing, des termes techniques précis.
- Discipline de preuve sur ce qu'on recommande de publier (voir `signals.md`). Aucun chiffre inventé ni agrégé à la louche dans une bio ou une description, aucun intitulé de poste fictif. Un agrégat de stars s'additionne à partir de compteurs vérifiés, détail montré ; un chiffre non vérifiable se marque `[à vérifier]`. Ne jamais faire commettre à l'utilisateur le claim gonflé que l'audit reproche ailleurs.

## Sortie

1. **Bio de profil** proposée, avant et après.
2. **Tableau par repo phare** : description actuelle, description proposée, topics à ajouter.
3. **Cross-linking** : les liens manquants à ajouter (GitHub vers LinkedIn, LinkedIn vers GitHub, blog), avec où les mettre.

Tout doit être copiable et collable directement dans GitHub.