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ć.
- Repozytorium
- maestro-companions ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 26.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 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
- The tool (ships with this skill)
- Uses and limits
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.