uncomment
/uncomment
Porządkuje komentarze w kodzie źródłowym: spisuje je, chroni wybrane, sprawdza zasady i usuwa resztę przez bibliotekę Rust.
- Autor
- goldziher ↗
- Repozytorium
- uncomment ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 09.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 0
- Komentarze HTML
- 1
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 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
- Uncomment Source Comment Cleanup
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · goldziher/uncomment | 95 | MIT |
| goldziher/uncomment | 95 | MIT |
| goldziher/uncomment | 95 | MIT |
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.