squad-conventions

Enforce Squad coding conventions for zero-dependency, Windows-safe paths, and fatal() error handling.

3|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/isaacrlevin/VideoSplitter --skill squad-conventions-isaacrlevin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: squad-conventions
Source: https://github.com/isaacrlevin/VideoSplitter/tree/main/.ai-team-templates
Command: npx skills add https://github.com/isaacrlevin/VideoSplitter --skill squad-conventions-isaacrlevin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill codifies the Squad project's conventions to prevent accidental regressions, dependency creep, and cross-platform breakage when contributors modify the CLI, templates, or team-owned files.

Core Features & Use Cases

  • Zero-dependency enforcement: Documented rules and examples for using Node.js built-ins only and avoiding new npm runtime dependencies.
  • Testing & error-handling standards: Prescribes node:test as the test runner and the fatal() error pattern plus ANSI color constants for consistent user-facing errors.
  • Platform and init safety: Guidelines for Windows-safe path construction using path.join(), idempotent init behavior, and safe recursive copy patterns.
  • Use Case: Validate an init or upgrade change to ensure it doesn't add dependencies, doesn't use hardcoded path separators, and follows the project's error and test conventions.

Quick Start

Use the squad-conventions skill to validate a proposed change for zero-dependency compliance, Windows-safe paths, and the fatal() error pattern before opening a pull request.

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

Enforce zero-dependency rules in a Node.js CLI project by codifying standards to use Node.js built-ins only and validating changes to prevent accidental npm runtime dependency additions before pull requests.

What's the best way to ensure Windows-safe path construction in Node.js?

Ensure Windows-safe path construction in Node.js by using path.join() for all file operations, which prevents cross-platform breakage caused by hardcoded path separators in CLI development.

How does the fatal() error pattern work for Node.js CLI user-facing errors?

The fatal() error pattern works for Node.js CLI user-facing errors by standardizing error handling alongside ANSI color constants, ensuring consistent formatting and safe exits across CLI operations.

Can I use node:test for idempotent init behavior in a Node.js CLI?

Yes, you can use node:test to verify idempotent init behavior in a Node.js CLI by writing tests that validate init and upgrade flows run safely without duplicating files or state across multiple executions.

Why do my Node.js CLI tests fail when checking project conventions?

Node.js CLI tests fail when checking project conventions if changes violate zero-dependency rules, use hardcoded path separators instead of path.join(), or skip the required fatal() error pattern.

Do I need external testing dependencies to validate Squad CLI conventions?

No, you do not need external testing dependencies to validate Squad CLI conventions because the standards prescribe using node:test as the test runner and Node.js built-ins to maintain zero runtime dependencies.