Skip to main content

suggest-keywords

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".

Source facts

Repository
FlorianBruniaux/github-roast-tpc
Last source activity
June 16, 2026 at 15:17
Detected SKILL.md language
French
Stars
6
Forks
2

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
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.
View on GitHub