unity-project-hygiene

Configure Git LFS, .gitignore, and ProjectSettings for Unity CI/CD repositories.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/BreakerOfStems/claude-skills --skill unity-project-hygiene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-project-hygiene
Source: https://github.com/BreakerOfStems/claude-skills/tree/main/skills/unity-project-hygiene
Command: npx skills add https://github.com/BreakerOfStems/claude-skills --skill unity-project-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the common challenges of maintaining stable, fast-to-clone, and CI/CD-ready Unity game development repositories by enforcing best practices for Git LFS, .gitignore, and project settings.

Core Features & Use Cases

  • Git LFS Configuration: Guides users on setting up and verifying Git Large File Storage for binary assets like textures, audio, and models.
  • .gitignore Best Practices: Provides a comprehensive Unity-specific .gitignore template to prevent committing unnecessary generated files.
  • Project Settings Validation: Ensures critical Unity project settings (ProjectSettings/) are correctly configured for text serialization and version control.
  • Use Case: Before merging a pull request for a new feature, run the pre-commit checklist to ensure all assets are tracked correctly, no large binaries are missed by LFS, and the project is ready for automated builds.

Quick Start

Use the unity-project-hygiene skill to set up Git LFS for your Unity project by tracking common binary file types.

Frequently Asked Questions about unity-project-hygiene

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

FAQPage Schema
How do I set up Git LFS for a Unity project repository?

To set up Git LFS for a Unity project, you must configure tracking rules for large binary assets like textures, audio, and models. This ensures binary assets are managed correctly without bloating the repository history.

What's the best way to configure a .gitignore file for Unity CI/CD pipelines?

The best way to configure a .gitignore for Unity CI/CD is to use a comprehensive template that prevents committing unnecessary generated files. Proper .gitignore configuration stops build artifacts from disrupting automated pipelines.

Why does my Unity project fail to build in CI/CD pipelines?

Unity project builds often fail in CI/CD pipelines due to incorrect ProjectSettings for text serialization and version control. Validating these essential settings ensures compatibility and stability for automated builds.

Do I need text serialization enabled for Unity version control?

Yes, text serialization is required for reliable Unity version control and CI/CD stability. Validating ProjectSettings to enforce text serialization prevents merge conflicts and ensures correct asset tracking.

Can I validate Unity ProjectSettings before merging a pull request?

Yes, you can run a pre-commit checklist to validate Unity ProjectSettings before merging a pull request. This verifies all assets are tracked correctly and no large binaries are missed by LFS.

What are common Git repository issues with Unity package management and build scripts?

Common Git repository issues with Unity package management and build scripts involve missing LFS configurations and unignored generated files. Addressing these issues stabilizes project settings for automated deployment.