space-lint

Validate Anteroom space YAML files for schema, URL, and config issues.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/troylar/anteroom --skill space-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: space-lint
Source: https://github.com/troylar/anteroom/tree/main/src/anteroom/cli/default_skills/space-lint
Command: npx skills add https://github.com/troylar/anteroom --skill space-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates Anteroom space YAML files before registration to catch schema, URL, pack, pack_source, instruction, and config issues early, preventing failed loads, accidental commits of machine-specific settings, and insecure or inconsistent team-shared spaces.

Core Features & Use Cases

  • Comprehensive Schema Validation: Parses YAML and reports schema errors, missing version, and malformed fields.
  • Repository and URL Checks: Ensures repo and pack_source URLs use allowed schemes, appear to be valid git URLs, and flags duplicates.
  • Pack and Config Reviews: Verifies pack reference formats, branch and refresh_interval constraints, and warns about misplaced top-level config keys and instruction length problems.
  • Git Context Awareness: Detects whether the space file is inside a git repo and warns if .local.yaml is not gitignored to avoid committing machine-specific data.
  • Use Case: Run before committing or loading a team or personal space file to surface errors and warnings so you can fix them prior to registration.

Quick Start

Validate the space YAML file at ~/.anteroom/spaces/example.yaml to report schema problems and configuration warnings before loading it.

Frequently Asked Questions about space-lint

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

FAQPage Schema
How do I validate a space YAML file before registering it?

You validate a space YAML file by parsing it and running schema checks to detect missing versions, malformed fields, and invalid URLs without modifying the file.

What is Anteroom space YAML validation and when do I need it?

Anteroom space YAML validation is the process of checking space configuration files for schema, URL, pack, and config issues before loading them to prevent broken or insecure team-shared setups.

How do I prevent committing machine-specific local YAML settings to a git repository?

To prevent committing machine-specific settings, validate the space file with git-context awareness to detect if it is inside a repo and warn when .local.yaml is not properly gitignored.

Does space YAML validation check pack source URLs and branch constraints?

Yes, space YAML validation checks pack_source URLs for allowed schemes and valid git URLs, verifies pack reference formats, and enforces branch and refresh_interval constraints.

What are the limitations of running a pre-registration space YAML check?

A limitation of pre-registration space YAML validation is that it only outputs pass, warn, or fail diagnostics and does not modify files or register the space directly with the Anteroom system.