Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

module-subpages

/module-subpages

Pomaga pisać podstrony poszczególnych typów w hierarchicznej dokumentacji modułu, w tym zagnieżdżanie poddomen i stronę indeksu poddomeny.

Autor
zio ↗
Repozytorium
zio-skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
27.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Pomaga pisać podstrony poszczególnych typów w hierarchicznej dokumentacji modułu, w tym zagnieżdżanie poddomen i stronę indeksu poddomeny.

Oryginalny opis (EN)

How to write the per-type subpages of a hierarchical module reference — the per-type loop, sub-domain nesting, and the sub-domain index page. Use when a module's design plan chose the hierarchical layout (core-family or multi-domain shapes); a flat module page has no subpages.

Jak działa

  1. The per-type loop
  2. Sub-domain nesting
  3. Prose written by hand
Sekcje z nagłówków SKILL.md, w oryginale · 60 linii, 476 słów
Podgląd SKILL.md
---
name: module-subpages
description: How to write the per-type subpages of a hierarchical module reference — the per-type loop, sub-domain nesting, and the sub-domain index page. Use when a module's design plan chose the hierarchical layout (core-family or multi-domain shapes); a flat module page has no subpages.
---

# Module Reference Subpages

A hierarchical module reference is an index page plus one subpage per type. The index carries the
narrative; the subpages carry the API. Skip everything here for a flat layout (`single-core` or `dsl`) —
a flat page documents its types inline and has no subpages.

## The per-type loop

For EACH type in the plan's `typeGroups` — each group has a `label` and its `types`, each with a `kind`:

1. Delegate to the `researcher` subagent for that type's full public API, writing to
   `.flowrite/research/data-type-<type-kebab>.md`. One delegation per type, and read each file before
   drafting from it.
2. Delegate to the `drafter` subagent for the subpage. Tell it:
   - the research file path,
   - the page path `docs/reference/<module-kebab>/<type-kebab>.md`,
   - how this type relates to its siblings, from the module research's relationships,
   - its group `label`, and its `kind`.

**One delegation per type, both steps.** Give each type its own researcher call and its own drafter
call, even when two types look small enough to batch:
✅ two drafter delegations, one per subpage ❌ one delegation asking for "TWO per-type subpages"
Batching is where a subpage picks up its sibling's API: a module run handed the drafter `Lens`'s
research alongside `Iso`'s plan and produced a page naming four methods `Lens` does not have. Two types
is where batching looks safe; four is where it stops being.

**There is no design step for a subpage.** No plan exists for it, and none should be invented: the
drafter decides the sections from the structure template and the research it was given. Never reuse
another type's plan — a module run once handed the drafter `Lens`'s research alongside `Iso`'s plan and
produced a page naming four methods `Lens` does not have.

`kind` sets the depth: a `core` type gets a full page, a `supporting` type gets a minimal one. Fold a
homogeneous family of variants onto one page rather than writing near-identical pages.

## Sub-domain nesting

With two or more sub-domains, nest a directory per sub-domain:

```
docs/reference/<module-kebab>/index.md                       ← the module map
docs/reference/<module-kebab>/<sub-domain-kebab>/index.md    ← one per sub-domain
docs/reference/<module-kebab>/<sub-domain-kebab>/<type>.md   ← the types
```

Each sub-domain `index.md` follows the **"Sub-domain index page"** template in `module-ref-structure`:

1. Lead with the sub-domain's entry-point object, if it has one, documented comprehensively and
   organized by behaviour or task — a subsection per capability. It gets no page of its own, so this is
   its only coverage.
2. A problem-first end-to-end `## Usage` recipe.
3. The type roster, grouped by domain concern.

## Prose written by hand

You write the sub-domain index pages yourself with the `write` tool rather than delegating them, so no
role's instructions supply the writing-style rules — apply them from your own `writing-style` skill.
The rule that matters most here: **link each sibling type's first prose mention to its subpage**, as
``[`TracerProvider`](./tracer-provider.md)``. Verify a page exists before linking to it.

Wersje

W bazie nie ma innych skilli o nazwie module-subpages.

Migawka bazy z 13.11.2026 · wersja paczki aab755ac73a3 (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

  • 85{setup-skill-name}
    Prawdopodobnie szablon instalacji modułu w projekcie, z nazwą i kodem modułu do uzupełnienia przed użyciem.
  • 95docs-module-ref
    Pisze dokumentację referencyjną modułu z wieloma powiązanymi typami danych, z opisem relacji i wzorców kompozycji.
  • 100frontend-architecture
    Definiuje Clean Architecture i wielokrotnego użytku struktury komponentów frontendu, porządkując strony, tabele, listy, karty elementów, podstrony i okna modalne w React, Vue lub Svelte.
  • 100design-an-interface
    Generuje kilka radykalnie różnych projektów interfejsu modułu za pomocą równoległych subagentów, przy projektowaniu API i porównywaniu kształtów modułów.
  • 100port-c-module
    Prowadzi przez przenoszenie modułu w C do Rusta, od pierwszych kroków migracji.

Uwagi i zgłoszenia

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