squad-conventions

Define and enforce standard conventions for the Squad codebase.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardizes conventions for the Squad codebase to ensure consistency, maintainability, and safe, predictable development practices across the project.

Core Features & Use Cases

  • Zero-dependency guidance: every routine uses Node.js built-ins, avoiding runtime dependencies.
  • Structured project layout: prescribed folders like .squad/, templates/, and .skill/ to organize state, templates, and skills.
  • Robust error handling and UX: standardized fatal() error reporting, consistent color constants, and guardrails for failures.
  • Cross-platform compatibility: Windows-safe path handling and use of path.join() for all file paths.
  • Init and upgrade idempotency: skip-existing behavior during init and controlled overwrites for Squad-owned files.
  • Copy and file-management patterns: safe recursive copy with proper directory creation.

Quick Start

Follow these conventions when contributing to Squad code to ensure zero-dependency patterns and safe error handling across platforms.

Frequently Asked Questions about squad-conventions

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

FAQPage Schema
How do I enforce zero-dependency conventions in a Node.js codebase?

Enforce zero-dependency conventions by mandating every routine uses Node.js built-in modules exclusively, avoiding external runtime dependencies. This ensures predictable execution and maintainability across the Squad codebase.

What is the best way to handle file paths safely across Windows and other platforms?

Windows-safe file path handling requires using path.join() for all path construction to ensure cross-platform compatibility. This prevents path resolution errors when moving code between Windows and Unix-based environments.

How do I implement safe error handling for Node.js CLI applications?

Safe error handling for Node.js CLI applications is implemented using a standardized fatal() reporting function. This provides consistent guardrails for failures and uniform color-coded UX feedback during execution.

Can I use Node.js built-in tooling for CLI development without external dependencies?

Node.js built-in tooling fully supports CLI development without external dependencies by leveraging built-in modules for file management, recursive copy, and directory creation. The Squad conventions prescribe this zero-dependency approach for all CLI tasks.

Why does my project init keep overwriting existing files?

Project init overwrites happen when idempotency controls are missing. The Squad conventions implement skip-existing behavior during initialization and controlled overwrites specifically for Squad-owned files to prevent data loss.

Do I need a specific folder structure for Node.js CLI skill definitions?

A specific folder structure is required for Node.js CLI skill definitions. The conventions prescribe using a .squad/ directory for state, templates/ for templates, and *.skill*/ folders to organize all skill definitions.