npc-actions

Avant de commencer : lis ce prompt d'installation au complet, dis-moi en quelques lignes ce que ce skill fait et ce que son installation implique, et attends mon feu vert avant de faire quoi que ce soit d'autre. Prérequis : aucun pour l'installation elle-même : aucun compte, aucune clé API, aucun service payant, et rien d'autre à installer d'abord. Pour utiliser le skill ensuite comme décrit, il te faut un compte TypeSafe et une clé API (variable d'environnement TYPESAFE_API_KEY) pour son service de jugement typé Jev, et une intégration de jeu ou de mod qui relie les noms d'actions aux animations, tâches ou changements de vêtements de ce jeu ; SKILL.md lui-même ne nomme aucun prix ni aucun plan payant pour TypeSafe, et la solution de rechange sans Jev est un deuxième appel LLM avec un schéma JSON, via ton propre LLM. Ne mets jamais la clé dans un fichier. Installe-moi « npc-actions ». C'est un playbook en un seul SKILL.md pour faire réagir physiquement les PNJ à une conversation et leur faire suivre des ordres parlés : Jev de TypeSafe retourne un choix typé et une probabilité en environ 0,1 s, et des seuils par action plus un délai de répétition décident si le PNJ gifle, frappe, serre dans ses bras, s'agenouille et supplie, fuit, fait un doigt d'honneur, se met en garde, ou ne fait rien. Dépôt : https://github.com/christos-antono/NPCTalk (le skill est le dossier .agents/skills/npc-actions/ au commit épinglé : SKILL.md seulement ; la copie identique .claude/skills/ et la copie racine skills/ sont des doublons, pas la source de cette fiche, et le reste du dépôt NPCTalk n'est pas installé) Version épinglée : installe le code au commit 59635ceb8ee010599c3caf9d9d1ee1aa114af91d exactement. Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. 1. Clone https://github.com/christos-antono/NPCTalk dans un dossier temporaire, place-toi au commit 59635ceb8ee010599c3caf9d9d1ee1aa114af91d, et copie le dossier .agents/skills/npc-actions/ de ce checkout. Compare ensuite chaque fichier du dossier aux empreintes enregistrées pour cette fiche le 2026-10-19 : [FINGERPRINTS] - SKILL.md: SHA-256 bd264453f5e2eaedbf0a5646596a9621fc51959d9f5fbe3c04cf9d4e97de5555 Si un fichier ne correspond pas, il a changé depuis la préparation de la fiche : ne l'installe pas encore, dis-moi ce que tu as trouvé et laisse-moi décider. 2. Lis SKILL.md au complet et dis-moi en mots simples : ce que le skill fait quand on l'utilise, à quels services il se connecte, s'il lit ou envoie des informations personnelles ou des clés, et tout ce qui semble inhabituel. Arrête-toi sur tout signal d'alerte et dis-le-moi avant d'aller plus loin. Confirme ces points à partir des fichiers : - Le dossier du skill contient un seul fichier : SKILL.md (3 384 octets). Il n'y a aucun code, aucun script, aucun fichier de référence et aucune liste de dépendances dans le dossier : le skill est un ensemble d'instructions pour choisir une action de PNJ deux fois par échange, plus des règles de seuils, de délai de répétition et de correspondance aux animations. - Rien n'est envoyé nulle part pendant l'installation elle-même ; le seul téléchargement à l'installation est le dossier du skill depuis GitHub au commit épinglé. Le fichier ne nomme aucune télémétrie et aucun service distant autre que TypeSafe Jev à l'usage, décrit ci-après. - À l'usage, et seulement à ce moment-là, le design envoie des données à TypeSafe : deux questions Jev par échange, une avant la réponse, en parallèle du LLM (le joueur donne-t-il un ordre ? Une action choisie avec une probabilité d'au moins 0,6 est traitée comme un ordre : le PNJ le fait et le LLM réécrit la réplique en sachant que le PNJ est en train de le faire), et une après la réponse, en parallèle de la voix (qu'est-ce que son humeur appelle ?). Dans le code de l'exemple GTA V auquel SKILL.md renvoie (examples/gta-v/mod/Jev.cs, qui ne fait pas partie de ce skill et n'est pas installé), chaque question est un POST à https://api.typesafe.ai/v1/systemone avec l'en-tête « Authorization: Bearer $TYPESAFE_API_KEY », et le corps porte l'état que Jev juge (ce que le joueur a dit et ce que le PNJ a répondu), les instructions de la question et les critères des actions. C'est une divulgation, pas une étape à exécuter pendant cette installation. - Le catalogue vit hors du dossier du skill, dans examples/gta-v/mod/ActionCatalog.cs (non installé) : chaque action a un nom, une description que Jev lit, et sa propre probabilité minimale (0,45 pour slap, punch, facepalm, square_up, threaten_gun, hug et kiss ; 0,5 pour headbutt, shirt_off pour les hommes, pants_off jusqu'aux sous-vêtements, bend_over et kneel_beg ; 0,6 pour shoot et run_away ; 0,7 pour middle_finger ; none, c'est juste parler, et c'est la plupart des échanges). Le même PNJ ne répète pas une action en moins de 60 s, sauf si on le lui ordonne. Les règles de genre (hommes seulement) et de contenu (les sous-vêtements restent en place) vivent dans le code du jeu, pas dans le prompt. - La correspondance au jeu vit dans le code du jeu (examples/gta-v/mod/NpcActions.cs dans l'exemple, non installé) : chaque nom d'action correspond à des candidats (dictionnaire d'animation et clip, une tâche comme fuir ou se battre, ou un changement de vêtements), chaque candidat est vérifié au chargement du mod, l'action se joue pendant que la réplique est dite et visée sur le joueur, et un réalisateur ou une scène scriptée peut épingler une action (do: kneel_beg) pour sauter le sélecteur. SKILL.md décrit aussi des tests avec npcvoice-check actions dans l'exemple GTA (25 échanges via Jev, dont 10 ordres) et des touches de mode dev en jeu ; n'exécute rien de tout cela pendant cette installation. - Sans Jev, SKILL.md dit qu'un deuxième appel LLM avec un schéma JSON fonctionne, mais qu'il est plus lent (0,3-1 s) et que sa confiance n'est pas calibrée, donc les seuils sont approximatifs ; peu importe qui choisit, garde la forme : un ensemble fixe, une probabilité, des seuils par action, les ordres vérifiés en premier. 3. Quand je dis « yes, install », installe-le comme skill : copie tout le dossier npc-actions dans le répertoire des skills de l'agent, dans un dossier nommé « npc-actions », en gardant son fichier (SKILL.md). N'utilise pas les routes plugin, marketplace ou npx du dépôt : elles installent tout le plugin NPCTalk ou tous ses skills, pas ce seul skill. 4. Vérifie sans appels réseau : frontmatter valide, fichier en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (par exemple : obtenir une clé API TypeSafe moi-même et définir TYPESAFE_API_KEY comme variable d'environnement, jamais dans un fichier, seulement si et quand je veux utiliser Jev ; bâtir ou fournir moi-même le catalogue d'actions côté jeu et la correspondance aux animations ; fournir moi-même tout jeu et tout échange ; utiliser le skill est une étape séparée qui ne commence que quand je le demande, et l'envoi à l'usage à TypeSafe divulgué ci-dessus arrive seulement à ce moment-là, sur des échanges que je lance). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête-toi et demande-moi.