obra/clank
https://skillcdn.ai/gh/obra/clankConnect this address to your AI to use these skills. How to connect
- Unverified
- Default branch
main - Commit
2db8793 - License
None declared
Explore this repository
Searches the original text of skills and documents; display translations are not searched.
Skills
- Commenting Intent3 warningsComment WHY code exists and non-obvious decisions, not WHAT code does (mechanics)
- Designing Before Coding3 warningsDesign in pseudocode first, iterate approaches, then translate to code
- Exploring Alternatives3 warningsTry 2-3 different approaches before implementing - don't settle for first design you think of
- Keeping Routines Focused3 warningsEach routine does one thing and does it well - extract when routines have multiple responsibilities
- Localizing Variables3 warningsDeclare variables in smallest possible scope, initialize close to first use, minimize span and live time
- Domain-Focused Naming3 warningsName code by what it does in the domain, not how it's implemented or its history
- Naming Variables3 warningsChoose names that fully and accurately describe what the variable represents
- Refactoring Safely3 warningsRefactor with tests first, one change at a time, never mix refactoring with bug fixes or new features
- Simplifying Control Flow3 warningsFlatten nested conditionals with early returns or table-driven methods - keep nesting depth under 3 levels
- Single Purpose Variables3 warningsUse each variable for exactly one purpose - no hybrid coupling or hidden meanings
- Validating Inputs3 warningsCheck all external inputs for validity - garbage in, nothing out, never garbage out
- Writing Evergreen Comments3 warningsWrite comments explaining WHAT and WHY, never temporal context or history