Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Pisanie

diataxis-write-docs

/diataxis-write-docs

Pisze lub poprawia dokumentację projektu pod cel czytelnika według Diataxis: tutoriale, przewodniki how-to, referencję i wyjaśnienia.

Repozytorium
agentskills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
5
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Pisze lub poprawia dokumentację projektu pod cel czytelnika według Diataxis: tutoriale, przewodniki how-to, referencję i wyjaśnienia.

Oryginalny opis (EN)

Draft or revise project documentation for the reader's purpose using Diataxis. Use for writing tutorials, how-to guides, reference, or explanation; use diataxis-organize-docs for reorganizing an existing documentation collection.

Jak działa

  1. Choose the Reader Need
  2. Establish the Evidence
  3. Draft or Revise
  4. Place and Connect
  5. Verify and Deliver
Sekcje z nagłówków SKILL.md, w oryginale · 47 linii, 549 słów
Podgląd SKILL.md
---
name: diataxis-write-docs
description: Draft or revise project documentation for the reader's purpose using Diataxis. Use for writing tutorials, how-to guides, reference, or explanation; use diataxis-organize-docs for reorganizing an existing documentation collection.
allowed-tools:
  - Read
  - Write
---

# Diataxis Documentation Writing

Write documentation that answers a specific reader need and reflects the project's actual behavior. This workflow works independently of documentation reorganization.

## Choose the Reader Need

Identify the audience, assumed knowledge, desired outcome, and requested scope from the task and available material. Ask only when missing information would materially change the document.

Choose by purpose, not topic difficulty or the presence of code. Read the matching reference when drafting or revising that type; load additional references only for additional requested document types.

| Reader need | Document type | Writing guidance |
|-------------|---------------|------------------|
| Learn through a guided exercise | Tutorial | [Tutorial writing](references/tutorial.md) |
| Accomplish a particular task | How-to | [How-to writing](references/how-to.md) |
| Look up precise information | Reference | [Reference writing](references/reference.md) |
| Understand a concept or rationale | Explanation | [Explanation writing](references/explanation.md) |

For a mixed request, give each document a primary purpose and connect related material with links. Preserve the user's requested deliverables. A request to draft a page does not require reorganizing the collection first.

## Establish the Evidence

Inspect the relevant implementation, schemas, tests, existing documentation, and maintained project examples. Match external documentation to the project's version and dependencies. Use available project discovery tools when provided.

Resolve conflicting sources before making a definitive claim. Distinguish implemented behavior from proposals, intentions, and assumptions. Do not invent commands, API signatures, defaults, output, or design rationale to complete a draft. Narrow unsupported claims or ask for the missing information when it prevents a useful result.

## Draft or Revise

Apply the selected reference's writing guidance and anti-pattern checks. Make the title and opening identify the reader's goal, then include the detail needed to achieve it. Preserve useful existing content and project terminology during revision.

Keep instructions and generated documentation free of manually maintained totals and numbered section references. Use descriptive headings and named links. For actual ordered procedures, write every Markdown list marker as `1.` so the renderer maintains numbering. Preserve necessary numeric facts such as versions, limits, and measured values.

## Place and Connect

Honor the requested destination and existing documentation conventions. For a new documentation collection without an established layout, use `docs/tutorial/`, `docs/how-to/`, `docs/reference/`, and `docs/explanation/`, with `docs/README.md` as the navigation hub. Create only the directories the requested documents need.

Add relevant navigation links when maintaining the collection is within scope, and repair links affected by your edits. Link only to known destinations. When draft pages have no assigned paths, report suggested cross-references in the delivery note instead of adding speculative paths or cross-document anchors. Leave unrelated files and organization alone. Use `diataxis-organize-docs` when the user also requests collection restructuring.

## Verify and Deliver

- Check claims, identifiers, and example inputs against the evidence and declared version.
- Exercise executable examples when available tools, environment, and authorization permit. Otherwise inspect them against source and report that they were not run. Label conceptual snippets as illustrative when readers could mistake them for executable examples.
- Check affected links, anchors, and any applicable documentation build using available tools.
- Confirm the document satisfies the selected reader need without unnecessary digressions.

Deliver the requested documentation with a concise account of verification and any remaining evidence gaps. Do not present static inspection as execution or a proposed design as shipped behavior.
Pliki w paczce (5)
  • SKILL.md 4 KB
  • references/explanation.md 1 KB
  • references/how-to.md 1 KB
  • references/reference.md 1 KB
  • references/tutorial.md 1 KB

Wersje

W bazie nie ma innych skilli o nazwie diataxis-write-docs.

Migawka bazy z 13.11.2026 · wersja paczki ea2b6f941522 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100diataxis
    Tworzy dokumentację w czterech ćwiartkach Diataxis: tutoriale, przewodniki how-to, referencję i wyjaśnienia, a także audytuje mieszanie ćwiartek i klasyfikuje prośby o dokumentację.
  • 100diataxis
    Pomaga utrzymywać dokumentację według metody Diataxis: analizuje istniejące strony, klasyfikuje je na tutoriale, how-to, wyjaśnienia i referencje, wskazuje luki i restrukturyzuje.
  • 100make-docs
    Tworzy, edytuje i waliduje dokumentację techniczną według frameworka Diataxis: tutoriale, przewodniki how-to, dokumentację referencyjną i wyjaśnienia, a także audytuje strukturę istniejących dokumentów.
  • 100diataxis
    Strukturyzuje, klasyfikuje i pisze dokumentację według frameworka Diátaxis: README, przewodniki, tutoriale, how-to, referencje API i architekturę dokumentacji.
  • 100diataxis-docs
    Generuje pełny zestaw dokumentacji Diátaxis (tutoriale, how-to, referencja, wyjaśnienia) z bazy kodu, wyłącznie na jawne wywołanie /diataxis-docs.
  • 90writing-documentation-with-diataxis
    Tworzy lub ocenia dokumentację techniczną według Diataxis: samouczki, instrukcje, dokumentację referencyjną i wyjaśnienia.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.