code-documentation
Writing effective code documentation - API docs, README files, inline comments, and technical guides. Use for documenting codebases, APIs, or writing developer guides.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Writing effective code documentation - API docs, README files, inline comments, and technical guides. Use for documenting codebases, APIs, or writing developer guides.
How to use
Zainstaluj umiejętność w swoim agencie AI, dodając ją do konfiguracji skills. Upewnij się, że masz dostęp do repozytorium projektu lub kodu, który chcesz dokumentować.
Przygotuj informacje o projekcie: nazwę, krótki opis funkcjonalności, instrukcje instalacji (np. npm install) i przykłady użycia kodu, które chcesz uwzględnić w dokumentacji.
Użyj umiejętności do wygenerowania strukturalnego pliku README. Skill automatycznie utworzy sekcje takie jak Quick Start, Installation, Usage i API Reference na podstawie szablonu.
Dla dokumentacji API wygeneruj komentarze JSDoc/TSDoc do swoich funkcji. Podaj parametry, typy zwracane, możliwe błędy i przykłady użycia – skill sformatuje je zgodnie ze standardem.
Jeśli dokumentujesz API REST, użyj generatora do utworzenia specyfikacji OpenAPI/Swagger. Skill pomoże zorganizować endpointy, parametry i odpowiedzi w czytelnym formacie.
Przejrzyj wygenerowaną dokumentację, dostosuj opisy do swoich potrzeb i umieść pliki w repozytorium projektu.