@koibykoik/code-correctness-skill
v0.3.0
Published
Modular agent skill for code review and refactoring, grounded in the s4.codes code-correctness lesson series.
Downloads
207
Maintainers
Readme
code-correctness-skill
clean code is not decoration. it is how code tells the truth.
@koibykoik/code-correctness-skill publishes the modular code-correctness skill for the open agent skills ecosystem.
what it is
this package contains:
- the top-level
code-correctnessorchestrator skill - eight progressively loaded theme references containing 47 lessons
- one lesson per reel from the saved
s4.codesseries - a single discoverable skill entrypoint
the skill is designed to review and refactor code by grounding the reasoning in explicit lesson intentions instead of generic clean-code slogans.
lesson themes
references/meaningful-names.mdreferences/functions.mdreferences/comments.mdreferences/formatting.mdreferences/objects-and-data.mdreferences/error-handling.mdreferences/boundaries.mdreferences/unit-tests.md
what it helps with
- confusing or misleading names
- long or mixed-responsibility functions
- hidden side effects
- stale, noisy, or misleading comments
- file structure and readability issues
- weak abstraction boundaries
- error-handling structure and null semantics
- third-party wrappers and adapters
- TDD, test readability, and safe behavior-preserving change
- behavior-preserving refactors grounded in explicit lessons
acknowledgements
the modular lesson tree is based on the public s4.codes clean-code reel series.
- instagram:
https://instagram.com/s4.codes - the saved reel descriptions and transcriptions are used as lesson source material
- the tree is intended to keep growing as more videos in the series come out
thanks to s4.codes for publishing the series and making the principles concrete enough to turn into a reusable skill system.
install
npx skills add koikbr/code-correctness-skilllist the available skill before installing:
npx skills add koikbr/code-correctness-skill --listinstall only code-correctness:
npx skills add koikbr/code-correctness-skill --skill code-correctnessopen source
yes, this package is open source.
- license:
GPL-3.0 - repository:
https://github.com/koikbr/code-correctness-skill
note
the skill is discovered and installed from the public GitHub repository via npx skills.
this npm package publishes the packaged skill contents, but end users typically install the skill from GitHub.
support
- website: https://koik.com.br
- github: https://github.com/koikbr/code-correctness-skill
- email: [email protected]
