Notre avis
Cette compétence définit la structure pour créer des fichiers SKILL.md décrivant les compétences des agents IA, incluant le frontmatter, les sections principales et les ressources regroupées.
Points forts
- Fournit un format standardisé pour la documentation des compétences.
- Inclut des champs obligatoires et optionnels dans le frontmatter.
- Permet de regrouper des ressources supplémentaires comme des scripts et des références.
- Suit les meilleures pratiques comme placer les déclencheurs en avant.
Limites
- Ne couvre pas la logique d'implémentation de la compétence elle-même.
- Se limite à de la documentation textuelle, pas de code exécutable.
- Peut nécessiter une adaptation pour certains plateformes d'agents IA.
Quand vous devez créer une définition de compétence réutilisable et bien documentée pour un agent IA selon le standard agentskills.io.
Quand vous cherchez une implémentation prête à l'emploi plutôt qu'un modèle de documentation.
Analyse de sécurité
SûrThis SKILL.md is purely a documentation specification with no executable code, network operations, or system modifications. It poses no security risk.
Aucun point d'attention détecté
Exemples
Create a SKILL.md file for a skill that reviews Python code for style and security issues. Include frontmatter with description, triggers like 'review this code', and a setup section requiring pylint and bandit.Generate a SKILL.md template following the agentskills.io standard with required frontmatter (name, description), a setup section, and an examples section. Use 'example-skill' as the name.Write a SKILL.md for a skill that analyzes CSV data and generates summary statistics. Include compatibility for claude-code and codex, and reference a scripts/analyze.py file.SKILL.md Format Specification
This document describes the SKILL.md format used by n-skills, which follows the agentskills.io standard.
Required Frontmatter
---
name: skill-name # lowercase, hyphens only
description: | # Include trigger phrases
What it does.
When to use it.
Requirements.
---
Optional Frontmatter
version: 1.0.0
license: Apache-2.0
author:
name: Your Name
github: username
keywords: [tag1, tag2]
compatibility:
claude-code: true
codex: true
Body Structure
# Skill Name
## Description (optional)
Expand on the frontmatter description if needed.
## Setup
Any prerequisites or configuration needed.
## Commands/Usage
How to use the skill.
## Examples
Concrete usage examples.
## Advanced
Link to references/ for detailed documentation.
Bundled Resources
Skills can include additional resources:
skill-name/
├── SKILL.md # Required
├── references/ # Extended documentation
│ └── advanced.md
├── scripts/ # Executable code
│ └── helper.py
└── assets/ # Templates, files for output
└── template.json
Best Practices
- Keep SKILL.md concise - Under 500 lines
- Front-load triggers - Put trigger phrases in the description
- Use references/ - Move detailed docs out of SKILL.md
- Provide examples - Concrete, copy-pasteable examples
- Document requirements - API keys, dependencies, etc.
Generateur de Documentation API
Documentation
Genere automatiquement de la documentation API OpenAPI/Swagger.
Rédacteur Technique
Documentation
Rédige de la documentation technique claire selon les meilleurs style guides.
Architecte de Documentation Technique
Documentation
Analyse un code source existant pour produire une documentation technique complète (10 à 100+ pages), inclant des vues d'architecture, des décisions de conception et des guides de dépannage. Idéal pour la documentation système, les guides d'architecture ou les plongées techniques.