repo-best-practices

Align code generation with repository reuse-first patterns and conventions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Adrienenjalbert/flex-carrer-hub --skill repo-best-practices-adrienenjalbert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-best-practices
Source: https://github.com/Adrienenjalbert/flex-carrer-hub/tree/main/.agents/skills/repo-best-practices
Command: npx skills add https://github.com/Adrienenjalbert/flex-carrer-hub --skill repo-best-practices-adrienenjalbert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams avoid duplicated code and misaligned implementations by guiding code-generation and review to reuse existing patterns, constants, and registries within the repository.

Core Features & Use Cases

  • Encourages reuse before creating new abstractions, promoting config-driven data and feature-local helpers.
  • Provides guidelines for avoiding duplication in page shells, tools, and components, and for extracting common logic into shared utilities.
  • Useful for code reviews, code-generation tasks, and onboarding new contributors to align with established repo conventions.

Quick Start

Provide a small code change that reuses an existing pattern from the codebase instead of creating a new abstraction.

Frequently Asked Questions about repo-best-practices

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

FAQPage Schema
How do I align code generation with existing repository patterns?

To align code generation with repository patterns, identify opportunities to reuse existing registries, constants, and shared shells before creating new abstractions, ensuring generated outputs respect the repo's reuse-first conventions.

What are the best practices for avoiding code duplication during code review?

Best practices for avoiding code duplication during review involve checking that new implementations prefer config-driven data, extract common logic into feature-local helpers, and reuse existing page shells and components rather than introducing redundant abstractions.

When should I extract common logic into shared utilities instead of duplicating code?

You should extract common logic into shared utilities when code generation tasks produce duplicated implementations, specifically refactoring to leverage existing repo patterns, constants, and pure functions to maintain testability and reduce redundancy.

How do I make generated code more testable using config-driven data?

Make generated code more testable by aligning outputs with config-driven data patterns and extracting logic into pure functions, ensuring the code respects existing repository registries and shared shells while isolating side effects.

Can I use repo pattern guidelines to onboard new contributors to codebase conventions?

You can use repo pattern guidelines to onboard new contributors by demonstrating how to provide small code changes that reuse existing patterns, helping them understand established conventions for config-driven data and feature-local helpers.

What is the best way to handle code generation for features that need shared shells and registries?

The best way to handle code generation for shared shells and registries is to ensure the generation process respects existing repo patterns, avoids duplicating page shells, and provides pure functions for testability across typical codegen tasks.