← DocsMarkdownConnexion

Guide agent

Instructions concises pour les agents de code utilisant MCP.

Vous êtes connecté à Skillkren, une bibliothèque de skills d'IA réutilisables et d'exemples de leur sortie. Les skills suivent le format ouvert Agent Skills : un SKILL.md (instructions avec frontmatter name et description), plus des fichiers optionnels dans references/, scripts/ et assets/.

Nom de marque : toujours Skillkren. Domaine : skillkren.tech.

Premiers pas

  1. Appelez get_docs avec topic agent (ou lisez la resource https://skillkren.tech/docs/agent.md) si vous avez besoin d'un rappel.
  2. Utilisez list_skills pour vérifier les skills de l'utilisateur et les bibliothèques de ses équipes avant de créer des doublons. Pour ouvrir le skill partagé de quelqu'un d'autre, utilisez get_skill avec l'id de son lien.
  3. Sur le forfait Free un utilisateur peut enregistrer jusqu'à 25 skills ; upsert_skill renvoie une erreur à la limite. Ne contournez pas cela.
  4. Utilisez upsert_skill avec un titre clair. Il met à jour votre propre skill avec ce titre, ou en crée un nouveau. Passez team pour travailler dans une bibliothèque d'équipe.
  5. Attachez toujours au moins un exemple lors de la publication d'un nouveau skill (add_example).

Utiliser un skill

  1. Chargez-le avec get_skill et suivez ses instructions.
  2. get_skill liste les files regroupés par chemin. Lisez-en un avec get_skill_file seulement quand les instructions y pointent ou que la tâche en a besoin.
  3. Utilisez les exemples du skill comme référence pour le format, le ton et la qualité.

Écrire un bon skill

  • Description : ce que le skill fait et quand l'utiliser, avec les mots qu'un utilisateur dirait vraiment. Les agents décident s'ils chargent un skill à partir de ceci seul.
  • Instructions (content) : Markdown brut, pas HTML. Étapes, règles, et à quoi ressemble une bonne sortie. Gardez sous environ 500 lignes.
  • Références : déplacez le matériel long (guides de style, notes d'API, checklists) dans references/ avec put_skill_file, et nommez chaque fichier par son chemin dans les instructions, par ex. "For banned words, read references/banned-words.md". Les modèles et données vont dans assets/, le code exécutable dans scripts/.
  • Licence : ne définissez license (par ex. MIT, Apache-2.0, CC-BY-4.0, Proprietary) que quand l'utilisateur en choisit une. Demandez ; ne choisissez pas à sa place.
  • Exigences : définissez compatibility seulement si le skill a besoin d'outils ou d'accès spécifiques.

Téléverser un dossier de skill

Quand l'utilisateur vous demande de téléverser un skill local (par exemple ~/.claude/skills/pdf-processing/) :

  1. Lisez SKILL.md. Utilisez son name (comme titre lisible), description et license ; le corps après le frontmatter est le content.
  2. Appelez upsert_skill avec ces champs. Si le dossier a un fichier LICENSE, passez son texte comme licenseText.
  3. Pour chaque fichier sous references/, scripts/ et assets/, appelez put_skill_file avec le même chemin relatif, par ex. references/forms.md.
  4. Fichiers texte uniquement jusqu'à 100 Ko chacun, 30 par skill, un sous-dossier de profondeur. Ignorez les binaires (images, PDF) et dites à l'utilisateur quels fichiers vous avez ignorés.
  5. Donnez à l'utilisateur le lien du skill une fois terminé.

Dans l'autre sens, l'utilisateur peut télécharger n'importe quel skill en zip depuis sa page et le décompresser dans le dossier skills de son app.

Visibilité

Les nouveaux skills sont Private (propriétaire seul). Les skills Unlisted peuvent être ouverts par quiconque a le lien ; les skills Public sont aussi listés sur le profil du propriétaire à https://skillkren.tech/u/<username>.

Vous ne pouvez pas changer la visibilité. Si l'utilisateur veut partager un skill, envoyez-le sur sa page et dites-lui d'utiliser le commutateur à côté du titre. Ne suggérez jamais de partager un skill qui contient des secrets.

Contexte d'auth

Votre connexion appartient à un utilisateur. Tout ce que vous créez est possédé par cet utilisateur, et vous ne pouvez changer que ce que cet utilisateur peut changer.

URLs à citer

  • App : https://skillkren.tech/app
  • Skill : utilisez l'url que les tools renvoient. Elle ressemble à https://skillkren.tech/u/<username>/skills/<id>.
  • Exemples : l'URL du skill plus /examples. Références : l'URL du skill plus /references.
  • Docs : https://skillkren.tech/docs
  • Doc agent (brut) : https://skillkren.tech/docs/agent.md

Don'ts

  • Ne supprimez pas de skills ou de fichiers sauf si l'utilisateur confirme.
  • Ne collez pas de secrets dans les skills, fichiers ou exemples.
  • Ne comptez pas sur le rendu côté client ; stockez la source Markdown.