Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

writing

/writing

Pisze lub przepisuje teksty projektów na GitHubie: README, dokumentację, notatki o wydaniu i odpowiedzi współtwórcom.

Repozytorium
githard ↗
Licencja
MIT
Ostatnia zmiana repozytorium
10.11.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
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.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 przepisuje teksty projektów na GitHubie: README, dokumentację, notatki o wydaniu i odpowiedzi współtwórcom.

Oryginalny opis (EN)

Use when writing or rewriting anything a person will read for a GitHub project, such as a README, docs, release notes, a changelog, an issue or PR description, a reply to a contributor, or a launch post, or when copy reads as stiff, corporate or AI-sounding.

Jak działa

  1. First, find the project's own style
  2. By kind of text
  3. Before you hand it over
Sekcje z nagłówków SKILL.md, w oryginale · 36 linii, 392 słów
Podgląd SKILL.md
---
name: writing
description: Use when writing or rewriting anything a person will read for a GitHub project, such as a README, docs, release notes, a changelog, an issue or PR description, a reply to a contributor, or a launch post, or when copy reads as stiff, corporate or AI-sounding.
---

# Writing

What people read decides whether they trust the project. This skill sets the voice for all of it.

## First, find the project's own style

Look before you write. A project's own guide always wins over GitHard's.

- `STYLE.md`, `STYLEGUIDE.md`, `docs/style*.md`, `.github/STYLE*.md`
- A style or writing section in `CONTRIBUTING.md`
- A prose linter's config: `.vale.ini`, `.markdownlint*`, `.textlintrc*`

If you find one, follow it, even where it disagrees with GitHard's voice. Then say in one line which guide you used, for example: "Written to `docs/style-guide.md`." If you find none, use GitHard's voice in `${CLAUDE_PLUGIN_ROOT}/knowledge/voice.md`. Read it before you write. Don't work from memory of it.

## By kind of text

| You're writing | What matters most |
|---|---|
| README | What it does for the reader, in the first two lines. An install line only if there's a release to install. |
| Docs and guides | Plain technical writing: what it is, the exact command, real output. Keep it conversational, but cut the selling. |
| Release notes | Only what merged and shipped in this release. Thank each outside contributor by `@handle` next to their change. |
| Issue or PR text | What's wrong or what changes, why, and "done when". A stranger should be able to pick it up. |
| Reply to a contributor | Their name, thanks for the specific thing, and the next step with a date or a condition. On a first PR from a fork, also tell them that CI waits until a maintainer has read the diff and approved it, and that if `main` moves on they should click **Update branch**, because you won't push to their branch. |
| Post or announcement | The reader's problem first, then what changed. Real output or a real figure beats any adjective. |

The reasons behind the release-notes and reply rules are in `knowledge/lessons.md` (Releases, Contributors).

## Before you hand it over

- Every claim is true of what's released today. Something planned is either left out or called planned.
- None of the banned words in `voice.md` appear, and nothing is built as "It's not just X, it's Y".
- Read it aloud in your head. Any sentence you wouldn't say to someone across a table gets rewritten.

`${CLAUDE_SKILL_DIR}/examples.md` has before and after pairs for each kind of text.
Pliki w paczce (2)
  • SKILL.md 3 KB
  • examples.md 3 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · getgithard/githard100MIT
molveau/skills100MIT
iliaal/ai-skills100MIT
madarauchiha-314/the-loop100MIT
se-uhd/ai-slop-skill100CC-BY-4.0
builtnotboosted/built-not-boosted-skills100MIT
williampsmith/marketing-skills100MIT
solidvibes/solid-vibes100MIT
nhthai173/plainspoken100MIT

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

Pobrania w ostatnich 30 dniach: 1 · ranking

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

Podobne skille

  • 96create-readme
    Generuje lub aktualizuje plik README.md albo CHANGELOG.md projektu.
  • 100readme-generator
    Tworzy lub przepisuje README.md projektów z myślą o czytelniku, z właściwą strukturą.
  • 100release-notes
    Pisze treści wydań dla Agent Sessions: README, notatki GitHub, Sparkle i stronę, a changelog zostaje pełną historią.
  • 85writing-task
    Pomaga pisać i poprawiać teksty czytane przez innych: opisy PR, notatki wydania, README, runbooki i komunikaty błędów.
  • 100project-docs
    Tworzy i aktualizuje dokumentację projektu, czyli changelog, dzienniki problemów, README i przewodnik dla klienta po zmianach w kodzie.
  • 90developer-release-communication
    Pisze rzeczowe notatki o wydaniu i instrukcje aktualizacji na podstawie różnic w wydaniu lub changelogu, bez treści promocyjnych.

Uwagi i zgłoszenia

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