Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

clarify-docs

/clarify-docs

Poprawia istniejącą dokumentację, opisy PR i issue, opierając się na wymaganiach i źródle, z zachowaniem sensu i zapisem wyniku lokalnie.

Repozytorium
claude-toolbox ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.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
141
Skrypty
16
Komentarze HTML
1
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.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 sprawdzić przed instalacją
  • 16 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

Skrypty: evals/already-clear/test-files/prep.py, evals/clear-factual-error/test-files/prep.py, evals/code-non-trigger/test-files/prep.py, evals/contract-only-pr/test-files/snapshots/base/resolve.py, evals/contract-only-pr/test-files/snapshots/head/resolve.py, evals/dense-source/test-files/prep.py, evals/github-issue-bug/test-files/repository/replay.py, evals/issue-fix-non-trigger/test-files/timeout.py, eva

Co robi i kiedy

Poprawia istniejącą dokumentację, opisy PR i issue, opierając się na wymaganiach i źródle, z zachowaniem sensu i zapisem wyniku lokalnie.

Oryginalny opis (EN)

TRIGGER when: asked to clarify or improve existing documentation, PR drafts or issue descriptions, including URLs and pasted bodies. Saves results locally, grounded in requirements and source while preserving meaning. Not for requests to implement, fix or work on an issue, code, config, generic response brevity, or agent instructions. Explicit instruction or SKILL.md targets receive a $kk:implement suggestion without edits or invoking implementation.

Jak działa

  1. Inputs and boundaries
  2. Workflow
Sekcje z nagłówków SKILL.md, w oryginale · 71 linii, 567 słów
Podgląd SKILL.md
---
name: clarify-docs
description: |
  TRIGGER when: asked to clarify or improve existing documentation, PR drafts or
  issue descriptions, including URLs and pasted bodies. Saves results locally,
  grounded in requirements and source while preserving meaning. Not for requests
  to implement, fix or work on an issue, code, config, generic response brevity,
  or agent instructions. Explicit instruction or SKILL.md targets receive a
  $kk:implement suggestion without edits or invoking implementation.
---
<!-- codex: tool-name mapping applied. See .codex/scripts/session-start.sh -->

# Clarify Documentation, PR Drafts and Issue Descriptions

Improve an existing document so its intended reader can understand the underlying
work. Produce a local edit; success depends on comprehension and fidelity, with no
document-length target.

## Inputs and boundaries

Accept local documentation, PR or issue-description drafts, remote PR/issue URLs
or pasted bodies, plus audience, purpose, requirements and source references.
GitHub and Linear are examples, not required integrations. Examples:

- `$kk:clarify-docs docs/configuration.md for service owners; use src/config/`
- `$kk:clarify-docs docs/feat/wip/import/design.md for the implementing developer`
- `$kk:clarify-docs pr-draft.md for repository reviewers; use the actual PR base/head`
- `$kk:clarify-docs <PR URL>; save the revised body to docs/feat/wip/import/pr-draft.md`
- `$kk:clarify-docs issue-draft.md; preserve the reported reproduction details`
- `$kk:clarify-docs <issue URL>; save to docs/feat/wip/import/issue-draft.md`

A directory permits discovery and selection, not a bulk rewrite. If selection is
consequentially ambiguous, ask which artifact to edit. Related requirements and
code may be read as evidence; only selected documentation may be changed.

Edit an explicitly selected local draft in place. A capture of pasted/remote input
is not automatically that draft. For remote or pasted input, use the caller's
destination or name a local draft under the clearly established current feature
directory. If neither is clear, ask before writing. Check for an existing file:
overwrite only the selected draft, never unrelated content; otherwise choose an
unused name within that feature scope or clarify the destination. Obtain remote
bodies and relevant context through available read-only tools or supplied text
during the shared procedure's source-reading phase. Reading grants no publishing
authority.

Issue tracker titles and types are read-only context: preserve a supplied title
when included in a local draft and propose no replacement title. Description
headings remain editable. Title editing requires a separately scoped request.

