skills.rest
troylar
troylarCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

space-edit

Edit Anteroom space YAML files to modify repos, packs, instructions, mappings, and config.

Updated Aug 27, 2026
Search Tags:#git#validation#cli#configuration#repos#space#packs
One-click install
npx skills add https://github.com/troylar/anteroom --skill space-edit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: space-edit
Source: https://github.com/troylar/anteroom/tree/main/src/anteroom/cli/default_skills/space-edit
Command: npx skills add https://github.com/troylar/anteroom --skill space-edit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Editing Anteroom space definitions (repos, packs, instructions, and config) is error-prone and can leave running sessions or shared repositories in an inconsistent state; this Skill provides a guided, validated workflow to make changes safely and transparently.

Core Features & Use Cases

  • Inspect current state: Display current repos, local path mappings, packs, instructions preview, and config overrides before any change.
  • Manage repositories and mappings: Add or remove repos, validate URL schemes, check duplicates, and map local directories without altering .local.yaml directly.
  • Manage packs and instructions: Add/remove packs using namespace/name validation and replace or trim long instructions with warnings.
  • Safe updates and validation: Preserve comments where possible, run Python-based validation, refresh the running session, revert on validation failure, and optionally commit changes if the space file sits in a git repo.
  • Use case: A developer adds a new repository to a team's shared space, maps a local checkout, validates the YAML, refreshes the space, and commits the change to the repo.

Quick Start

Use the CLI to run aroom space edit with the space name and describe the change you want to apply, for example adding a repo or updating instructions.

Frequently Asked Questions about space-edit

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

FAQPage Schema
How do I safely edit Anteroom space YAML files without breaking running CLI sessions?▼

To safely edit Anteroom space YAML files, use a guided CLI workflow that validates configuration changes, preserves comments, and automatically refreshes running sessions to maintain consistency. It reverts updates if validation fails.

How do I add a new repository and map a local directory to an existing space?▼

Add repositories and map local directories during interactive CLI sessions by providing the space name and desired changes. The tool validates URL schemes, checks for duplicates, and updates mappings without directly altering .local.yaml files.

Can I manage packs and update instructions in a space configuration file?▼

You can manage packs and update instructions within a space configuration file by using CLI commands that validate namespace names. The tool replaces or trims long instructions and provides warnings for potential issues.

Does editing space definitions work with git repositories for tracking changes?▼

Editing space definitions works with git repositories by offering optional git diff and commit steps after validation succeeds. This ensures configuration changes to repos, packs, and mappings are safely tracked in version control.

What happens if YAML validation fails when updating space config overrides?▼

If YAML validation fails when updating space config overrides, the tool automatically reverts the changes to preserve the previous valid state. This prevents leaving running sessions or shared repositories in an inconsistent condition.

Related Skills

Explore More Software Engineering Skills→
ByronWilliamsCPAByronWilliamsCPA

Code Quality Skill

Validate Git workflows with conventional commits and repository health checks.

Official
Intermediate
jamescjamesc

sync-skills

Synchronize modified skills and agents to a repository and create a pull request.

Community
Intermediate
elsa-workflowselsa-workflows
7.9k

speckit-git-commit

Stage and commit git changes after Spec Kit commands via YAML configuration.

Official
Basic
jmaglyjmagly
175

config-validator

Validate AIWG YAML/JSON configuration files for syntax, schema, and references.

Community
Intermediate