Skill vs Rule · Chargement 3 niveaux · SKILL.md · Runbook 6 étapes · Mac 7×24
Collez-vous à chaque fois une longue invite « Créer PR + Test + Mettre à jour CHANGELOG » dans le curseur ? Agent Skill distille des flux complexes dans des Runbooks réutilisables, et avec le partage des rôles Règle et le chargement incrémentiel en trois étapes, vos agents 2026 se comporteront davantage comme des collègues avec des SOP que comme des discussions ponctuelles. Cet article s'adresse aux développeurs qui répètent des invites complexes. Une comparaison entre Skill vs Rule, la structure SKILL.md et l'écosystème agentskills.io (compétences communautaires 31 000+), les étapes pour créer votre première compétence avec le Runbook en 6 étapes et comment un Mac Mini M4 par mois prend en charge la combinaison d'agents et de compétences 7 × 24.
L'"assistant de codage IA" de 2024-2025 sera essentiellement un achèvement conversationnel, vous obligeant à réexpliquer à chaque fois le contexte, les contraintes et les étapes. En 2026, les agents curseur (plus de 2,4 améliorations des compétences) seront accomplis en tant que tâches : lire des référentiels, modifier plusieurs fichiers, appeler des outils et livrer selon les règles de l'équipe. Les connaissances doivent être plus qu'un simple historique de discussion et doivent êtreexternalisées sous la forme d'un ensemble de compétences versionnables.
Agent Skill est un dossier sous .cursor/skills/ ou au niveau utilisateur ~/.cursor/skills/. Le noyau est SKILL.md (frontmatter YAML + corps Markdown), auquel vous pouvez joindre des scripts/, des références/, des modèles et des listes de contrôle. L'agent lit uniquement le nom et la description pendant la étape de découverte, et après avoir fait correspondre la tâche, il active et charge le texte intégral et tous les fichiers auxiliaires nécessaires sur demande. Évitez de mettre 50 pages de runbooks dans le contexte à la fois.
.cursor/rules Si vous écrivez "commentaires interdits" et "pnpm requis", c'est un garde-fou complet. Si le même "release + révision du code + mise à jour de la doc" est répété 3 fois par semaine, si vous continuez à étendre la règle, vous payerez plus de tokens par conversation et ce sera difficile à partager avec vos collègues. La compétence est la réutilisation des flux et la règle est la limite de comportement : elles seront comparées dans le tableau de la section suivante.
Les invites longues ne peuvent pas être versionnées : Les bonnes instructions sont dispersées dans Notion, etc. et ne peuvent pas être lues par l'agent. Les modifications apportées à un seul endroit n’atteignent pas toute l’équipe.
Inflation du contexte : le collage de l'intégralité du runbook dans une conversation prend de la place pour le code et les différences, ce qui entraîne l'interruption de tâches longues.
Instabilité déclenchante :Une clause de routage structurée description est manquante et l'agent ne peut pas déterminer quel manuel ouvrir.
Aucune divulgation étape par étape :De longs scripts et une documentation API, payant l'intégralité du jeton, même pour les sous-tâches les plus simples.
Ne peut pas être réutilisé par l'équipe : Impossible de consulter, fusionner et annuler les expériences réussies de discussions individuelles comme Git.
Les règles sont des règles de circulation affichées sur le pare-brise ; Les compétences sont des manuels intégrés au véhicule : Vous n'avez pas besoin de tourner chaque page pour trouver le problème.
Règles du curseur (.cursor/rules/*.mdc ou les règles du projet) sont injectés toujours ou avec des globes comme configuré au démarrage de la session, et abordent le style de codage, les lignes rouges de sécurité et les conventions de structure du référentiel. Les compétences d'agent suivent agentskills.io (norme ouverte depuis 2025) et conviennent aux flux multi-étapes, à la connaissance métier et aux scripts exécutables.
| Perspective | Règle | Compétence d'agent |
|---|---|---|
| Minutage de chargement | Injecté au début de la session ou correspondance de chemin | Découvrir → Activer → références/scripts à la demande |
| Scène typique | Commentaires interdits, règles de commit, sélection du framework | Création de relations publiques, vérification du déploiement, intégration de l'API de domaine, workflow /slash |
| Occupation contextuelle | Résident. Si le nombre de lignes est important, elles seront occupées en continu | Uniquement les métadonnées lorsqu'elles ne sont pas déclenchées. Déploiement par étapes après le déclenchement |
| Même si | Manuel de l'employé/Clause de conformité | SOP de rôle + Boîte à outils (scripts, modèles, documents externes) |
références/ pour une lecture à la demande. scripts/validate.sh dans le bac à sable et renvoie le résultat à la conversation. La communauté possède des compétences officielles/semi-officielles telles que create-hook, create-rule, babysit (fusion PR et CI) et split-to-prs. Relation avec MCP : MCP se connecte à des systèmes externes et les compétences indiquent aux agents quand et dans quel ordre utiliser les outils (combinés et non exclusifs).
Ce qui suit a été vérifié avec Cursor 2.4+. Générez un squelette avec le /create-skill intégré et faites-le converger selon les règles de l'équipe. Mon objectif est de faire de l'"Invite que j'ai finalement pu écrire au troisième essai" un dossier consultable dans le référentiel.
Entrez /create-skill dans la conversation de l'agent :Décrivez le type de tâche, le mot déclencheur, les entrées/sorties et les contre-indications, et générez la première version SKILL.md et l'arborescence des répertoires.
Sélectionner la portée : Niveau du projet .cursor/skills/<skill-name>/ partagé avec Git. La classe personnelle ~/.cursor/skills/ est destinée à la personnalisation entre référentiels (ne valide pas la clé privée).
Écrivez une description pour le frontmatter :Ceci n'est pas un résumé, mais une clé de routage. Écrivez « UTILISER lorsque l'utilisateur demande à… » et « NE PAS utiliser pour… » pour augmenter la précision de la correspondance au stade de la découverte.
Le texte est une divulgation étape par étape :Les étapes principales se trouvent dans SKILL.md. Texte long, OpenAPI, exemple JSON sur references/, script sur scripts/.
Testez le déclencheur :Vérifiez 3 exemples positifs (doivent être activés) et 2 contre-exemples (non activés) dans une nouvelle session. Vérifiez si seuls les fichiers nécessaires sont répertoriés dans Contexte.
Migrer les anciens éléments : pour les règles volumineuses et les commandes ponctuelles, utilisez /migrate-to-skills (ou divisez manuellement) pour déplacer le type de flux vers les compétences. La règle ne laisse qu’une courte ligne rouge.
--- nom : release-pr-runbook description : À UTILISER lorsque l'utilisateur demande à ouvrir une version PR, à envoyer une version améliorée ou à exécuter la liste de contrôle de pré-fusion. NE PAS utiliser pour un correctif sans journal des modifications ou pour des modifications de dépendances uniquement. --- # Publier le Runbook des relations publiques ## Rassembler - Lisez la version package.json et les balises git récentes. - Répertoriez les PR ouverts ciblant le principal. ## Agir - Version Bump par semestre. - Mettez à jour CHANGELOG.md avec des puces destinées à l'utilisateur. ## Vérifier - Exécutez la suite de tests et Lint. - Confirmez CI vert avant de demander un examen.
| Chemin/Champ | Rôle |
|---|---|
SKILL.md | Obligatoire. frontmatter + Runbook principal (< 500 lignes recommandées) |
nom | ID de trait d'union minuscule. Correspond au nom du dossier |
description | Clause de routage déclencheur. Contient UTILISER quand / NE PAS |
scripts/ | Validation/générateur exécutable. L'agent appelle à la demande |
références/ | Documentation longue, description de l'API. Lire après activation |
actifs/ | Modèle, diagramme, exemples de paramètres (facultatif) |
La mise en œuvre des compétences du curseur correspond à agentskills.io et peut être organisée en trois niveaux : elle est directement liée à la facturation et à la stabilité des jetons.
Découverte :Au démarrage ou lors de la numérisation, seuls le nom + la description (environ plusieurs dizaines de jetons par compétence) de chaque compétence sont chargés pour former un "catalogue manuel disponible".
Activation :Après l'intention de l'utilisateur ou la correspondance du mot clé, injectez le texte intégral de SKILL.md (généralement des centaines, voire des milliers de jetons).
À la demande :Charger/exécuter uniquement lorsqu'un lien de corps pointe vers des références/*.md ou appelle des scripts/*. N'ouvrez pas complètement un livre épais à chaque fois.
Dans Skill design, placez un arbre de décision dans la première moitié du texte (déterminez d'abord la scène A/B), et les matériaux épais vont aux références. Si le résultat du script est volumineux, la compétence demande à l'agent de renvoyer un résumé des lignes importantes uniquement, plutôt que de recoller le texte intégral dans le contexte.
Point : Si vous écrivez une description comme un résumé marketing, les faux déclencheurs augmenteront. Règles de routage (condition + exclusion). La compétence de création officielle vous demandera le mot déclencheur à plusieurs reprises – cela vaut la peine.
Les compétences de haute qualité suivent quatre principes. Trois étapes : description racine, divulgation progressive, responsabilité unique (1 compétence 1 type de tâche) et rassembler-agir-vérifier. Ne chevauchez pas les règles : la règle est "Test requis" et la compétence est "Étapes pour exécuter des tests d'intégration dans ce référentiel et lire les journaux d'échecs".
| Compétence / Direction | Scène à affronter | Points clés |
|---|---|---|
| Recherche d'invites | Optimisez les invites en double, comparez les modèles de communauté | Réduisez la nécessité de réinventer la roue et alignez le format d'écriture |
| Bonnes pratiques React | Composants, RSC, performances et a11y | Externaliser les règles Vercel/équipe sous forme manuelle |
| babysit/compétence RP | Commentaires RP, échecs CI, conflits de fusion | GitHub CLI fonctionne avec les journaux CI |
| create-rule / create-skill | Gouvernance de la configuration du curseur elle-même | Meta Skill. Unifiez l'assise de votre équipe |
| sdk | Intégration du SDK Curseur/API de l'agent | Appeler l'agent par programmation depuis le backend ou le pipeline |
| boucle | Patrouille périodique, agent de type cron | Nécessite un hôte stable 7×24. Voir la section 6 |
SKILL.md. /create-skill, /migrate-to-skills dans le flux de travail par défaut. description n'est pas un résumé d'article mais un prédicat de routage - soulignent la documentation officielle et le guide de création de compétences. Remarque :N'écrivez pas de clés privées ou de renseignements personnels du client dans la description (toujours visibles sur L1). Les scripts utilisent des variables d'environnement. gitignorez l'annexe confidentielle des références/ et expliquez comment l'obtenir dans le texte de la compétence.
L'écosystème de compétences ne se limite pas à un seul IDE. agentskills.io fournit des normes, des concepts de validation et un point d'entrée d'index qui permet aux équipes de sous-moduler et de publier des compétences internes (similaires au NPM interne). Une voie réaliste pour les développeurs individuels consiste à acquérir une compétence proche de la communauté → ajuster la description et les références/ → revoir la différence dans PR.
Les compétences s'étendent de "l'assistance au codage" à l'automatisation 7×24——/loop pour les analyses planifiées du référentiel, Telegram/Slack pour /mac-quote, le SDK Cursor exécute l'agent résident côté serveur ; la sélection de l'hôte affecte l'intérêt composé de la compétence.
~/.cursor/skills sur une longue période en tant que « mémoire organisationnelle ». Configuration type : clone de projet et sous-module Skills fixés sur le Mac loué ; après merge, le Hook exécute scripts/verify.sh. Le bot IM transmet l'intention, le Mac exécute selon le Skill — comme Hermes Gateway 7×24 et la mémoire persistante : l'agent devient une infrastructure, Cursor Skills reste proche du flux IDE quotidien.
Un portable et un VPS économique suffisent pour rédiger et valider un Skill une fois, mais le sommeil, l'absence d'automatisation macOS native et un état ~/.cursor non gardé affaiblissent le 7×24. Les Skills purement API tiennent dans le cloud ; dès que le runbook exige Keychain ou outils Apple, la migration coûte cher. Les équipes qui veulent un « collègue résident » avec des économies de tokens cumulées sur des semaines regroupent uptime, KVM distant et forfait mensuel via la location cloud VpsMesh Mac Mini M4. Tarifs : tarifs Mac Mini M4, aide : centre d'aide, commande : page commander.
MCP (Model Context Protocol) est la couche de connexion avec le monde extérieur : bases de données, API GitHub, navigateur, microservices. Agent Skill ne remplace pas MCP ; c'est un runbook Markdown qui indique quoi rassembler en premier, quels outils MCP appeler et dans quel ordre, puis comment vérifier. MCP est la prise et le câble ; Skill est la procédure de démarrage du manuel.
Les courtes contraintes à chaque commit relèvent des Rules (pas de commentaires, gestionnaire imposé, etc.). Les flux rares, longs, avec scripts et annexes relèvent des Skills. Si la même longue invite revient une troisième fois, utilisez /create-skill. Gardez peu de Rules pour ne pas saturer le contexte ; migrez le flux avec /migrate-to-skills.
Non requis. API cloud pure, compétence indépendante de macOS peut être programmée sur Linux VPS à partir du Cursor CLI/SDK. Si vous ne souhaitez pas arrêter Apple Eco Automation, le trousseau local et ~/.cursor/skills en fermant le couvercle comme Gateway, les frais mensuels Mac Mini M4 sont faciles. Tout d’abord, vérifiez la courbe de déclenchement et de jeton avec une location d’un mois. Le prix est de frais de location du Mac Mini M4, et l'application est la page de commande.