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

engineering-principles

/engineering-principles

Pilnuje podstawowych zasad jakości kodu: YAGNI, KISS, DRY z rozwagą i małych, czytelnych zmian.

Repozytorium
brain ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

86/ 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ść21 / 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
1
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

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

Pilnuje podstawowych zasad jakości kodu: YAGNI, KISS, DRY z rozwagą i małych, czytelnych zmian.

Oryginalny opis (EN)

Core code-quality rules — YAGNI, KISS, DRY with judgment, small single-purpose units, clear naming, minimal-scope diffs. Use whenever writing, refactoring, or reviewing code in this repo.

Jak działa

SKILL.md bez nagłówków drugiego poziomu · 28 linii, 426 słów

Podgląd SKILL.md
---
name: engineering-principles
description: Core code-quality rules — YAGNI, KISS, DRY with judgment, small single-purpose units, clear naming, minimal-scope diffs. Use whenever writing, refactoring, or reviewing code in this repo.
---

<!-- A copy of the crew plugin's skill (johantor/crew, plugins/crew/skills/engineering-principles). -->
# Engineering principles
Defaults, not dogma — when a rule conflicts with the repo's established patterns, the repo wins.

- **Match the repo.** Follow existing conventions, structure, and idioms even over personal preference. Consistency beats local "better".
- **YAGNI.** Build only what the task needs. No speculative abstractions, config knobs, unused params, or "future-proofing". Delete dead code.
- **KISS.** Simplest solution that works; optimize for the next reader, not cleverness.
- **DRY with judgment.** Rule of three before abstracting; a little duplication beats the wrong abstraction; don't couple unrelated code that merely looks similar.
- **Small units.** One thing, one reason to change; short functions; composition over inheritance; minimal public surface.
- **Naming/comments.** Intention-revealing names; comments explain *why*, not *what*; no commented-out code; no TODO graveyards.
- **Errors.** Fail fast, handle explicitly, validate at boundaries; never silently swallow.
- **Security.** Treat external input as untrusted — validate and encode at trust boundaries; prefer the framework's safe API (parameterized queries, safe templating) over hand-rolled escaping. Never hardcode or log secrets; least privilege by default.
- **Observability.** Make failures diagnosable — log with enough context to locate the cause and surface errors where they'll be seen, never bury them. Match the repo's logging idiom; no noisy logging on the happy path.
- **Minimal-scope diffs.** Smallest change that solves the problem; don't sprawl refactors into unrelated files; list unrelated improvements instead of doing them.
- **Backward compatibility.** Don't break existing callers or data — preserve public signatures, serialized formats, and observable behavior unless changing them is the task; when you must, migrate or version deliberately.
- **Dependencies.** Prefer stdlib/existing deps; don't add a package for something trivial.
- **Reach for new code last.** Before writing any, check these in order and stop at the first that applies. Subordinate to *match the repo*: never pick a shorter option over the house pattern.
  1. Not needed → don't build it.
  2. Stdlib or runtime covers it → use that.
  3. Native platform/framework feature covers it → use that.
  4. Installed dependency covers it → use that; don't add a new one.
  5. Collapses to a line or two without hurting readability → do that.
  6. Else write the minimum that works. On a tie between equal-size options, take the one that handles the edge cases.
- **Performance.** Clarity first; measure before optimizing.
- **Tests.** Test behavior, not implementation; meaningful assertions; no coverage theater.
- **Before finishing.** Re-read your diff as a reviewer; remove anything unneeded; confirm it follows repo conventions.

Wersje

RepozytoriumWynikLicencja
Ta strona · johantor/brain86Apache-2.0
joeblackwaslike/agent-skills100MIT
wolfinApp/wolfin-senior100MIT
Cynnamoroll/factory-stack90MIT
voyager67/Agent-Workbench86MIT
ericwang200608-beep/LANYANT-Skills85MIT
jstarfilms/vibecode-protocol-suite85ISC

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

  • 100code-quality-principles
    Stosuje zasady KISS, YAGNI i SOLID, aby uprościć kod i uniknąć nadmiarowej inżynierii podczas refaktoryzacji lub przeglądu.
  • 100react-principles
    Pomaga pisać i przeglądać komponenty React zgodnie z zasadami SOLID, DRY, KISS i YAGNI, z hookami, stanem i efektami.
  • 95clean-code
    Poprawia czytelność kodu według zasad DRY, KISS i YAGNI, gdy metody są długie, nazwy niejasne lub zagnieżdżenia głębokie.
  • 85backend-code-quality-review
    Przegląda kod backendu pod kątem zasad SOLID, DRY, KISS i YAGNI oraz nazewnictwa, spójności i sprzężeń między modułami.
  • 100backend-development
    Wprowadza zmiany w kodzie backendu dla handlerów Lambda, warstw usług i operacji DynamoDB według zasad KISS, YAGNI i DRY, minimalnymi poprawkami.
  • 100clean-code-principles
    Omawia zasady SOLID, wzorce projektowe, DRY i KISS przy przeglądzie architektury, ocenie jakości kodu i refaktoryzacji.

Uwagi i zgłoszenia

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