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

fix

/fix

Uruchamia Vale, naprawia alerty na poziomie error i otwiera pull request dla każdego pliku, a ostrzeżenia i sugestie zostawia człowiekowi.

Repozytorium
agent-tools ↗
Licencja
MIT
Ostatnia zmiana repozytorium
02.09.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 02.09.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

Uruchamia Vale, naprawia alerty na poziomie error i otwiera pull request dla każdego pliku, a ostrzeżenia i sugestie zostawia człowiekowi.

Wyzwalacze z opisu

run valefix vale errorslint the docsfix the lintermake vale pass
Oryginalny opis (EN)

Run Vale, fix error-level alerts, and open a pull request per file. Use when the user says "run vale", "fix vale errors", "lint the docs", "fix the linter", or "make vale pass". Fixes errors only; leaves warnings and suggestions for a person.

Jak działa

  1. When to use this
  2. Prerequisites
  3. Scope
  4. Workflow
  5. Fixing guidance
  6. Do not
Sekcje z nagłówków SKILL.md, w oryginale · 122 linii, 680 słów
Podgląd SKILL.md
---
name: fix
description: Run Vale, fix error-level alerts, and open a pull request per file. Use when the user says "run vale", "fix vale errors", "lint the docs", "fix the linter", or "make vale pass". Fixes errors only; leaves warnings and suggestions for a person.
---

# Fix Vale alerts

## When to use this

The user asks to run Vale, fix its output, or make a lint job pass.

Do **not** trigger on prose edits alone. Editing a Markdown file is not a
request to lint the repository, and an unasked-for wave of style changes buried
in someone else's pull request is worse than the alerts.

## Prerequisites

Check these before doing any work, and stop with a plain message if one fails:

1. `vale --version` succeeds. If not, use the `setup` skill.
2. A config exists — `vale ls-config` resolves without error.
3. The working tree is clean, or the user has said it is fine to branch from
   what is there.
4. You know which files to process. Ask if the user did not say.

## Scope

**Fix `error` level only, unless asked otherwise.** Vale's three levels are a
decision the project already made:

| level | meaning | this skill |
|---|---|---|
| `error` | the project decided this must not ship | fix |
| `warning` | worth a look in review | leave, report the count |
| `suggestion` | advisory | leave, report the count |

Only `error` sets a non-zero exit code, so this is also what makes a lint job
pass. Say at the start which level you are working at.

## Workflow

**1. Get the alerts as data.**

```bash
vale --output=JSON <path> > /tmp/vale.json
```

The default `CLI` output is aligned for reading and is not stable to parse.

**2. Keep only the errors.**

```bash
jq 'map_values(map(select(.Severity == "error"))) | with_entries(select(.value | length > 0))' /tmp/vale.json
```

If nothing is left, say so and stop. Do not go looking for warnings to fix
instead.

**3. Take each file on its own branch.**

```bash
git switch -c vale-fix-<file-stem>-<short-hash>
```

**4. Apply the fix the rule intends.** Each alert carries `Check`, `Message`,
`Line`, `Span`, and often `Action.Name` with `Action.Params` — the replacement
the rule itself defines. Prefer that over inventing wording from the message.

Preserve the markup exactly: AsciiDoc attributes, MDX expressions, reference
links, code fences, existing line breaks. Never reflow a paragraph to fix one
word.

**5. Verify.**

```bash
vale --output=JSON <file>
```

The error count should be zero and nothing new should appear. If an alert
cannot be fixed without changing meaning, leave it and say so in the pull
request.

**6. Commit and open one pull request per file**, following the repository's
own commit conventions. A hundred prose edits in one branch cannot be reviewed;
ten small ones can. In the body, list each fix as `line — rule — what changed`,
and note anything left unfixed and why.

**7. Report.**

```
Vale fix summary
================
Files processed:      3
Pull requests:        2
Clean already:        1
Errors fixed:         8
Left for a human:     2 (meaning would change)
Untouched by design:  14 warnings, 51 suggestions
```

## Fixing guidance

Most rules name their own replacement; these are the shapes that need judgment:

- **Wordiness** — "in order to" → "to", "utilize" → "use". Safe.
- **Passive voice** — "the button is clicked by the user" → "click the
  button". Check the actor is actually known before rewriting.
- **Heading punctuation, link text, capitalization** — mechanical, low risk.
- **Gendered terms** — "he/she" → "they". Safe, and check surrounding
  agreement.
- **Contractions** — whichever direction the project's style goes; do not
  switch a document's register halfway through.
- **Spelling** — a flagged product name is not a misspelling. Use the
  `vocab` skill instead of editing the word.

## Do not

- **Do not silence a rule to make a run pass.** Turning off `Vale.Spelling`
  because it flags a product name is the wrong fix; so is disabling a rule the
  team chose. Changing the config is their decision, not yours.
- **Do not edit anything under `StylesPath`.** `vale sync` overwrites it.
- **Do not change what a sentence means** to satisfy a style rule. Technical
  accuracy wins; report the alert instead.
- **Do not fix warnings or suggestions** unless asked. They are advisory by the
  project's own choice.

Wersje

RepozytoriumWynikLicencja
Ta strona · vale-cli/agent-tools100MIT
swingerman/engineer100MIT
Hainrixz/claude-seo-ai100MIT
vanducng/skills100MIT
RemiPelloux/kill-my-idea100MIT
tony/skills100MIT
applelog/nondev-kit100MIT
A7-studio/jobmigo100MIT
koda-ai-studio/agent-bom100Apache-2.0

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

  • 100vale
    Uruchamia linter prozy Vale i automatycznie poprawia zgłoszone problemy w plikach markdown i tekstowych.
  • 100setup
    Instaluje Vale, tworzy plik .vale.ini, synchronizuje style i uruchamia pierwsze sprawdzenie języka w dokumentacji.
  • 100vale
    Instaluje, naprawia i waliduje linting prozy w Vale: konfiguracja, synchronizacja stylów, bramki lintu dokumentacji i diagnoza zepsutego workflow.
  • 100triage
    Pomaga przejść od pierwszego dużego przebiegu Vale do decyzji dla każdej reguły: poprawić, obniżyć lub wyłączyć.
  • 100ste-lint
    Sprawdza, upraszcza i przepisuje tekst do ASD-STE100 narzędziem vale: krótkie zdania, czynna forma, prosty słownik i brak skrótów.
  • 100authoring-documentation
    Prowadzi przez pisanie plików dokumentacji: szablony 11ty, shortcody Eleventy, adnotacje JSDoc i Markdown, z obsługą błędów lintera Vale, słownika i frontmatter.

Uwagi i zgłoszenia

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