# Range Config

> Create, edit, and validate Ludus range configuration YAML including VM definitions, domains, networking, router settings, testing behavior, and role configuration. Use when users need help authoring or reviewing `ludus` range config files.

- **Type:** Skill
- **Install:** `agentstack add skill-badsectorlabs-ludus-skills-range-config`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [badsectorlabs](https://agentstack.voostack.com/s/badsectorlabs)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [badsectorlabs](https://github.com/badsectorlabs)
- **Source:** https://github.com/badsectorlabs/ludus-skills/tree/main/skills/range-config
- **Website:** https://docs.ludus.cloud/docs/using-ludus/mcp

## Install

```sh
agentstack add skill-badsectorlabs-ludus-skills-range-config
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Ludus Range Configuration

Use this skill to build safe, valid Ludus YAML configurations and explain tradeoffs in topology, networking, and role design.

## Key Principles

1. **Always suggest the YAML schema validation header** at the top of configs:
   ```yaml
   # yaml-language-server: $schema=https://docs.ludus.cloud/schemas/range-config.json
   ```

2. **Use `{{ range_id }}` template strings** in vm_name and hostname fields. This resolves to the user's range ID (e.g., "JS").

3. **Windows hostnames are limited to 15 characters** due to NETBIOS.

4. **VLANs must be 2-255** and become the third octet of the VM's IP (e.g., vlan 10 = 10.X.10.Y).

5. **ip_last_octet must be unique within a VLAN**.

6. **Set `linux: true`** for Linux VMs, **`windows:` key** for Windows VMs, **`macOS: true`** for macOS VMs.

7. **Domain roles** are: `primary-dc`, `alt-dc`, or `member`.

8. **role_vars must be a dictionary** - do not use hyphens to prefix variables.

9. **Roles must exist on the server** before deploy — verify installed roles and add any that are missing.

## Workflow

1. Clarify the target environment and intended use case.
2. Define required VMs and roles.
3. Verify that required templates are available on the server.
4. Build or revise YAML in small, valid increments.
5. Propose network rules and testing behavior appropriate for the scenario.
6. Verify that required Ansible roles/collections are installed; recommend any that need to be added.
7. Validate structure and values against the schema reference.

## References

- Use `references/schema.md` for full schema details, valid values, defaults, and complete examples.
- Use `https://docs.ludus.cloud/docs/configuration` for official configuration guidance.
- Use `https://docs.ludus.cloud/schemas/range-config.json` for schema-backed validation.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [badsectorlabs](https://github.com/badsectorlabs)
- **Source:** [badsectorlabs/ludus-skills](https://github.com/badsectorlabs/ludus-skills)
- **License:** MIT
- **Homepage:** https://docs.ludus.cloud/docs/using-ludus/mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-badsectorlabs-ludus-skills-range-config
- Seller: https://agentstack.voostack.com/s/badsectorlabs
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.