llm-coding-principles
by Roy Yuen
Enforce senior-level coding standards (Surgical, Simple, Goal-Driven) on every AI-generated code change.
- Prevent over-engineering and speculative abstractions in new features.
- Ensure minimal, surgical diffs during bug fixes and refactors.
- Automatically apply a Red-Green-Refactor workflow to agent tasks.
Free
Sample input
Add a 'status' field to the User model, but don't touch any other parts of the database schema or the existing API endpoints.
Sample output
Approaches: 1. Add nullable column (safest). 2. Add with default 'active'. Choosing #2 for immediate utility.
Success Criteria:
- migration adds
statustousers. - User model includes
status.
Diff:
- status = Column(String, default="active") Verification: Migration tested; field persists.
llm-coding-principles
by Roy Yuen
Enforce senior-level coding standards (Surgical, Simple, Goal-Driven) on every AI-generated code change.
Free
Included in download
- Downloadable skill package
- Works with Claude Code, Cursor
- Instant install
Sample input
Add a 'status' field to the User model, but don't touch any other parts of the database schema or the existing API endpoints.
Sample output
Approaches: 1. Add nullable column (safest). 2. Add with default 'active'. Choosing #2 for immediate utility.
Success Criteria:
- migration adds
statustousers. - User model includes
status.
Diff:
- status = Column(String, default="active") Verification: Migration tested; field persists.
About This Skill
Expert Coding Governance for AI Agents
Does your AI agent sometimes over-engineer simple tasks or make sweeping, unnecessary changes to your codebase? llm-coding-principles is a high-performance directive standard that installs a "Senior Engineer" persona into your agent's workflow. It replaces guesswork with a rigorous four-pillar framework: Think Before Coding, Simplicity First, Surgical Changes, and Goal-Driven Execution.
What it does
- Think Before Coding: Forces the agent to surface assumptions and evaluate technical trade-offs before a single line is written.
- Simplicity First: Eliminates speculative abstractions and "future-proofing" to keep your codebase lean and maintainable.
- Surgical Changes: Ensures diffs are precise, touching only what is necessary to satisfy the requirements while avoiding unrelated "noise" or style drift.
- Goal-Driven Execution: Mandates a Red-Green-Refactor cycle where success criteria are defined and verified before the task is marked complete.
Why use this skill
Standard LLM prompting often leads to "hallucinated improvements"—refactoring code you didn't ask to change or adding dependencies you don't need. This skill acts as a non-negotiable quality gate. It’s ideal for developers using Cursor, Claude Code, or custom CLI agents who want consistent, production-grade output that mirrors the discipline of a human senior developer. It integrates seamlessly with TDD workflows and systematic debugging.
Use Cases
- Prevent over-engineering and speculative abstractions in new features.
- Ensure minimal, surgical diffs during bug fixes and refactors.
- Automatically apply a Red-Green-Refactor workflow to agent tasks.
- Enforce consistent technical decision-making across sub-agents.
Known Limitations
- Not suitable for experimental or creative prototyping.
- May resist large-scale refactors unless explicitly ordered.
- Requires clear initial requirements to define success criteria.
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/llm-coding-principles -o /tmp/llm-coding-principles.zip && unzip -o /tmp/llm-coding-principles.zip -d ~/.claude/skills && rm /tmp/llm-coding-principles.zipFree skills install directly. Paid skills require purchase - use the download button above after buying.
Reviews
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
No special permissions declared or detected
Claude Code, Cursor, Aider, Windsurf, and Cline.
Frequently Asked Questions
Learn More About AI Agent Skills
More Premium Skills
designing-hybrid-context-layers
Architects the right retrieval strategy for every query — teaching your agent when to use RAG, a knowledge graph, or a temporal index instead of defaulting to vector search for everything.
consumer-motivation-analyzer
Go beyond surface-level feedback to uncover the psychological drivers and hidden motivations behind buyer behavior.
Bounty Security Pattern Master Library — 399 Vulnerability Patterns
A premium library of 399 vulnerability patterns and DeFi attack vectors for AI-driven bug hunting and security audits.
ai-automation-qa-pack
Professional QA & UAT documentation generator for AI automation agencies and complex agent deployments.