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

draft-openspec-docs

/draft-openspec-docs

Prowadzi wspólne redagowanie stron dokumentacji OpenSpec: buduje roboczy plan w stronie, iteruje z użytkownikiem, pisze po jednej sekcji na zatwierdzony krok i po sobie sprząta.

Repozytorium
OpenSpec ↗
Licencja
MIT
Ostatnia zmiana repozytorium
24.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 24.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

Prowadzi wspólne redagowanie stron dokumentacji OpenSpec: buduje roboczy plan w stronie, iteruje z użytkownikiem, pisze po jednej sekcji na zatwierdzony krok i po sobie sprząta.

Argumenty

/draft-openspec-docs target page
Oryginalny opis (EN)

Collaborative page-drafting mode for the OpenSpec docs. Builds a scratch plan inside the target page (purpose, structure, numbered draft steps), iterates on it with the user, then drafts one section per approved step and cleans up after itself. Use when a page needs a from-scratch rewrite or a new page is being shaped with the user in the loop.

Jak działa

  1. 1. Set up the scratch section
  2. 2. Iterate until the plan is approved
  3. 3. Add the draft plan, then draft step by step
  4. 4. Consolidation and cleanup
Sekcje z nagłówków SKILL.md, w oryginale · 42 linii, 475 słów
Podgląd SKILL.md
---
name: draft-openspec-docs
description: Collaborative page-drafting mode for the OpenSpec docs. Builds a scratch plan inside the target page (purpose, structure, numbered draft steps), iterates on it with the user, then drafts one section per approved step and cleans up after itself. Use when a page needs a from-scratch rewrite or a new page is being shaped with the user in the loop.
argument-hint: target page
---

# Draft OpenSpec docs (scratch-plan workflow)

You are shaping a docs page with the user in the loop. The page is planned and reviewed inside the page itself, then drafted one section at a time. Load `write-openspec-docs` (the style authority) and `no-ai-slop` before drafting anything.

## 1. Set up the scratch section

Strip the page to its title and `>` goal line, then add a working section below them:

```md
## Scratch: page plan (delete before publish)

### Purpose

### Structure
```

- **Purpose**: 3-5 dot points. Who the reader is and what they come to look up, what the page covers, what it links out to. Check `docs-lab/README.md` (the page's goal line) and `docs-lab/message-map.md` (the questions routed here) before writing it.
- **Structure**: a numbered list of the page's sections, one line each naming the section and the shape of its content (table, fence, tree, bullets).
- Say what the page will do, never what it won't. Plain words and short bullets; the user reads this in their editor.

## 2. Iterate until the plan is approved

- Plan edits are cheap; page edits aren't. Reshape the plan as many times as the user asks before drafting.
- Record every decision in the plan itself, not only in chat. Add a `### Notes` list for follow-ups that belong to other pages and product observations found along the way.
- The user may edit the file directly between turns; their edits are decisions, not drift to revert.
- Surface one open call at a time, with a recommendation.

## 3. Add the draft plan, then draft step by step

Once the structure holds, add a `### Draft plan` below the notes: one step per page section, each with an ID and a readable title (`**D1. Goal line and intro**`), ending with a consolidation step (cross-page updates) and a cleanup step. Then:

- Wait for the user to call a step ID. Draft exactly that step, into the page above the scratch block.
- Verify each fact against source before writing it; a cheap grep beats trust. Reference content shows the raw contract (templates, instructions, config) verbatim in fences, linked to the file on GitHub, rather than paraphrasing it.
- Keep sibling sections on a repeatable sub-structure so the page scans as one system.
- Mark the step `(done)` in the plan, report what landed, and name the next step.

## 4. Consolidation and cleanup

- **Consolidation**: update everything that points at the page. The README goal line (verbatim match with the page's `>` line), the message map, the sync config (`website/docs.sync.config.mjs`), and any cross-links found by grepping the tree. Run `node website/scripts/sync-docs.mjs` to validate.
- **Cleanup**: delete the scratch block, run the retrievability and glance tests from `write-openspec-docs` at desktop and narrow widths, and flip the page's message-map row to Answered if its prose landed.

Wersje

W bazie nie ma innych skilli o nazwie draft-openspec-docs.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

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

  • 100verify-openspec-docs
    Sprawdza fakty w dokumentacji użytkownika OpenSpec przez subagenta ze świeżym kontekstem, który ponownie uruchamia polecenia i porównuje twierdzenia ze źródłem; uruchamiany ręcznie.
  • 90openspec-plan
    Tworzy propozycje zmian OpenSpec, gdy użytkownik chce zaplanować funkcję lub rozpocząć nową zmianę.
  • 90write-openspec-docs
    Przełącza w tryb pisania dokumentacji OpenSpec: ładuje przewodnik stylu i tworzy lub poprawia strony w jego tonie, zorientowanym na działanie i łatwym do przeglądania.
  • 100openspec-init
    Konfiguruje OpenSpec w projekcie, gdy użytkownik prosi o inicjalizację lub chce dodać ten framework do repozytorium.
  • 100publish-openspec-wiki
    Mapuje stan zmian OpenSpec na strony wiki w docs/changes: tworzy strony aktywne, archiwizuje je i synchronizuje indeks oraz linki.
  • 100openspec-apply-change
    Wdraża zadania zmiany OpenSpec krok po kroku, także na komendy opsx apply i openspec implement.

Uwagi i zgłoszenia

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