Génération de skill depuis sources

VérifiéPrudence

Outil CLI pour générer un fichier SKILL.md à partir de MCP, README ou OpenAPI. Options comme --platform et --dry-run.

Spar Skills Guide Bot
DeveloppementIntermédiaire
22/07/2026
Claude Code
#skill-generation#scaffolding#mcp#openapi#codegen

Recommandé pour

Synthèse automatique

Génère un squelette de SKILL.md à partir d'une config de serveur MCP, d'un README ou d'une spec OpenAPI via la commande `ct generate skill`, puis le valide et reconstruit l'index.

Points forts

  • Prend en charge trois sources d'entrée distinctes : config MCP, README et spec OpenAPI
  • Options utiles comme `--dry-run` pour prévisualiser et `--examples N` pour contrôler le nombre d'exemples générés
  • Intègre une étape de validation (`validate_skill.py`) et de reconstruction de l'index (`build_index.py`) après génération
  • Permet de cibler la plateforme de destination (anthropic, openai, universal)

Limites

  • Dépend d'un outil externe `ct` qui doit être installé et disponible
  • Le SKILL.md produit doit être relu et corrigé manuellement pour être exact
  • Ne couvre pas la mise à jour d'un skill existant ni la gestion des erreurs de génération
Quand l'utiliser

Pour amorcer rapidement un nouveau skill à partir d'une API, d'une spec ou d'un README existant plutôt que de rédiger le SKILL.md à la main.

Quand l'éviter

Si vous écrivez un skill entièrement à la main ou si votre source n'est ni une config MCP, ni un README, ni une spec OpenAPI.

Analyse de sécurité

Prudence
Score qualité84/100

The skill uses legitimate file-generation and bash tooling, with no destructive commands, obfuscation, credential exfiltration, or curl|sh patterns. However, it executes an external CLI and writes files, so it warrants caution rather than a fully safe rating.

Points d'attention
  • •Invokes bash commands and an external `ct` CLI to generate files under `./skills/<slug>/` without requiring confirmation, though `--dry-run` is available.
  • •Reads input files such as MCP configs, READMEs, and OpenAPI specs that may contain sensitive configuration; generated output could inadvertently include secrets if the source does.
  • •Does not declare allowed-tools despite including executable bash snippets.
Comment cette analyse est faite

Exemples

From an MCP config
Generate a skill named github-tools from my MCP config at ./configs/github-mcp.json into ./skills/github-tools/, but do a dry run first so I can review the output.
From an OpenAPI spec
Create a skill called stripe-api from ./specs/stripe-openapi.json with 5 examples, then validate it with tooling/validate_skill.py.
From a README
Build a skill called acme-sdk from ./README.md, add the CHANGELOG, and rebuild the index when you're done.

Generate a new skill from various sources.

Arguments: $ARGUMENTS (source type and path)

From MCP Server

ct generate skill --from-mcp <config.json> --name <skill-name> --output ./skills/<slug>/

From README

ct generate skill --from-readme <README.md> --name <skill-name> --output ./skills/<slug>/

From OpenAPI Spec

ct generate skill --from-openapi <openapi.json> --name <skill-name> --output ./skills/<slug>/

Options

  • --platform anthropic|openai|universal - Target platform (default: universal)
  • --dry-run - Preview without writing files
  • --examples N - Number of examples to generate (default: 3)

After generation:

  1. Review generated SKILL.md for accuracy
  2. Validate: python tooling/validate_skill.py skills/<slug>/
  3. Add CHANGELOG.md if not generated
  4. Rebuild index: python tooling/build_index.py

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 annexes

Ce 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.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/generate-skill-from-various-sources-mrwakdvb/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/generate-skill-from-various-sources-mrwakdvb' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/generate-skill-from-various-sources-mrwakdvb/download' --output '.skill-downloads/generate-skill-from-various-sources-mrwakdvb/SKILL.md.part' && mv '.skill-downloads/generate-skill-from-various-sources-mrwakdvb/SKILL.md.part' '.skill-downloads/generate-skill-from-various-sources-mrwakdvb/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.

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

Le fichier ne fournit pas un en-tête name/description exploitable pour cette procédure native. Le téléchargement reste disponible pour lecture ; utilisez le mode manuel ci-dessous.

Mode 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/generate-skill-from-various-sources-mrwakdvb/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.

Skills similaires