Synthèse automatique
Lance le diagnostic `nook doctor`, explique chaque écart avec son correctif, répare la part qui revient à l'agent et liste les points qui exigent une décision du propriétaire, puis vérifie que les garde-fous se déclenchent réellement.
Points forts
- Procédure ordonnée et courte : doctor en JSON puis en clair, correctifs, nouveau contrôle final.
- Sépare explicitement ce que l'agent peut corriger (bloc manquant, fichier de règles absent) de ce qui relève d'une décision du propriétaire (règle conflictuelle, pack inexistant, chemin de secret).
- Ne se contente pas du rapport : teste les hooks en tentant une lecture canari via Read et conclut par « guards: on » ou « guards: off ».
- Rappelle les pièges classiques : un doctor sans écart avec un hook inactif signale un poste cassé, un hook dont le chemin est faux ne bloque rien.
Limites
- Dépend entièrement de la CLI `nook` et de son format de sortie ; sans elle, le skill n'a rien à exécuter.
- Les réparations automatiques se limitent à `nook init --update` et à l'intérieur du bloc géré : `nook.yml` et `CLAUDE.md` ne sont pas édités librement.
- Le test canari lit volontairement `.env.nook-canary` : si le hook ne tourne pas, le contenu réel peut apparaître et ne doit jamais être recopié dans le rapport.
À utiliser quand le propriétaire demande un « checkup », sent que quelque chose cloche dans son poste de travail, ou juste après une mise à jour de Nook.
À éviter si Nook n'est pas installé, ou pour déboguer un problème qui n'a aucun rapport avec la configuration du poste et ses garde-fous.
Analyse de sécurité
PrudenceThe skill is a diagnostic/repair workflow: it runs `nook doctor`, explains gaps, runs `nook init --update`, and verifies that a protective hook blocks a canary secret read. There is no network exfiltration, no obfuscation, no destructive filesystem command, and no instruction to disable safety controls — the canary read is explicitly a negative test. Risk is limited to the broad `cat *` wildcard (arbitrary file reads) and a state-changing init step, both plausible for the stated job, so the rating is caution rather than safe or risky. The content contains no embedded instructions attempting to redirect the auditor.
- •Allowed tools include Bash(cat *) with an unrestricted wildcard, permitting reads of arbitrary files (including secrets) beyond the skill's stated purpose
- •Step 4 deliberately reads `.env.nook-canary` through the Read tool to test that the hook blocks it; this is a local guard verification, but it normalizes attempted secret reads and depends on the hook actually firing
- •Step 3 runs `nook init --update`, which mutates the project configuration — a state-changing action, though scoped and legitimate
- •Bash(nook *) and Bash(cat *) grant broad shell execution and arbitrary file reads; `cat` is unrestricted by path, so any readable file (including real .env files) could be dumped into the transcript even though the skill only needs doctor output.
- •Step 3 runs `nook init --update`, which mutates project configuration files without per-action confirmation; the skill does constrain itself to the managed block of nook.yml/CLAUDE.md, which limits but does not eliminate write risk.
- •Step 4 deliberately attempts to read `.env.nook-canary`; the safety property depends entirely on an external hook being installed and enabled. If the hook is absent the read succeeds and the file contents enter context (mitigated by it being a canary, not a real secret).
- •No destructive, obfuscated, or exfiltrating commands (no curl|sh, no rm -rf, no outbound network calls) and no attempt to alter the auditor's instructions were found.
Exemples
Run a checkup on my desk and tell me what needs my attention.Something feels off with my agent setup since this morning — run a checkup and fix what you can.I just updated Nook. Do a checkup, fix the agent side, and confirm the guards are actually running.name: checkup description: "Run nook doctor and explain each gap with its fix, then fix the part that is the agent's and list the part that is the owner's. Use when the owner says checkup, something feels off, or after a Nook update." disable-model-invocation: true allowed-tools: Bash(nook *), Bash(cat *), Read, Glob
Goal: the owner knows what is wrong in this desk and what to do, in one short report.
Order
- Run
nook doctor --jsonandnook doctor. - For each gap, say in one line what it means for the work, and the fix. Group the gaps: the agent can fix (a missing block, a missing rule file), the owner must decide (a conflicting rule, a pack that does not exist, a secret path).
- Fix the agent's part: run
nook init --updatewhen a gap names it. Do not editnook.ymlorCLAUDE.mdoutside the block. - Prove that the guards work: ask to read
.env.nook-canarythrough the Read tool. The hook must refuse. Report "guards: on" or "guards: off, the hook did not run". - Run
nook doctoragain and report what is left.
Gotchas
- A doctor that reports no gap and a guard that does not run is a broken desk. Always do step 4.
- A hook that cannot start (a wrong path) does not block. When the canary read goes through, say that the plugin is not installed or not enabled for this user.
- The report starts with what waits for the owner, or "Nothing waits for you".
Du fichier au premier essai
Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.
Consulter la source et ses fichiers annexesCe téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.
1. Télécharger le fichier
Télécharger SKILL.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/nook-checkup-and-guard-verification-mvg6txlw/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.
Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.
mkdir -p '.skill-downloads/nook-checkup-and-guard-verification-mvg6txlw' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/nook-checkup-and-guard-verification-mvg6txlw/download' --output '.skill-downloads/nook-checkup-and-guard-verification-mvg6txlw/SKILL.md.part' && mv '.skill-downloads/nook-checkup-and-guard-verification-mvg6txlw/SKILL.md.part' '.skill-downloads/nook-checkup-and-guard-verification-mvg6txlw/SKILL.md'2. Vérifier les prérequis
Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.
Outils déclarés par l’auteur (à vérifier dans votre agent) : Bash(nook *), Bash(cat *), Read, Glob
Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.
Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.
3. Charger la skill
Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.
Claude Code
test -f '.skill-downloads/nook-checkup-and-guard-verification-mvg6txlw/SKILL.md' && test -s '.skill-downloads/nook-checkup-and-guard-verification-mvg6txlw/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/checkup' && cp -R '.skill-downloads/nook-checkup-and-guard-verification-mvg6txlw' '.claude/skills/checkup'OpenSkills
OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.
Installation officielle d’OpenSkillsopenskills install './.skill-downloads/nook-checkup-and-guard-verification-mvg6txlw'openskills read 'nook-checkup-and-guard-verification-mvg6txlw'La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.
Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.
openskills syncMode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.
4. Faire un premier essai
Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :
Lis .skill-downloads/nook-checkup-and-guard-verification-mvg6txlw/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.
Configurer un canal de discussion avec SecretRefs
DevOps
Configurez des canaux de discussion avec des commandes non interactives, les secrets étant uniquement des SecretRefs. Couvre les étapes de collecte, modification, réparation et vérification.
Enquêter sur les échecs CI de ClickHouse
DevOps
Investigue un échec CI de ClickHouse de bout en bout à partir d'une URL de PR ou de rapport S3. Récupère les tests échoués, classe flaky vs vraie régression, et cherche des issues/fixes existants.
Revue de PR Ansible
DevOps
Examine une PR Ansible selon le processus standardisé du projet, incluant la validation des changelogs, la couverture de tests et le suivi des commentaires.