Communitygithub.com

Flagrare/agent-skills

Construisez et maintenez une carte de promotion sourcée pour le passage au niveau supérieur.

Qu'est-ce que agent-skills ?

Cette compétence conçoit et suit un plan de promotion complet en interrogeant l'utilisateur sur son objectif (niveau, filière, cycle et motivation), en recherchant le fonctionnement concret des promotions dans son entreprise (processus, calendrier, modèle de dossier et grille d'évaluation), en cartographiant l'organisation et les personnes ayant une connaissance directe du travail de l'utilisateur, et en calculant le moment idéal pour aborder le sujet avec son manager. Chaque fait est associé à une source, une date et un statut (vérifié, non vérifié ou déduit), et les sources contradictoires sont affichées plutôt que résolues silencieusement. La compétence écrit les fichiers `~/.claude/skills/flagrare/career/promotion-map.md` et `.json`, qui sont utilisés par d'autres compétences comme impact-scan, opportunity-scan et career read. Elle est déclenchée par des expressions comme « promotion », « plan de promo », « comment fonctionnent les promotions ici », « quand dois-je parler de promotion à mon manager », ou « suis-je prêt pour le grade senior ». Cette compétence s'exécute localement et ne publie jamais rien en ligne.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Flagrare/agent-skills/tree/HEAD/plugins/flagrare/skills/promotion

Demander à votre IA préférée

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

Documentation

Promotion

Pas de tirets cadratins. Rien que cette compétence écrit ne peut contenir de tiret cadratin ; utilisez une virgule, deux-points ou parenthèses. Appliqué par une vérification dans le dépôt. Voir /flagrare:write-docs.

Mots simples. Dans tout ce que l'utilisateur lit, utilisez les noms simples de <plugin root>/lib/career/GLOSSARY.md ("Comportements senior", pas "lignes de la grille" ; "votre dossier écrit", pas "packet" ; "le projet que vous pilotez", pas "initiative"). La première fois qu'un terme apparaît, dites ce qu'il signifie en quelques mots et ajoutez le mot de l'entreprise entre parenthèses lorsque l'utilisateur l'entendra au travail.

Une promotion se décide dans une pièce où l'utilisateur n'est pas, à partir d'un dossier écrit, par des personnes qui ne le connaissent pour la plupart pas, selon un calendrier fixé des mois à l'avance. Cette compétence rend ces faits visibles tôt : où l'utilisateur veut aller et pourquoi, comment l'entreprise décide réellement, ce que la grille demande, qui a une connaissance directe de son travail, et quand les conversations clés doivent avoir lieu.

Elle écrit une carte de promotion : promotion-map.md pour que l'utilisateur la lise et l'apporte à un 1:1, et promotion-map.json avec les mêmes faits pour les autres compétences de carrière. La carte est locale et privée. Cette compétence ne publie, n'envoie ni ne diffuse jamais rien.

Bibliothèque

Le plugin fournit des scripts d'aide dans <plugin root>/lib/career/. La racine du plugin se trouve deux répertoires au-dessus du répertoire de base de cette compétence. Exécutez chacun comme python3 <plugin root>/lib/career/<script>.py .... Ils ne lisent et n'impriment que du JSON ; cette compétence écrit chaque fichier avec l'outil Écrire, car un shell sandboxé ne peut pas écrire sous ~/.claude/skills.

  • career_state.py paths|contributions|plan --home "$HOME" : emplacements des fichiers, journal des contributions (union des anciens et nouveaux emplacements) et plan de migration.
  • map_schema.py check <map.json> --today YYYY-MM-DD : erreurs, sections manquantes, sections obsolètes (plus de 90 jours), conflits.
  • deadlines.py --deadline YYYY-MM-DD --today YYYY-MM-DD [--dead START:END ...] [--published] : quand parler au manager. --dead est optionnel et répétable.

La forme de la carte se trouve dans reference/map-schema.md, et la mise en page markdown dans reference/map-template.md. Les autres fichiers d'état partagés (journal des contributions, indicateurs, initiatives) sont décrits dans <plugin root>/lib/career/STATE.md ; effacez un indicateur traité en réécrivant flags.json sans lui.

