Compétences llm-doc-writer
📦

llm-doc-writer

v1.0.0 Sûr

Créer une documentation LLM efficace en tokens

La documentation longue gaspille le contexte et ralentit le travail assisté par IA. Cette compétence transforme les connaissances projet en tableaux concis, puces, exemples et structure prête pour les agents.

Prend en charge: Claude Codex Code(CC)
🥈 81 Argent
1

Télécharger le ZIP de la compétence

2

Importer dans Claude

Accédez à Paramètres → Capacités → Skills → Importer une compétence

3

Activez et commencez à utiliser

Ressources lisibles par les agents

Utilisez ces liens lorsqu’un Agent IA, un crawler ou un script a besoin d’un contexte propre au lieu de lire toute la page.

Tester

Utilisation de « llm-doc-writer ». Un long README avec des instructions de configuration, des détails de stack et une prose d'architecture.

Résultat attendu:

Un README plus court avec un tableau de stack, des étapes de configuration numérotées, une référence des commandes et des puces d'architecture.

Utilisation de « llm-doc-writer ». Un projet sans guide d'agent pour Claude, Codex ou Claude Code.

Résultat attendu:

Un guide d'agent compact avec commandes, conventions, notes d'architecture et liens vers des fichiers détaillés.

Utilisation de « llm-doc-writer ». Une section API rédigée sous forme de paragraphes.

Résultat attendu:

Un résumé d'endpoints facile à parcourir avec les champs requis, les réponses attendues et des notes d'utilisation concises.

Audit de sécurité

Sûr
v7 • 6/28/2026

Static analysis reported external command, network, weak crypto, and reconnaissance patterns. Manual review found only markdown examples, inline code formatting, and ordinary documentation text, with no executable code or malicious intent.

2
Fichiers analysés
282
Lignes analysées
4
Review items
0
False positives ignored

Confirmed security concerns (4)

Faible
False Positive: Markdown Backticks Misread as Shell Execution
The external command detections are markdown fences or inline command examples. No Ruby code, shell execution logic, or user-controlled command invocation was found.
Both scanned files are markdown documentation. The flagged locations are code fences, inline command examples, or formatting markers, not executable Ruby backtick calls.
Faible
False Positive: Weak Crypto Pattern in Documentation Text
The weak cryptography detections match ordinary words and markdown references. No hashing, encryption, signing, or credential handling implementation was found.
Manual review found no cryptographic code. The lines contain documentation prose, headers, or references such as CLAUDE.md.
Faible
False Positive: Network Pattern in Architecture Example
The network detection appears in a prose example about REST APIs between services. No Python HTTP library import, endpoint, or outbound request code was found.
The line is inside a before-and-after documentation example. It describes architecture communication and does not perform network activity.
Faible
False Positive: Reconnaissance Pattern in Section Heading
The reconnaissance detection maps to an anti-patterns heading. No host, user, process, environment, or filesystem discovery command was found.
The flagged line is a markdown heading introducing writing anti-patterns. There is no executable system reconnaissance behavior in the file.

Score de qualité

55
Architecture
100
Maintenabilité
87
Contenu
70
Communauté
97
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez créer

Préparer le contexte d'agent

Créer un fichier CLAUDE.md concis ou un fichier d'instructions d'agent pour une base de code existante.

Compresser la documentation technique

Réécrire de longues sections de configuration, d'architecture ou d'API en documentation facile à parcourir.

Standardiser les README de projet

Construire des sections README cohérentes pour la stack, les commandes, les conventions et les références.

Essayez ces prompts

Rédiger une documentation d'agent de base
Crée un CLAUDE.md pour ce projet. Inclus la stack, les commandes, l'architecture, les conventions et des liens vers les fichiers de détails.
Réécrire une documentation verbeuse
Réécris cette documentation pour le contexte LLM. Utilise des tableaux, des puces et des exemples. Supprime le remplissage et les énoncés redondants.
Concevoir une division de documentation
Examine ce long document projet. Propose une documentation d'agent principale ainsi que des fichiers ciblés pour l'architecture, l'API et les workflows.
Auditer l'efficacité en tokens
Audite cette documentation pour son efficacité en tokens. Identifie les sections verbeuses, les commandes manquantes, les conventions peu claires et le contenu à diviser.

Bonnes pratiques

  • Fournir les faits sources avant de demander à la compétence de rédiger la documentation finale.
  • Garder le document d'agent principal court et ajouter des liens vers des fichiers de détails ciblés.
  • Vérifier les commandes générées et les notes d'architecture par rapport au dépôt réel.

Éviter

  • Ne pas utiliser la compétence pour inventer des détails projet manquants.
  • Ne pas conserver de longs paragraphes narratifs lorsqu'un tableau ou une liste est plus clair.
  • Ne pas placer chaque détail du projet dans un seul fichier de contexte d'agent.

Foire aux questions

Quel type de documentation cette compétence crée-t-elle ?
Elle crée une documentation concise pour les assistants IA, notamment des fichiers CLAUDE.md, des sections README et des instructions d'agent.
Peut-elle améliorer un README existant ?
Oui. Elle peut réécrire des sections verbeuses en tableaux, puces, exemples et supports de référence plus courts.
Exécute-t-elle les commandes du projet ?
Non. La compétence fournit des conseils de rédaction et des exemples. Elle n'exécute pas de commandes.
Est-elle utile pour Codex et Claude Code ?
Oui. Elle se concentre sur le contexte qui aide Claude, Codex et Claude Code à comprendre rapidement un dépôt.
Peut-elle vérifier l'exactitude technique ?
Non. Les utilisateurs doivent vérifier les commandes générées, les notes d'architecture et les détails d'API par rapport au projet.
Quand faut-il diviser les documents longs ?
Divisez les documents lorsque le fichier principal devient difficile à parcourir ou dépasse le contexte essentiel nécessaire à un assistant.

Détails du développeur

Auteur

Aceek

Licence

MIT

Version

v1.0.0

Réf

master

Structure de fichiers