Code, config, agent instructions (including `AGENTS.md` and `CLAUDE.md`), skill
instructions are outside this entry point's scope. An
explicit instruction-editing request receives an explanation of this boundary and
a suggestion to use `$kk:implement`; do not invoke it or edit the target. Ordinary
code requests and generic requests for shorter answers do not activate this skill.
Route by the requested action: implementing, fixing or working on an issue belongs
to `$kk:implement`, not description editing. A URL alone establishes no editorial
intent; clarify consequential ambiguity before selecting a task.

## Workflow

**Mandatory order — instructions before action.** Follow this flow strictly in
sequence. Load this file and the entire shared procedure before content-level
target/source reads, editing or verification. Only filenames and request keywords
may be used for early scope selection.

1. Load [shared-document-clarity.md](shared-document-clarity.md) in full.
2. Resolve the selected artifacts, reader, purpose and destination from the request
   and repository instructions. Reuse known answers; investigate accessible context
   in the shared procedure before asking about consequential gaps.
3. Apply the shared procedure in order: understand the relevant work, establish
   protected meaning, edit the full reading path for the reader, then verify
   reader tasks and consolidation with its checklist before checking fidelity separately.
4. Report changed paths and material unresolved gaps briefly. If no edit was needed,
   say so. Produce no additional summary or claim-ledger file.

