Générer un nouveau skill pour hms-commander

VérifiéSûr

Guide pour créer un nouveau skill en suivant la structure existante de hms-commander, avec étapes et conventions.

Spar Skills Guide Bot
DeveloppementDébutant
22/07/2026
Claude Code
#skill-authoring#scaffolding#templates#claude-code#conventions

Recommandé pour

Synthèse automatique

Génère l'échafaudage d'une nouvelle skill dans .claude/skills/ en suivant la structure de répertoires et le modèle SKILL.md du dépôt hms-commander.

Points forts

  • Fournit un modèle SKILL.md complet avec frontmatter (name, description, mots-clés de déclenchement) et sections obligatoires
  • Énonce explicitement les conventions de nommage : répertoires en snake_case, SKILL.md en majuscules, exemples en kebab-case
  • Inclut l'étape de mise à jour du tableau « Active Skills » dans .claude/INDEX.md
  • Renvoie à des skills existantes (hms_execute_runs, hms_clone_components) comme références concrètes

Limites

  • Fortement couplé au dépôt hms-commander et à son arborescence .claude/ spécifique
  • Aucune validation, lint ou test du skill généré : la qualité du contenu reste à la charge de l'auteur
  • Suppose connus les fichiers référencés (règles hec-hms, notebooks d'exemples) sans en décrire le format
Quand l'utiliser

À utiliser lorsqu'on veut ajouter une nouvelle skill au projet hms-commander en respectant la structure et l'index existants.

Quand l'éviter

Ne pas l'utiliser pour créer des skills hors de l'écosystème hms-commander ou pour réviser en profondeur le contenu d'une skill déjà existante.

Analyse de sécurité

Sûr
Score qualité75/100

The skill only instructs creating directories and writing template files for a new skill. It does not execute destructive commands, network operations, or handle secrets. The single mkdir command is benign and part of normal file scaffolding.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

Scaffold a new skill
Create a new skill called hms_extract_results following the existing skill structure, with a SKILL.md from the template and register it in .claude/INDEX.md.
Scaffold with examples folder
Scaffold a skill named hms_configure_forecast under .claude/skills/, add an examples/ folder with a basic usage markdown file, and add the row to the Active Skills table.
Add and index a skill
I need a new skill for reading HMS project files — set up the directory and SKILL.md with trigger scenarios and workflows, then update the skills index.

Scaffold a new skill for hms-commander following the existing skill structure.

Skill Structure

.claude/skills/{skill_name}/
├── SKILL.md          # Main skill document (required)
├── examples/         # Working code examples (optional)
│   └── *.md
└── reference/        # Detailed API docs (optional)
    └── *.md

Step 1: Create Skill Directory

mkdir .claude/skills/{skill_name}

Step 2: Create SKILL.md

Use this template (see hms_execute_runs/SKILL.md for a full example):

---
name: {skill_name}
description: |
  One paragraph description of what this skill does.
  Trigger keywords: key, terms, that, invoke, this, skill.
---

# {Skill Title}

## Quick Start

Minimal working example to accomplish the core task.

## Primary Sources

**Code (Authoritative API)**:
- `hms_commander/{MainClass}.py` — Complete docstrings

**Examples (Working Demonstrations)**:
- `examples/{NN_notebook}.ipynb` — Cells X-Y

**Rules (Patterns & Decisions)**:
- `.claude/rules/hec-hms/{relevant-rule}.md`

## When to Use This Skill

**Trigger Scenarios**:
- User says "..."
- User mentions "..."

## Core Capabilities

### Capability 1
Pattern description.

## Common Workflows

### Workflow 1: Title
```python
# Code example

Troubleshooting

Common issues and solutions.

Integration Points

Before this skill: What to do first After this skill: What to do next

Related Skills

  • other_skill — Description

## Step 3: Add Examples (Optional)

Create `examples/` with markdown files showing real usage patterns.

## Step 4: Update INDEX.md

Add the new skill to `.claude/INDEX.md` "Active Skills" table:

```markdown
| **{skill_name}/** | Purpose description | trigger, keywords, here |

Skill Naming Conventions

  • Directory name: snake_case (e.g., hms_execute_runs)
  • Main file: SKILL.md (always uppercase)
  • Examples: kebab-case.md (e.g., basic-run.md)

Reference

  • Example full skill: .claude/skills/hms_execute_runs/SKILL.md
  • Simpler skill: .claude/skills/hms_clone_components/SKILL.md
  • Index: .claude/INDEX.md "Skills" section

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/scaffold-a-new-skill-for-hms-commander-mrwakdwg/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/scaffold-a-new-skill-for-hms-commander-mrwakdwg' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/scaffold-a-new-skill-for-hms-commander-mrwakdwg/download' --output '.skill-downloads/scaffold-a-new-skill-for-hms-commander-mrwakdwg/SKILL.md.part' && mv '.skill-downloads/scaffold-a-new-skill-for-hms-commander-mrwakdwg/SKILL.md.part' '.skill-downloads/scaffold-a-new-skill-for-hms-commander-mrwakdwg/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/scaffold-a-new-skill-for-hms-commander-mrwakdwg/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