Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

docs-writer

/docs-writer

Pomaga pisać, recenzować i edytować pliki w katalogu /docs oraz inne pliki .md w repozytorium, z zachowaniem tonu i rejestru ArkEnv.

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

Brak sygnałów. Repozytorium zmienione 23.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 sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (3). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Pomaga pisać, recenzować i edytować pliki w katalogu /docs oraz inne pliki .md w repozytorium, z zachowaniem tonu i rejestru ArkEnv.

Wyzwalacze z opisu

fix the voice
Oryginalny opis (EN)

Always use this skill when the task involves writing, reviewing, or editing files in the `/docs` directory or any `.md` files in the repository. For ArkEnv tone, register, or "fix the voice", also load the-voice.

Jak działa

  1. Phase 1: Documentation standards
  2. Phase 2: Preparation
  3. Phase 3: Execution
  4. Phase 4: Verification and finalization
  5. Credits
Sekcje z nagłówków SKILL.md, w oryginale · 201 linii, 1 287 słów
Podgląd SKILL.md
---
name: docs-writer
description:
  Always use this skill when the task involves writing, reviewing, or editing
  files in the `/docs` directory or any `.md` files in the repository. For
  ArkEnv tone, register, or "fix the voice", also load the-voice.
metadata:
  author: Yam Borodetsky
  original_author: Google
  origin: github.com/google-gemini/gemini-cli
  internal: true
---

# `docs-writer` skill instructions

For ArkEnv **register** (what/why/how, Turbo-shaped docs, house terms),
follow **the-voice**. This skill is mechanics: links, wrapping,
structure. Ignore Gemini CLI naming. When tone and this file conflict,
the-voice wins. Site notes use fumadocs `<Callout>`, not GitHub alerts.

As an expert technical writer and editor, you produce accurate, clear, and
consistent documentation. When asked to write, edit, or review
documentation, you must ensure the content strictly adheres to the
provided documentation standards and accurately reflects the current
codebase. Adhere to the contribution process in `CONTRIBUTING.md` and the
following project standards.

## Phase 1: Documentation standards

Adhering to these principles and standards when writing, editing, and reviewing.

### Voice and tone
Adopt a tone that balances professionalism with a helpful, conversational
approach.

- **Perspective and tense:** Address the reader as "you." Use active voice and
  present tense (e.g., "The API returns...").
- **Tone:** Professional, friendly, and direct.
- **Clarity:** Use simple vocabulary. Avoid jargon, slang, and marketing hype.
- **Global Audience:** Write in standard US English. Avoid idioms and cultural
  references.
- **Requirements:** Be clear about requirements ("must") vs. recommendations
  ("we recommend"). Avoid "should."
