Communitygithub.com

Publication d'un Skill Public

Catalogue et site de documentation pour IncredAgents — des compétences d'IA agent (SKILL.md) prêtes pour la production, destinées à Claude Code et aux agents compatibles. Chaque compétence obtient sa propre page avec des démonstrations réelles des résultats.

Qu'est-ce que Publication d'un Skill Public ?

Ce skill automatise le pipeline de publication qui transforme un skill privé en une release GitHub publique. Conçu pour les développeurs et les équipes utilisant Claude Code ou d'autres agents compatibles avec le format SKILL.md, il garantit que rien ne parte en production sans avoir été nettoyé des données personnelles. Le pipeline suit un ordre fixe : évaluation, nettoyage (scrub), documentation, thème graphique, empaquetage et mise en scène. Chaque étape est obligatoire, en particulier le nettoyage qui ne doit laisser passer aucun finding non résolu. Ce skill est utile pour maintenir une boutique de skills professionnelle, avec des pages web cohérentes et une traçabilité complète via le registre et le changelog.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add MyAiFreedomSystems/incredagents-site

Demander à votre IA préférée

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

Documentation

Que fait Publication d'un Skill Public ?

Exécute le pipeline de release qui transforme un skill privé en une release GitHub publique. L'ordre du pipeline est fixe : évaluer → nettoyer → documenter → thème → empaqueter → mettre en scène. Ne pas sauter l'étape de nettoyage. Rien ne sort avec des findings non résolus.

1. Évaluer

Répondre aux quatre questions dans registry/pipeline.md (vaut-il la peine d'être installé ? autonome ? nettoyable ? explicable sur une page ?). Un « non » → s'arrêter, signaler le blocage, garder le skill privé. Enregistrer le verdict dans le registre.

2. Nettoyer

Exécuter le scanner et résoudre chaque finding avant de continuer :

python3 scripts/scrub_personal.py <skill-dir>
  • Remplacer les chemins personnels par des génériques (/Users/votre_nom/..., <votre-projet>/).
  • Remplacer les noms/e-mails personnels par le contact public de la marque ou un espace réservé.
  • Supprimer les identifiants (credentials) — ne jamais autoriser un secret réel.
  • Réexécuter jusqu'au code de sortie 0. Utiliser --allow uniquement pour les chaînes publiques intentionnelles (par exemple le nom de la marque).

3. Documenter

Copier depuis references/ dans la racine du skill candidat et remplir chaque espace réservé :

  • readme-template.md → README.md (problème, installation, utilisation, licence)
  • changelog-template.md → CHANGELOG.md, première entrée ## [1.0.0] - <date d'aujourd'hui>
  • Ajouter LICENSE — le propriétaire choisit par release (ouverte ou commerciale). Ne jamais indiquer de licence ou de prix sur une page publique que le dépôt ne fournit pas réellement.

4. Thème de la page web

Copier assets/site-template/ dans le dossier du site de la release et remplacer les tokens {{PLACEHOLDER}} (nom du skill, tagline, URL du dépôt, fonctionnalités, commande d'installation). Ne pas modifier la palette, les polices ou les règles de mise en page — l'en-tête commenté dans styles.css documente les choix de marque (pas de surlignage jaune, pas de blobs lumineux, pas de texte doré sur fond marine, police script pour les accents uniquement).

5. Empaqueter

Valider la structure (le frontmatter de SKILL.md contient name + description ; seules les ressources scripts/, references/, assets/ qui existent réellement), puis zipper :

cd <parent-staging> && zip -r <nom-du-skill>.skill <nom-du-skill>

6. Mettre en scène et enregistrer

  • Déplacer le dossier nettoyé + le zip .skill + la page web dans releases/<nom-du-skill>/.
  • Mettre à jour le statut dans registry/pipeline.md et le CHANGELOG.md du projet.
  • Rapporter : ce qui a été livré, les résultats du nettoyage, les étapes manuelles restantes (git init, création du dépôt GitHub, push — ces étapes nécessitent l'accord et les identifiants du propriétaire).

Voir references/release-checklist.md pour la liste de vérification complète avant vol ; la parcourir avant de déclarer une release terminée.

Skills associés