Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Przegląd i audyt

beginners-eye

/beginners-eye

Ocenia poziom czytelności każdego zdania i wypisuje żargon, skróty i pojęcia, które nowy czytelnik musi poznać.

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

Brak sygnałów. Repozytorium zmienione 26.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ą
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: beginners_eye.py

Co robi i kiedy

Ocenia poziom czytelności każdego zdania i wypisuje żargon, skróty i pojęcia, które nowy czytelnik musi poznać.

Oryginalny opis (EN)

Grade each sentence's reading level and list the jargon, acronyms and domain terms a newcomer would need defined, in order of first use. Use this whenever the user writes something for someone new to the project or wants a reply in plain terms. Pairs with plain-terms, max-lexicon and expert-eye.

Jak działa

  1. The tool (ships with this skill)
  2. Uses and limits
Sekcje z nagłówków SKILL.md, w oryginale · 25 linii, 179 słów
Podgląd SKILL.md
---
name: beginners-eye
description: Grade each sentence's reading level and list the jargon, acronyms and domain terms a newcomer would need defined, in order of first use. Use this whenever the user writes something for someone new to the project or wants a reply in plain terms. Pairs with plain-terms, max-lexicon and expert-eye.
---

# beginners-eye

A **persona** lens that reads as someone on their first day. It grades every sentence with Flesch-Kincaid, using a vowel-group syllable count, and flags those above the chosen grade. It also builds the glossary a newcomer needs, in order of first use: acronyms, CamelCase names, coded ids (D71), domain jargon (Sharpe, backtest, bps, cache ...) and words of four or more syllables. Each term is marked "defined on the spot" (a parenthesis, "is a", "means" or a dash straight after it) or NOT defined.

## The tool (ships with this skill)

```
python beginners_eye.py <file|text> [--opt grade=10] [--json]
python beginners_eye.py --selftest
```

```python
from beginners_eye import apply
v = apply(open("SKILL.md").read(), grade=8)
```

Example finding: `TERM 'Sharpe' (domain jargon) first used in s1 - NOT defined`

## Uses and limits

- The syllable count and the jargon list are heuristics, and the jargon list leans toward this workspace (trading and dev).
- A term defined in another document still reads as undefined here.
- It measures difficulty, not correctness. Pair it with expert-eye to cover the other reader.
Pliki w paczce (2)
  • SKILL.md 1 KB
  • beginners_eye.py 5 KB

Wersje

W bazie nie ma innych skilli o nazwie beginners-eye.

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

  • 100jargon-extractor
    Wyciąga z dokumentów wewnętrzną terminologię, akronimy i żargon i buduje lub aktualizuje glosariusz JARGON.md, uruchamiając po jednym subagencie na plik i jeden subagent redukujący.
  • 90plain
    Tłumaczy poprzednią odpowiedź lub wskazany dokument prostym językiem dla nowicjusza, definiując każdy termin i opisując kod słowami.
  • 100plain-language
    Przepisuje tekst prostym językiem, odpowiadając najpierw na pytanie czytelnika, z krótkimi zdaniami i zachowaniem wszystkich faktów.

Uwagi i zgłoszenia

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