squad-conventions

Define development conventions for the Squad CLI using Node.js built-in modules.

3.1k|475|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/bradygaster/squad --skill squad-conventions-bradygaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: squad-conventions
Source: https://github.com/bradygaster/squad/tree/main/templates
Command: npx skills add https://github.com/bradygaster/squad --skill squad-conventions-bradygaster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill codifies the essential development conventions and patterns for the Squad CLI tool, ensuring consistency and maintainability across the codebase.

Core Features & Use Cases

  • Zero Dependencies: Enforces the use of only Node.js built-in modules.
  • Testing Standards: Mandates the use of the Node.js built-in test runner.
  • Error Handling: Implements a consistent fatal() pattern for user-facing errors.
  • Use Case: When contributing to the Squad CLI, understanding these conventions ensures your code integrates seamlessly and adheres to project standards.

Quick Start

Follow the squad conventions when writing new code for the Squad CLI.

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 runtime dependencies in a Node.js CLI project?

To enforce zero runtime dependencies, restrict your code to use only Node.js built-in modules instead of external packages. This convention ensures a lightweight, maintainable codebase with no installed dependency overhead.

How do I handle user-facing errors consistently in a Node.js command-line tool?

To handle user-facing errors consistently, implement a dedicated `fatal()` function for critical failures. This pattern standardizes error messaging and exits the process cleanly without throwing uncaught exceptions.

Can I use the Node.js built-in test runner for CLI tool development?

You can and should use the Node.js built-in test runner for CLI tool development. Mandating this built-in runner eliminates external testing dependencies, aligning with a zero-dependency project convention.

What is the best way to structure files for a Node.js CLI using built-in modules?

The best way to structure files for a Node.js CLI using built-in modules is to adhere to a standardized project layout. Following a defined file structure convention ensures seamless integration and maintains Windows compatibility.

Do I need external testing frameworks to run tests for a zero-dependency Node.js CLI?

You do not need external testing frameworks to run tests for a zero-dependency Node.js CLI. Conventions mandate using the Node.js built-in test runner, ensuring the testing environment remains lightweight and dependency-free.

Why does my Node.js CLI code need to follow Windows compatibility standards?

Your Node.js CLI code needs to follow Windows compatibility standards to ensure cross-platform functionality. Enforcing specific file structure and compatibility rules prevents platform-specific path and execution errors.