1. Charger l'état (à chaque exécution)

  1. Exécutez career_state.py plan. Appliquez chaque action write avec l'outil Écrire, en lisant d'abord la cible si elle existe déjà (l'outil Écrire n'écrasera pas un fichier qu'il n'a pas lu). Une action mkdir ne nécessite pas d'étape séparée : le dossier est créé par le premier fichier écrit dedans. N'écrivez pas une carte factice. Ne supprimez jamais rien.
  2. Lisez ~/.claude/skills/flagrare/config.json (clés d'identité de premier niveau, le bloc skills.promotion) et la carte existante, le cas échéant. Si le fichier de configuration ou le bloc skills.promotion est manquant, continuez avec les valeurs par défaut.
  3. Pas de carte signifie une première exécution (section 3). Une carte dont la sortie de map_schema.py check liste des sections missing signifie une première exécution interrompue : reprenez-la à la phase la plus précoce dont les sections sont manquantes. Sinon, effectuez une mise à jour (section 4), sauf si l'utilisateur demande le mode packet (section 5).

Appelé par /flagrare:career. Les arguments nomment un mode (first_run, resume ou refresh) et les sections à traiter : ne faites que celles-ci. Quand ils disent aussi scheduled, n'interviewez jamais et ne demandez pas : re-recherchez et sauvegardez uniquement les sections qui ne nécessitent pas de réponse de l'utilisateur (processus, calendrier, grille, organigramme, précédent), et retournez chaque section qui nécessite l'utilisateur (objectif, personnes, questions au manager) comme une ligne pour la liste Besoins du coordinateur. Dans les deux cas, retournez un bref résumé de ce qui a changé au lieu de la carte complète.

2. Règles pour chaque fait

  • Source, date, statut. Chaque fait reçoit un lien ou un emplacement cité, la date à laquelle vous l'avez vérifié, et un statut : verified (lu et cité dans la source brute), unverified (un résumé, un extrait ou de seconde main), ou inferred (votre raisonnement).
  • Citez textuellement la source brute. Les outils de récupération qui résument paraphrasent. Lorsqu'une citation sera utilisée, relisez la page brute (par exemple le JSON ou HTML de la page) et confirmez les mots exacts.
  • Montrez les conflits, ne choisissez jamais en silence. Quand deux sources sont en désaccord (un organigramme vs un répertoire d'équipe, une page de processus vs le fichier des niveaux), stockez les deux comme alternatives et informez l'utilisateur.
  • "Rien trouvé" est un résultat valide. Si une étape ne trouve rien, ajoutez une question concrète à manager_questions au lieu de deviner. De nombreuses entreprises n'ont pas de processus écrit.
  • Les faits sur les personnes sont sensibles. Ne lisez que les propres interactions de l'utilisateur. Enregistrez qui a un contexte direct sur le travail de l'utilisateur, jamais un classement de l'utilité des personnes.
  • Demandez le consentement avant d'utiliser le navigateur pour les portails RH ou les sites internes.

3. Première exécution

Dites à l'utilisateur d'avance : la première exécution est longue, souvent une heure ou plus, et elle sauvegarde après chaque phase, donc elle peut être arrêtée et reprise.

Chaque sauvegarde écrit à la fois promotion-map.json et promotion-map.md, et définit sections.<name>.checked_at (aujourd'hui) et sections.<name>.sources pour chaque section écrite dans cette phase. Une section sans checked_at est considérée comme obsolète. La phase 1 écrit target, process et calendar ; la phase 2 écrit rubric ; la phase 3 écrit org, people et precedent ; la phase 4 écrit packet_readiness et manager_questions. Écrivez chaque section même lorsque rien n'a été trouvé (une liste vide ou un objet avec son checked_at), afin qu'une section vide ne soit pas confondue avec une exécution interrompue.

Phase 1 : Objectif, processus et calendrier

  1. Interviewez d'abord, avant toute recherche. Posez une question à la fois :
    1. Niveau actuel et niveau cible.
    2. Filière : contributeur individuel ou manager.
    3. Quel cycle ils visent (revenez-y après l'étape 4, une fois le calendrier connu, et proposez-en un).
    4. Pourquoi ils le veulent, quel travail ils veulent plus, et ce qu'ils veulent moins.
  2. Recherchez deux faits sur le niveau cible : est-il terminal dans cette entreprise (aucune attente de promotion au-delà), et quelle est la fourchette de temps attendue au niveau actuel ? Citez les deux.
  3. Dites ce que le "pourquoi" change. Un objectif terminal plus un "pourquoi" de tranquillité d'esprit fait de l'objectif la ligne d'arrivée. Un "pourquoi" d'argent ou de périmètre signifie planifier au-delà. Écrivez cela dans la section 1 de la carte.
  4. Trouvez le processus, le calendrier et le modèle de dossier dans chaque source connectée : wiki, docs, annonces de chat, notes de réunion, le portail RH (avec consentement). Trouvez aussi comment les décisions produit sont prises : le document de décision et qui le pilote habituellement. Opportunity-scan en a besoin. Trouvez aussi ce que la direction mesure : les thèmes ou documents stratégiques de l'entreprise, les OKR et les documents de planification, et ce que disent les réunions de planification et les all-hands (dans les notes de réunion comme Granola, quand connecté). Enregistrez chaque métrique qui compte pour le domaine de l'utilisateur dans priorities : le thème, la métrique, sa référence et son objectif quand écrits (chaque fait avec une source), l'équipe qui la possède, et user_lever : owner si le poste de l'utilisateur possède le principal intrant de la métrique, input si ses systèmes l'alimentent, none si le levier se trouve dans une autre équipe. Opportunity-scan classe les propositions par rapport à cette liste. Prenez les priorités des notes de réunion, jamais des citations sur les personnes.
  5. Sauvegardez la carte (JSON et markdown) avec les entrées target, process, calendar et sections remplies.

Phase 2 : Écart de grille

  1. Trouvez l'artefact que les managers utilisent pour évaluer (un tableau des niveaux, un classeur de suivi), pas la prose écrite à son sujet. Demandez à l'utilisateur si son manager utilise un classeur de suivi. Si la prose et l'artefact divergent, utilisez l'artefact et enregistrez le décalage dans rubric.prose_mismatches.
  2. Construisez une entrée rubric.rows par comportement : le texte du niveau actuel, le texte du niveau cible, un identifiant stable (<area>.<short-slug>), et un label, le comportement en deux à quatre mots simples ("Trouver des problèmes", "Relecteur recherché"), que le board et les digests affichent à la place de l'identifiant.
  3. Marquez chaque ligne done, partial ou not_started, avec des preuves issues de career_state.py contributions, de la reconnaissance que les pairs ont donnée à l'utilisateur (quand un outil de reconnaissance est configuré, voir "Reconnaissance" ci-dessous : chaque prime avec son lien est une preuve, et la valeur d'entreprise avec laquelle elle est étiquetée pointe vers le comportement de valeurs fondamentales), des évaluations et du travail de l'utilisateur, et des notes d'évaluation antérieures que l'utilisateur partage.
  4. Sauvegardez.

Phase 3 : Organigramme et qui connaît votre travail

  1. Organigramme : la chaîne hiérarchique de l'utilisateur, qui se trouve au-dessus de chaque équipe sur laquelle il pourrait atterrir, et les changements à venir (départs, nouveaux responsables, réorganisations à partir des notes de réunion et des annonces). Chaque personne reçoit une source et un statut.
  2. Qui connaît votre travail, d'abord les preuves, puis l'utilisateur :
    • Proposez des personnes issues des propres interactions de l'utilisateur (évaluations données et reçues, fils partagés, réunions partagées, et tous ceux qui leur ont donné de la reconnaissance), chacune avec des liens de preuve. Une personne qui a reconnu l'utilisateur a vu son travail de première main ; signalez tout membre du comité de promotion.
    • Demandez à l'utilisateur de confirmer et de corriger, et d'ajouter ce qu'aucun outil ne peut voir, comme un ancien manager ou une équipe de hackathon.
    • Définissez seen_your_work et confirmed_by_user.
  3. Qui siège à la calibration : déduisez-le du document de processus, citez la phrase, et marquez-le inferred. Listez les personnes dans la salle qui n'ont pas vu le travail de l'utilisateur.
  4. Précédent : lisez les annonces de promotion récentes pour ce qui a été crédité, et écrivez "les annonces sont des récits, pas des audits" dans la carte. Proposez le niveau approfondi seulement si l'utilisateur le demande : vérification croisée dans le code, les docs et les tickets de qui a réellement réalisé le travail. C'est coûteux et désactivé par défaut.
  5. Sauvegardez.

Phase 4 : Plan

  1. Échéances : exécutez deadlines.py avec la date limite du dossier. Si la date de ce cycle est publiée, utilisez-la et passez --published. Sinon, projetez la date de l'année dernière sur ce cycle (même mois et même jour, un an plus tard) et laissez-la inferred. Demandez à l'utilisateur quelles fenêtres de vacances ou de congés sont des périodes mortes là où il se trouve, et passez-les comme --dead. Enregistrez "confortable avant X, absolu avant Y" avec son statut et son état. Si l'état est past, dites-le clairement et nommez le prochain cycle.
  2. Une prochaine étape par ligne ouverte : pour chaque ligne non done, écrivez next_step : l'action concrète unique la moins coûteuse qui ajouterait des preuves, adaptée à ce que vous avez trouvé sur l'entreprise ("tapez /interview dans le canal recrutement", "proposez une session de pair sur le tableau de bord partenaire", "demandez à votre manager un morceau de la feuille de route à co-piloter"). Le board liste les trois plus grands écarts avec ces étapes, donc rendez chacune réalisable en une semaine, pas un objectif.
  3. Préparation du dossier : exécutez python3 <plugin root>/lib/career/coordinator.py readiness --home "$HOME" --today <date> pour le comptage des preuves de chaque ligne de grille (entrées de journal étiquetées avec la ligne plus les propres preuves de la ligne), puis marquez chaque section de modèle strong, thin ou empty à partir des lignes sur lesquelles elle s'appuie.
  4. Choix des feedbacks pairs : à partir de recognition.py summary, les personnes qui ont le plus reconnu l'utilisateur, et pour quoi, sont les premiers candidats pour les feedbacks pairs du dossier écrit (3 à 5) ; ajoutez-les à la note Feedback des pairs.
  5. Questions au manager : tout ce qui est encore inconnu, plus la question de préparation ("le cycle est-il réaliste, et que manque-t-il ?").
  6. Exécutez map_schema.py check. Corrigez les erreurs, puis sauvegardez.
  7. Montrez à l'utilisateur un bref résumé : l'objectif, les deux dates de conversation, les comportements Senior pas encore montrés (par étiquette), qui doit encore voir leur travail, et les questions pour leur manager. Pointez vers promotion-map.md.

4. Mise à jour

  1. Exécutez map_schema.py check, et lisez career/flags.json s'il existe (d'autres compétences écrivent des signaux d'obsolescence ici, comme une réorganisation, un départ ou un calendrier publié). Mettez à jour la reconnaissance avec python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD> (appliquez son écriture planifiée de career/recognition.json avec l'outil Écrire ; il a besoin du réseau) quand un outil de reconnaissance est configuré.
  2. Re-recherchez uniquement les sections obsolètes ou signalées. Gardez chaque autre section telle quelle.
  3. Demandez à l'utilisateur "quelque chose a changé ?", couvrant l'objectif, le manager, l'équipe et les personnes qui ont vu leur travail.
  4. Si la section calendrier est revérifiée, ou un indicateur dit que le calendrier a été publié, réexécutez deadlines.py et mettez à jour calendar.manager_conversation.
  5. Mettez à jour la next_step de chaque ligne ouverte lorsque les preuves pour celle-ci ont évolué (une étape terminée ou qui n'est plus la moins coûteuse est remplacée), et ajoutez tout label manquant.
  6. Mettez à jour checked_at pour chaque section revérifiée, effacez les indicateurs que vous avez traités, et sauvegardez.

Reconnaissance

Quand l'entreprise de l'utilisateur utilise un outil de reconnaissance par les pairs (Bonusly aujourd'hui), ses remerciements sont la preuve que l'utilisateur n'a pas eu à les enregistrer. Configuration : l'utilisateur crée un jeton API personnel dans l'outil et le sauvegarde dans ~/.config/flagrare/bonusly-token (ou le fichier nommé par skills.career.recognition.token_file dans config.json). Ne stockez jamais le jeton dans config.json ou un dépôt, et ne le collez jamais dans le chat. Exécutez ensuite python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD> (appliquez son écriture planifiée de career/recognition.json avec l'outil Écrire ; il a besoin du réseau) ; recognition.py summary donne les totaux, les valeurs d'entreprise, et qui a le plus reconnu l'utilisateur ; les remerciements des comptes automatiques de l'outil (anniversaires, bienvenues) sont comptés à part et jamais traités comme des personnes ou des preuves. Ne citez que ce qui est dit sur l'utilisateur. Rien n'est jamais envoyé via l'outil.

5. Mode dossier (/flagrare:promotion packet)

Quand la date limite du dossier approche, ou que l'utilisateur le demande :

  1. Chargez la carte ; s'il n'y en a pas, exécutez d'abord la première exécution. Rassemblez les preuves depuis la date de la dernière promotion (ou la date d'embauche) : utilisez /flagrare:brag-doc pour les fenêtres jusqu'à un mois et /flagrare:impact-timeline pour les plus longues.
  2. Rédigez le dossier dans le modèle de l'entreprise, à partir de process.packet_template (si le modèle est inconnu, utilisez cette forme commune et dites qu'il s'agit d'un repli : les champs d'en-tête, puis 2 à 3 projets (rôle, estimation...)

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés