Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

uncomment

/uncomment

Porządkuje komentarze w kodzie źródłowym: spisuje je, chroni wybrane, sprawdza zasady i usuwa resztę przez bibliotekę Rust.

Repozytorium
uncomment ↗
Licencja
MIT
Ostatnia zmiana repozytorium
09.11.2026

Ocena i bezpieczeństwo

95/ 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ść30 / 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
4
Skrypty
0
Komentarze HTML
1
Adresy URL w SKILL.md
1
Przestarzałość

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

Co robi i kiedy

Porządkuje komentarze w kodzie źródłowym: spisuje je, chroni wybrane, sprawdza zasady i usuwa resztę przez bibliotekę Rust.

Oryginalny opis (EN)

Inventory, preserve, lint and remove source comments using Uncomment's tree-sitter CLI or Rust library. Use for comment cleanup and preservation policies without changing comment-like text in strings.

Jak działa

  1. Uncomment Source Comment Cleanup
Sekcje z nagłówków SKILL.md, w oryginale · 97 linii, 516 słów
Podgląd SKILL.md
---
description: Inventory, preserve, lint and remove source comments using Uncomment's tree-sitter CLI or Rust library. Use for comment cleanup and preservation policies without changing comment-like text in strings.
name: uncomment
license: MIT
metadata:
    author: Goldziher
    repository: https://github.com/Goldziher/uncomment
---

<!--
AI-RULEZ :: GENERATED FILE — DO NOT EDIT
Content-Hash: blake3:0c7de78d48b93b3fbba0488c23059fea8b4e0ff49f7c1de07c8c7bbf8a3c24fa
Source-Hash: blake3:632626448c20c35e5a1201704fa17dabcd59ec395a3e338c62ac5d02b619d20c
Schema-Version: v1
-->

## Uncomment Source Comment Cleanup

Uncomment uses tree-sitter to find source comments. This skill targets Uncomment
3.10 and newer, including `scan`, `keep`, `lint` and the `--check` gate. Install the
CLI separately; this plugin provides instructions and has no MCP server.

```bash
cargo install uncomment --version '^3.10'
# Binary wrappers are available as uncomment-cli on npm and uncomment on PyPI.
uncomment --version
```

### Inspect and preview

Start with the paths the user selected. An ordinary removal invocation writes
files; `scan`, `--dry-run`, and `--check` let you inspect the planned cleanup.

```bash
uncomment scan src/ --only removable --format jsonl --output comments.jsonl
uncomment src/ --dry-run --diff
```

Scan records contain `id`, `path`, `line`, `end_line`, `start_byte`, `end_byte`,
`kind`, `verdict` and `text`. Preserved records also include `reason`. Positions are
one-based lines and zero-based byte offsets. Use IDs to select comments; IDs survive
edits above a comment but depend on its path, exact text and occurrence index.

### Preserve selected comments

Use a plain comment marker for comments that must survive cleanup:

```rust
// This workaround must stay until the upstream fix ships. ~keep
// ~keep
/// Documentation that must survive --remove-doc.
```

A standalone marker uses the language's plain comment token, such as `//` or `#`,
not a documentation prefix such as `///`. Quoted mentions of `~keep` are prose,
not active markers. Let `keep` handle block comments and docstrings so it can
place and verify the marker without editing their runtime contents.

```bash
uncomment keep src/ --id 'ID_FROM_SCAN'
uncomment keep src/ --match 'workaround' --dry-run --diff
uncomment keep src/ --from selected-comments.jsonl
```

`--from` marks every ID in the supplied JSON or JSONL records; select the records
first. Extra decision fields do not turn an ID into a rejection. Missing IDs fail
unless `--skip-missing` is explicitly requested.

### Apply cleanup or gate it

```bash
uncomment src/ --dry-run --diff
uncomment src/
uncomment --check src/ --format json
uncomment --check --changed-only --base origin/main .
```

Defaults preserve TODO/FIXME, documentation, common lint directives and active
`~keep` markers. `--remove-todo`, `--remove-fixme` and `--remove-doc` opt into removing
those categories; `--ignore PATTERN` adds case-sensitive substring preservation.
`--no-default-ignores` disables the built-in preservation patterns.

The removal gate exits 0 when nothing would be removed, 1 when removable comments
exist, and 2 when inspection could not complete. Check reported file counts;
zero matched files are not evidence that the intended tree passed. In 3.10.3, a
missing input path can print an error and still exit 0, so also verify paths exist
and the report covers the expected files. Current main source builds reject a
missing explicit path with exit 2; that fix has not been released yet.

### Lint tag conventions

Tag linting removes nothing and is inactive until `[lint] enabled = true` is
configured. Use [configuration](references/configuration.md) for layering,
exclusions and rule settings.

```bash
uncomment lint src/ --format json
uncomment lint src/ --fix --todo-key 'PROJECT-123'
```

Use `--fix` only when rewriting tag comments is part of the requested work.
The key must be a real issue key chosen for that project.

For read-only Rust integration, see [library usage](references/library.md).
Pliki w paczce (4)
  • SKILL.md 4 KB
  • index.md 1 KB
  • references/configuration.md 3 KB
  • references/library.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · goldziher/uncomment95MIT
goldziher/uncomment95MIT
goldziher/uncomment95MIT

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

  • 100tree-sitter-language-pack
    Parsuje kod w 372 językach przez gramatyki tree-sitter i wyciąga z niego symbole, importy oraz komentarze.
  • 100code-docs-cleanup
    Skraca i porządkuje komentarze w kodzie źródłowym klauzula po klauzuli, zachowując guardy, czyli komentarze wyjaśniające, dlaczego nieoczywista linia musi zostać i co się zepsuje po zmianie.
  • 100comment-hygiene
    Porządkuje komentarze i docstringi w kodzie: usuwa komentarze o cechach AI i nieaktualne, zostawia tylko niejasny powód i nie zmienia kodu wykonywalnego.
  • 100comment-cleanup
    Czyści komentarze w plikach lub folderach: usuwa zbędne, powtarzające kod i kronikujące stare zmiany.
  • 90superior-comments
    Dodaje, poprawia lub usuwa komentarze w kodzie bez zmiany działania programu, porządkując TODO i dokumentację.
  • 100comment-sweep
    Porządkuje lub audytuje komentarze w gałęzi lub diffie przed recenzją: usuwa zbędne i martwe komentarze, zostawia wartościowe.

Uwagi i zgłoszenia

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