Notre avis

Ce skill guide l'utilisateur dans la création de nouveaux skills personnalisés pour Claude Code, incluant la structure des fichiers, le format du skill.md et la gestion des secrets.

Points forts

Explique clairement la structure des répertoires et le format du fichier skill.md.
Inclut des bonnes pratiques de sécurité pour les clés API.
Permet de créer des scripts d'assistance (Python, shell).
Guide étape par étape avec des exemples concrets.

Limites

Ne couvre pas la gestion des dépendances ou des environnements virtuels.
Les skills créés ne fonctionnent que dans Claude Code, pas dans d'autres outils.
Aucune fonctionnalité de test ou de débogage intégrée.

Quand l'utiliser

Utilisez ce skill lorsque vous souhaitez créer un nouveau skill, une commande slash ou une automatisation personnalisée pour Claude Code.

Quand l'éviter

N'utilisez pas ce skill si vous avez besoin de créer un plugin ou une intégration pour un autre outil que Claude Code.

Exemples

Create a simple greeting skill

Create a Claude Code skill called 'greet' that prints a friendly greeting.

Create a skill with a Python script

I want a skill that generates an image using Python. Set it up with a script in the scripts folder.

Create a skill that requires an API key

Create a skill called 'weather' that fetches weather data using an API key. Make sure to document the env variable.

name: skill-creator description: Create new Claude Code skills. Use when the user wants to create a custom skill, slash command, or automation. argument-hint: <skill-name> [description]

Skill Creator

Help users create new Claude Code skills.

Skill Structure

Skills live in ~/.claude/skills/<skill-name>/ with this structure:

~/.claude/skills/
  <skill-name>/
    skill.md          # Required: skill definition
    scripts/          # Optional: helper scripts
      script.py
      script.sh

skill.md Format

---
name: skill-name
description: Short description for Claude to know when to use this skill.
argument-hint: <arg1> [optional-arg] # Optional: shown in /help
allowed-tools: Bash(pattern), Read # Optional: restrict tool access
---

# Skill Title

Instructions for Claude when this skill is invoked.

## Usage

Document how to use the skill.

## Examples

Show example invocations.

Frontmatter Fields

| Field | Required | Description | | --------------- | -------- | -------------------------------------- | | name | Yes | Skill identifier (lowercase, hyphens) | | description | Yes | When Claude should use this skill | | argument-hint | No | Usage hint shown in /help | | allowed-tools | No | Restrict which tools the skill can use |

Handling Secrets

Never try to read secrets from files. If a skill requires an API key or secret:

Document the required environment variable in the skill
If the secret is missing, tell the user to:
- Set the environment variable (e.g., export API_KEY=xxx)
- Restart Claude Code
Never attempt to read .env, .zshrc.secret, or similar files

Example section for skills needing secrets:

## API Key

**Do not try to read secrets from files.** If the API key is not available, ask the user to:

1. Set the `YOUR_API_KEY` environment variable
2. Restart Claude Code

Creating the Skill

When the user asks to create a skill:

Ask clarifying questions if needed:
- What should the skill do?
- Does it need external APIs? (if so, which env var?)
- Should it have helper scripts?
Create the directory: mkdir -p ~/.claude/skills/<name>
Write skill.md with:
- Clear frontmatter
- Concise instructions
- Usage examples
- Secret handling (if applicable)
Create helper scripts in scripts/ if needed
Test the skill by invoking it: /<skill-name>

Examples

Simple skill (no scripts):

~/.claude/skills/greet/skill.md

Skill with Python script:

~/.claude/skills/image-gen/
  skill.md
  scripts/
    generate.py

Skill with API key:

## API Key

**Do not try to read secrets from files.** If missing, ask user to:

1. Set `OPENAI_API_KEY` environment variable
2. Restart Claude Code

Instructions

When creating a skill:

Confirm the skill name and purpose with the user
Create ~/.claude/skills/<name>/skill.md
Add helper scripts if needed
Inform user the skill is ready to use with /<name>

Créateur de compétences Claude Code

Recommandé pour