coding-guidelines

Provide structured behavioral guidelines for writing, reviewing, refactoring, and debugging code.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/Mercurykz/Barretao- --skill coding-guidelines-mercurykz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coding-guidelines
Source: https://github.com/Mercurykz/Barretao-/tree/main/.cursor/skills/coding-guidelines
Command: npx skills add https://github.com/Mercurykz/Barretao- --skill coding-guidelines-mercurykz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, modifying, or reviewing code — implementation tasks, code changes, refactoring, bug fixes, or feature development. Do NOT use for architecture design, documentation, or non-code tasks.

Core Features & Use Cases

  • Provides a structured approach to thinking before coding to surface assumptions and tradeoffs.
  • Emphasizes simplicity, surgical changes, and goal-driven execution to minimize unintended changes.
  • Use case: a developer reviews a patch to ensure it contains only necessary edits and clear justification.

Quick Start

Apply these guidelines to your current coding task to ensure clarity, minimalism, and testability.

Frequently Asked Questions about coding-guidelines

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

FAQPage Schema
How do I reduce common coding mistakes during refactoring and bug fixes?

To reduce common coding mistakes during refactoring, apply structured behavioral guidelines that emphasize surgical changes and goal-driven execution. This ensures traceable edits and minimizes unintended side effects across software projects.

What is the best way to structure a code review for minimal and safe changes?

The best way to structure a code review for safe changes is to enforce clear decision criteria and guardrails. Reviewing patches to ensure they contain only necessary edits with clear justification improves consistency and quality.

Can I use these coding guidelines for architecture design and project documentation?

No, you cannot use these coding guidelines for architecture design or documentation. They are explicitly designed for writing, modifying, reviewing, and debugging code tasks to preempts common implementation errors.

How do I ensure my code changes have testable outcomes and traceable modifications?

To ensure code changes have testable outcomes and traceable modifications, follow behavioral guidelines that define success criteria. Thinking before coding surfaces assumptions and tradeoffs for surgical edits.

When do I need behavioral guidelines for software engineering tasks?

You need behavioral guidelines for software engineering tasks when writing, modifying, or reviewing code. They preempts common coding mistakes by providing a structured approach to ensure clarity, minimalism, and testability.