The shared procedure performs no profile detection and invokes no consumer skill.
Verification is an in-session check; the caller retains responsibility for normal
document review. This entry point adds no independent runtime review gate and makes
no external writes, publication, deployment or implementation changes.
PR/issue updates, comments and messages remain separate actions outside this workflow.
Pliki w paczce (141)
  • SKILL.md 5 KB
  • shared-document-clarity.md 11 KB
  • evals/README.md 9 KB
  • evals/agent-instruction-target/eval.json 1 KB
  • evals/agent-instruction-target/test-files/AGENTS.md 1 KB
  • evals/already-clear/eval.json 1 KB
  • evals/already-clear/oracle/expected.json 1 KB
  • evals/already-clear/test-files/guide.md 1 KB
  • evals/already-clear/test-files/prep.py 1 KB
  • evals/already-clear/test-files/requirements.md 1 KB
  • evals/brevity-non-trigger/eval.json 1 KB
  • evals/brevity-non-trigger/test-files/notes.md 1 KB
  • evals/clear-factual-error/eval.json 1 KB
  • evals/clear-factual-error/oracle/expected.json 1 KB
  • evals/clear-factual-error/test-files/guide.md 1 KB
  • evals/clear-factual-error/test-files/prep.py 1 KB
  • evals/clear-factual-error/test-files/requirements.md 1 KB
  • evals/code-non-trigger/eval.json 1 KB
  • evals/code-non-trigger/test-files/prep.py 1 KB
  • evals/contract-only-pr/eval.json 2 KB
  • evals/contract-only-pr/oracle/expected.json 1 KB
  • evals/contract-only-pr/test-files/context.md 1 KB
  • evals/contract-only-pr/test-files/pr-draft.md 1 KB
  • evals/contract-only-pr/test-files/snapshots/base/contract.json 1 KB
  • evals/contract-only-pr/test-files/snapshots/base/requirements.md 1 KB
  • evals/contract-only-pr/test-files/snapshots/base/resolve.py 1 KB
  • evals/contract-only-pr/test-files/snapshots/head/contract.json 1 KB
  • evals/contract-only-pr/test-files/snapshots/head/requirements.md 1 KB
  • evals/contract-only-pr/test-files/snapshots/head/resolve.py 1 KB
  • evals/cross-file-preservation/eval.json 2 KB
  • evals/cross-file-preservation/oracle/expected.json 1 KB
  • evals/cross-file-preservation/test-files/design.md 1 KB
  • evals/cross-file-preservation/test-files/entry.md 1 KB
  • evals/cross-file-preservation/test-files/requirements.md 1 KB
  • evals/cross-file-preservation/test-files/tasks.md 1 KB
  • evals/dense-source/eval.json 2 KB
  • evals/dense-source/oracle/expected.json 1 KB
  • evals/dense-source/test-files/guide.md 1 KB
  • evals/dense-source/test-files/prep.py 1 KB
  • evals/dense-source/test-files/requirements.md 1 KB
  • evals/destination-visibility/eval.json 3 KB
  • evals/destination-visibility/oracle/expected.json 1 KB
  • evals/destination-visibility/test-files/context.md 1 KB
  • evals/destination-visibility/test-files/pr-draft.md 1 KB
  • evals/destination-visibility/test-files/public-format.md 1 KB
  • evals/destination-visibility/test-files/shared-notes.md 1 KB
  • evals/destination-visibility/test-files/source-notes.md 1 KB
  • evals/destination-visibility/test-files/snapshots/base/contract.json 1 KB
  • evals/destination-visibility/test-files/snapshots/base/requirements.md 1 KB
  • evals/destination-visibility/test-files/snapshots/base/restricted.md 1 KB
  • evals/destination-visibility/test-files/snapshots/base/docs/tasks.md 1 KB
  • evals/destination-visibility/test-files/snapshots/head/contract.json 1 KB
  • evals/destination-visibility/test-files/snapshots/head/requirements.md 1 KB
  • evals/destination-visibility/test-files/snapshots/head/restricted.md 1 KB
  • evals/destination-visibility/test-files/snapshots/head/docs/tasks.md 1 KB
  • evals/github-issue-bug/eval.json 3 KB
  • evals/github-issue-bug/oracle/expected.json 2 KB
  • evals/github-issue-bug/test-files/context.md 1 KB
  • evals/github-issue-bug/test-files/remote-body.md 1 KB
  • evals/github-issue-bug/test-files/docs/feat/wip/replay/issue-draft.md 1 KB
  • evals/github-issue-bug/test-files/repository/replay.py 1 KB
  • evals/github-issue-bug/test-files/repository/requirements.md 1 KB
  • evals/github-issue-bug/test-files/repository/restricted.md 1 KB
  • evals/issue-destination-visibility/eval.json 3 KB
  • evals/issue-destination-visibility/oracle/expected.json 1 KB
  • evals/issue-destination-visibility/test-files/context.md 1 KB
  • evals/issue-destination-visibility/test-files/issue-draft.md 1 KB
  • evals/issue-destination-visibility/test-files/public-format.md 1 KB
  • evals/issue-destination-visibility/test-files/shared-requirements.md 1 KB
  • evals/issue-destination-visibility/test-files/shared-tasks.md 1 KB
  • evals/issue-destination-visibility/test-files/source-notes.md 1 KB
  • evals/issue-destination-visibility/test-files/repository/internal-plan.md 1 KB
  • evals/issue-destination-visibility/test-files/repository/restricted.md 1 KB
  • evals/issue-fix-non-trigger/eval.json 1 KB
  • evals/issue-fix-non-trigger/oracle/expected.json 1 KB
  • evals/issue-fix-non-trigger/test-files/issue.md 1 KB
  • evals/issue-fix-non-trigger/test-files/timeout.py 1 KB
  • evals/issue-implement-non-trigger/eval.json 2 KB
  • evals/issue-implement-non-trigger/oracle/expected.json 1 KB
  • evals/issue-implement-non-trigger/test-files/greeting.py 1 KB
  • evals/issue-implement-non-trigger/test-files/issue.md 1 KB
  • evals/issue-local-draft/eval.json 2 KB
  • evals/issue-local-draft/oracle/expected.json 2 KB
  • evals/issue-local-draft/test-files/export.py 1 KB
  • evals/issue-local-draft/test-files/issue-draft.md 1 KB
  • evals/issue-local-draft/test-files/requirements.md 1 KB
  • evals/issue-pasted-missing-destination/eval.json 2 KB
  • evals/issue-pasted-missing-destination/oracle/expected.json 1 KB
  • evals/issue-pasted-missing-destination/test-files/context.md 1 KB
  • evals/issue-pasted-missing-destination/test-files/pasted-body.md 1 KB
  • evals/issue-pasted-missing-destination/test-files/requirements.md 1 KB
  • evals/issue-unavailable-body/eval.json 2 KB
  • evals/issue-unavailable-body/oracle/expected.json 1 KB
  • evals/issue-unavailable-body/test-files/context.md 1 KB
  • evals/issue-unavailable-body/test-files/notes.md 1 KB
  • evals/issue-unavailable-source/eval.json 2 KB
  • evals/issue-unavailable-source/oracle/expected.json 2 KB
  • evals/issue-unavailable-source/test-files/context.md 1 KB
  • evals/issue-unavailable-source/test-files/notes.md 1 KB
  • evals/issue-unavailable-source/test-files/pasted-body.md 1 KB
  • evals/linear-issue-feature/eval.json 2 KB
  • evals/linear-issue-feature/oracle/expected.json 2 KB
  • evals/linear-issue-feature/test-files/context.md 1 KB
  • evals/linear-issue-feature/test-files/discussion.md 1 KB
  • evals/linear-issue-feature/test-files/export.py 1 KB
  • evals/linear-issue-feature/test-files/remote-body.md 1 KB
  • evals/linear-issue-feature/test-files/requirements.md 1 KB
  • evals/long-integration-guide/eval.json 3 KB
  • evals/long-integration-guide/oracle/expected.json 9 KB
  • evals/long-integration-guide/test-files/backend.py 5 KB
  • evals/long-integration-guide/test-files/guide.md 14 KB
  • evals/long-integration-guide/test-files/requirements.md 4 KB
  • evals/missing-context/eval.json 1 KB
  • evals/missing-context/oracle/expected.json 1 KB
  • evals/missing-context/test-files/guide.md 1 KB
  • evals/missing-context/test-files/requirements.md 1 KB
  • evals/pr-missing-context/eval.json 1 KB
  • evals/pr-missing-context/test-files/context.md 1 KB
  • evals/pr-missing-context/test-files/pasted-body.md 1 KB
  • evals/pr-unavailable-source/eval.json 1 KB
  • evals/pr-unavailable-source/oracle/expected.json 1 KB
  • evals/pr-unavailable-source/test-files/context.md 1 KB
  • evals/pr-unavailable-source/test-files/remote-body.md 1 KB
  • evals/runtime-pr/eval.json 2 KB
  • evals/runtime-pr/oracle/expected.json 1 KB
  • evals/runtime-pr/test-files/context.md 1 KB
  • evals/runtime-pr/test-files/remote-body.md 1 KB
  • evals/runtime-pr/test-files/docs/feat/wip/prep/pr-draft.md 1 KB
  • evals/runtime-pr/test-files/snapshots/base/contract.json 1 KB
  • evals/runtime-pr/test-files/snapshots/base/requirements.md 1 KB
  • evals/runtime-pr/test-files/snapshots/base/resolve.py 1 KB
  • evals/runtime-pr/test-files/snapshots/head/contract.json 1 KB
  • evals/runtime-pr/test-files/snapshots/head/requirements.md 1 KB
  • evals/runtime-pr/test-files/snapshots/head/resolve.py 1 KB
  • evals/runtime-pr/test-files/snapshots/head/test_resolve.py 1 KB
  • evals/skill-instruction-target/eval.json 1 KB
  • evals/source-disagreement/eval.json 1 KB
  • evals/source-disagreement/oracle/expected.json 1 KB
  • evals/source-disagreement/test-files/guide.md 1 KB
  • evals/source-disagreement/test-files/prep.py 1 KB
  • evals/source-disagreement/test-files/requirements.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · serpro69/claude-toolbox100Apache-2.0
serpro69/claude-toolbox100Apache-2.0

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

  • 84implement
    Implementuje zgłoszenie z GitHuba zgodnie z planem i tworzy pull request z gotową zmianą.
  • 100implement-issue
    Realizuje zgłoszenie GitHub metodą tests-first: pisze testy na podstawie kryteriów akceptacji, otwiera roboczy PR i implementuje zmiany w commitach, aż testy przejdą.
  • 90start-issue
    Rozpoczyna pracę nad issue z GitHuba: pobiera kontekst, pisze testy, wdraża zmianę i przygotowuje pull request.
  • 90manager
    Prowadzi zgłoszenie z GitHuba przez bramki ról: plan, sprawdzenie specyfikacji, jedno pytanie, wdrożenie, przegląd, PR i zamknięcie.
  • 100document-implement
    Wykonuje kolejny oczekujący krok z docs/documentation-plan/plan.md i pisze dokumentację domenową dla RAG, po komendzie /document-implement.
  • 100s08-03-spec-clarify
    Szuka w specyfikacji niejasności i braków, przedstawia użytkownikowi wybory do rozstrzygnięcia i zapisuje decyzje w spec.md.

Uwagi i zgłoszenia

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