Guidelines for writing maintainable, robust, and self-documenting code.
Quick Start
// Self-documenting with proper error handling
function createUser(email: string, age: number): User {
if (!email.includes("@")) throw new Error("Invalid email");
if (age < 0 || age > 150) throw new Error("Invalid age");
return { email, age };
}
Key Principles
Compare entities by IDs, never by slugs/usernames/strings
Use meaningful names (self-documenting code)
Comments explain "why", not "what"
DRY: abstract when used 3+ times
Validate all input data
Handle all error cases with proper Error objects
Never ignore errors
Use named constants instead of magic values
Avoid circular dependencies
References
See rules.md for complete guidelines with examples.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: eser-aya-is-coding-practices3description: Coding Practices4---56# Coding Practices78Guidelines for writing maintainable, robust, and self-documenting code.910## Quick Start1112```typescript13// Self-documenting with proper error handling14function createUser(email: string, age: number): User {15 if (!email.includes("@")) throw new Error("Invalid email");16 if (age < 0 || age > 150) throw new Error("Invalid age");17 return { email, age };18}19```2021## Key Principles2223- Compare entities by IDs, never by slugs/usernames/strings24- Use meaningful names (self-documenting code)25- Comments explain "why", not "what"26- DRY: abstract when used 3+ times27- Validate all input data28- Handle all error cases with proper Error objects29- Never ignore errors30- Use named constants instead of magic values31- Avoid circular dependencies3233## References3435See [rules.md](references/rules.md) for complete guidelines with examples.3637---38> Converted and distributed by [TomeVault](https://tomevault.io/claim/eser) — claim your Tome and manage your conversions.39<!-- tomevault:4.0:skill_md:2026-04-11 -->
Run npx skillmds@latest add tomevault-io/eser-aya-is-coding-practices in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Coding Practices It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io