squad-conventions

Define and enforce Squad conventions for Node.js projects with zero runtime dependencies.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/jperezdelreal/GymBro --skill squad-conventions-jperezdelreal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: squad-conventions
Source: https://github.com/jperezdelreal/GymBro/tree/main/.copilot/skills/squad-conventions
Command: npx skills add https://github.com/jperezdelreal/GymBro --skill squad-conventions-jperezdelreal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Defines core conventions and patterns used in the Squad codebase to ensure consistency, reliability, and safe, maintainable AI squad tooling.

Core Features & Use Cases

  • Zero-dependency design for Squad CLI tools, relying only on Node.js built-ins.
  • Defined error handling pattern using fatal() for user-facing errors and clean failure modes.
  • Standardized CLI and project structure with .squad/ directories and templates.
  • Windows compatibility and robust path handling via path.join to avoid platform-specific bugs.
  • Init idempotency to avoid overwriting user state during setup or upgrades.
  • Copy pattern guidance for safe file and directory operations during upgrades and scaffolding.
  • Real-world use: teams adopting Squad conventions can bootstrap new projects with consistent tooling and error handling from day one.
  • Anti-pattern warnings and governance to prevent unsafe changes.

Quick Start

Audit your Squad project against these conventions to ensure zero-dependency patterns and safe file operations.

Frequently Asked Questions about squad-conventions

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

FAQPage Schema
How do I enforce consistent coding standards across multiple Node.js projects?

You can enforce consistent coding standards by codifying unified Squad conventions for error handling, file operations, and repository structure across your Node.js codebases. This ensures predictable behavior and maintainability across Windows and Unix environments with zero runtime dependencies.

What is the best way to handle CLI errors in Node.js without external dependencies?

The best way to handle CLI errors with zero dependencies is using a standardized fatal() pattern for user-facing errors. This approach relies only on Node.js built-ins to provide clean failure modes and predictable behavior across your team's tooling.

How do I prevent file overwrites during project scaffolding upgrades?

You prevent file overwrites by implementing init idempotency and following specific copy pattern guidance for safe file operations. This ensures setup and upgrade processes avoid overwriting existing user state and maintain safe, idempotent behavior.

Does this Squad conventions skill require any external runtime dependencies?

No, this Squad conventions skill has a zero-dependency design and requires no external runtime packages. It relies exclusively on Node.js built-ins, allowing you to bootstrap projects and maintain tooling without managing additional external dependencies.

How do I avoid platform-specific path bugs in cross-platform CLI tools?

You avoid platform-specific path bugs by using robust path handling via path.join and enforcing Windows compatibility conventions. This ensures safe, predictable file operations across both Windows and Unix environments within your Node.js codebase.

What anti-patterns should I avoid when structuring Node.js CLI repositories?

You should avoid unsafe file operations, non-idempotent setup scripts, and introducing external runtime dependencies. The skill provides anti-pattern warnings and governance to prevent these unsafe changes and maintain reliable, standardized repository structures.