code-guidelines

Provide behavioral guidelines for writing and reviewing code to minimize LLM mistakes.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/Junyong34/utility-hub --skill code-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-guidelines
Source: https://github.com/Junyong34/utility-hub/tree/main/.agents/skills/code-guidelines
Command: npx skills add https://github.com/Junyong34/utility-hub --skill code-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a set of behavioral guidelines to help developers, especially those working with AI, avoid common coding pitfalls such as overcomplication, making unnecessary changes, and unclear success criteria.

Core Features & Use Cases

  • Pre-coding Strategy: Encourages explicit assumption surfacing and consideration of tradeoffs before implementation.
  • Simplicity Enforcement: Guides towards writing the minimum viable code, avoiding speculative features or premature abstractions.
  • Surgical Precision: Promotes making only necessary changes and cleaning up only what was introduced.
  • Goal-Oriented Development: Emphasizes defining clear, verifiable success criteria for tasks and iterating until verified.
  • Use Case: When refactoring a complex function, use these guidelines to ensure only the necessary parts are modified and that the changes are clearly testable.

Quick Start

Follow the code-guidelines skill to ensure your next code change is simple, surgical, and goal-driven.

Frequently Asked Questions about code-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent an LLM from overcomplicating code during development?

To prevent overcomplicating code, apply behavioral guidelines that enforce simplicity and minimum viable code. This approach avoids speculative features and premature abstractions, ensuring the LLM generates targeted, straightforward solutions.

What is the best way to define success criteria for AI-assisted coding tasks?

The best way to define success criteria for AI-assisted coding is to establish clear, verifiable goals before implementation. This goal-oriented development approach ensures you iterate until the changes are explicitly tested and verified.

How do I ensure surgical precision when reviewing LLM-generated code?

To ensure surgical precision during code review, enforce guidelines that promote making only necessary changes and cleaning up only what was introduced. This minimizes unnecessary modifications and reduces overall code complexity.

Should I surface assumptions before starting an LLM coding task?

Yes, you should surface explicit assumptions before starting an LLM coding task. Pre-coding strategy encourages surfacing assumptions and considering tradeoffs early to prevent scope creep and ensure accurate implementation.

How do I apply coding standards to refactor a complex function?

To refactor a complex function, apply coding standards that focus on surgical changes and verifiable success criteria. This ensures only the necessary parts are modified and the resulting changes remain clearly testable.