conventions-guide

What problem does it solve?

Inconsistent naming, disorganized file structures, and excessive file sizes can lead to unmaintainable codebases, slower development, and difficulty collaborating. This skill provides a clear, strict guide to project conventions.

Core Features & Use Cases

• Naming Conventions: Enforces strict kebab-case for all files (agents, skills, commands) and directories.
• Size Limits: Specifies maximum line counts for agents (≤30 lines) and implementation skills (≤50 lines).
• Structure Requirements: Defines mandatory frontmatter for agents and skills, and prohibits "parasite files" (e.g., .backup, README.md).
• Use Case: Before creating new agents or skills, consult this guide to ensure all new components adhere to the project's strict naming, sizing, and structural conventions, preventing future refactoring and promoting a clean, consistent codebase.

Quick Start

Use the conventions-guide skill to check the naming rules for new agent files.