- **Word Choice:** Avoid "please" and anthropomorphism (e.g., "the server
  thinks"). Use contractions (don't, it's).

### Language and grammar
Write precisely to ensure your instructions are unambiguous.

- **Abbreviations:** Avoid Latin abbreviations; use "for example" (not "e.g.")
  and "that is" (not "i.e.").
- **Punctuation:** Use the serial comma. Place periods and commas inside
  quotation marks.
- **Dates:** Use unambiguous formats (e.g., "January 22, 2026").
- **Conciseness:** Use "lets you" instead of "allows you to." Use precise,
  specific verbs.
- **Examples:** Use meaningful names in examples; avoid placeholders like
  "foo" or "bar."
- **Quota and limit terminology:** For any content involving resource capacity
  or using the word "quota" or "limit", strictly adhere to the guidelines in
  the `quota-limit-style-guide.md` resource file. Generally, Use "quota" for
  the administrative bucket and "limit" for the numerical ceiling.

### Formatting and syntax
Apply consistent formatting to make documentation visually organized and
accessible.

- **Overview paragraphs:** Every heading must be followed by at least one
  introductory overview paragraph before any lists or sub-headings.
- **Text wrap:** Wrap text at 80 characters (except long links or tables).
- **Casing:** Use sentence case for headings, titles, and bolded text.
- **Naming:** Always refer to the project as `ArkEnv` (never
  `the ArkEnv`).
- **Lists:** Use numbered lists for sequential steps and bulleted lists
  otherwise. Keep list items parallel in structure.
- **UI and code:** Use **bold** for UI elements and `code font` for filenames,
  snippets, commands, and API elements. Focus on the task when discussing
  interaction.
- **Accessibility:** Use semantic HTML elements correctly (headings, lists, 
  tables).
- **Media:** Use lowercase hyphenated filenames. Provide descriptive alt text
  for all images.
- **Details section:** Use the `<details>` tag to create a collapsible section.
  This is useful for supplementary or data-heavy information that isn't critical
  to the main flow.

  Example:

  <details>
  <summary>Title</summary>

  - First entry
  - Second entry

  </details>

- **Callouts**: Use GitHub-flavored markdown alerts to highlight important
  information. To ensure the formatting is preserved by `npm run format`, place
  an empty line, then a prettier ignore comment directly before the callout
  block. Use `<!-- prettier-ignore -->` for standard Markdown files (`.md`) and
  `{/* prettier-ignore */}` for MDX files (`.mdx`). The callout type (`[!TYPE]`)
  should be on the first line, followed by a newline, and then the content, with
  each subsequent line of content starting with `>`. Available types are `NOTE`,
  `TIP`, `IMPORTANT`, `WARNING`, and `CAUTION`.

  Example (.md):

<!-- prettier-ignore -->
> [!NOTE]
> This is an example of a multi-line note that will be preserved
> by Prettier.

  Example (.mdx):

{/* prettier-ignore */}
> [!NOTE]
> This is an example of a multi-line note that will be preserved
> by Prettier.

### Links
- **Accessibility:** Use descriptive anchor text; avoid "click here." Ensure the
  link makes sense out of context, such as when being read by a screen reader.
- **Use relative links in docs:** Use relative links in documentation (`/docs/`)
  to ensure portability. Use paths relative to the current file's directory
  (for example, `../tools/` from `docs/cli/`). Do not include the `/docs/`
  section of a path, but do verify that the resulting relative link exists. This
  does not apply to meta files such as README.MD and CONTRIBUTING.MD.
- **When changing headings, check for deep links:** If a user is changing a
  heading, check for deep links to that heading in other pages and update
  accordingly.

### Structure
- **BLUF:** Start with an introduction explaining what to expect.
- **Experimental features:** If a feature is clearly noted as experimental,
  add the following note immediately after the introductory paragraph:

<!-- prettier-ignore -->
> [!NOTE]
> This is an experimental feature currently under active development.
(Note: Use `{/* prettier-ignore */}` if editing an `.mdx` file.)

- **Headings:** Use hierarchical headings to support the user journey.
- **Procedures:**
  - Introduce lists of steps with a complete sentence.
  - Start each step with an imperative verb.
  - Number sequential steps; use bullets for non-sequential lists.
  - Put conditions before instructions (e.g., "On the Settings page, click...").
  - Provide clear context for where the action takes place.
  - Indicate optional steps clearly (e.g., "Optional: ...").
- **Elements:** Use bullet lists, tables, details, and callouts.
- **Avoid using a table of contents:** If a table of contents is present, remove
  it.
- **Next steps:** Conclude with a "Next steps" section if applicable.

## Phase 2: Preparation
Before modifying any documentation, thoroughly investigate the request and the
surrounding context.

1.  **Clarify:** Understand the core request. Differentiate between writing new
    content and editing existing content. If the request is ambiguous (e.g.,
    "fix the docs"), ask for clarification.
2.  **Investigate:** Examine relevant code (primarily in `packages/`) for
    accuracy.
3.  **Audit:** Read the latest versions of relevant files in `docs/`.
4.  **Connect:** Identify all referencing pages if changing behavior. Check if
    `docs/sidebar.json` needs updates.
5.  **Plan:** Create a step-by-step plan before making changes.
6.  **Audit Docset:** If asked to audit the documentation, follow the procedural
    guide in [docs-auditing.md](./references/docs-auditing.md).

## Phase 3: Execution
Implement your plan by either updating existing files or creating new ones
using the appropriate file system tools. Use `replace` for small edits and
`write_file` for new files or large rewrites.

### Editing existing documentation
Follow these additional steps when asked to review or update existing
documentation.

- **Gaps:** Identify areas where the documentation is incomplete or no longer
  reflects existing code.
- **Structure:** Apply "Structure (New Docs)" rules (BLUF, headings, etc.) when
  adding new sections to existing pages.
- **Headers**: If you change a header, you must check for links that lead to
  that header and update them.
- **Tone:** Ensure the tone is active and engaging. Use "you" and contractions.
- **Clarity:** Correct awkward wording, spelling, and grammar. Rephrase
  sentences to make them easier for users to understand.
- **Consistency:** Check for consistent terminology and style across all edited
  documents.

## Phase 4: Verification and finalization
Perform a final quality check to ensure that all changes are correctly
formatted and that all links are functional.

1.  **Accuracy:** Ensure content accurately reflects the implementation and
  technical behavior.
2.  **Self-review:** Re-read changes for formatting, correctness, and flow.
3.  **Link check:** Verify all new and existing links leading to or from
    modified pages. If you changed a header, ensure that any links that lead to
    it are updated.
4.  **Format:** If `npm run format` fails, it may be necessary to run `npm
    install` first to ensure all formatting dependencies are available. Once all
    changes are complete, ask to execute `npm run format` to ensure consistent
    formatting across the project. If the user confirms, execute the command.

## Credits

This skill was originally created for the [Gemini CLI](https://github.com/google-gemini/gemini-cli)
project and sourced from
[github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli)
(`.gemini/skills/docs-writer`).
Pliki w paczce (3)
  • SKILL.md 9 KB
  • quota-limit-style-guide.md 2 KB
  • references/docs-auditing.md 10 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · yamcodes/arkenv100MIT
google-gemini/gemini-cli100Apache-2.0
kensaurus/cursor-kenji100MIT
thisiskurubaran/DevSecOps100MIT
tech-leads-club/agent-skills90MIT
xiongxianzhu/xskills90MIT
zjunlp/skills90MIT

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

  • 100arkenv
    Odpowiada na pytania o ArkEnv i pomaga wdrożyć walidację zmiennych środowiskowych ze schematami ArkType lub Standard Schema w Next.js, Nuxt, Vite, Bun i Node.js.
  • 100writing-docs
    Podpowiada, jak pisać i edytować dokumentację Remotion, w tym strony MDX w pakiecie docs.
  • 100writing-docs
    Pomaga pisać i edytować dokumentację Remotion: dodawanie stron, edycja plików MDX w packages/docs i tworzenie treści.
  • 100writing-docs
    Pomaga pisać i edytować dokumentację Remotion: dodawanie stron, edycja plików MDX w packages/docs i tworzenie treści.
  • 100writing-docs
    Pomaga pisać i edytować dokumentację Remotion: dodawanie stron, edycja plików MDX w packages/docs i tworzenie treści.
  • 100sync-main
    Publikuje od razu zmiany dokumentacji na gałęzi main, przenosząc je cherry-pickiem z dev i scalając main z powrotem do dev.

Uwagi i zgłoszenia

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