# Sort Redirects

> Sorts redirect entries in Open Publishing redirection JSON files alphabetically by path. Use after adding redirects or when the file becomes unsorted.

- Skill: `dotnet/sort-redirects` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dotnet/sort-redirects`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dotnet/sort-redirects/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: .NET (Microsoft) (https://skillmd.com/u/dotnet)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dotnet/sort-redirects

---


# Sort Redirects

Sort redirect entries in Open Publishing redirection JSON files alphabetically by path. This ensures consistency and makes the redirect files easier to maintain.

## When to Use

- After adding redirect entries to a JSON file
- When the redirect file has become unsorted
- After merging branches that may have caused unsorted entries

## Steps

1. **Identify the redirection file** - Determine which `.openpublishing.redirection.*.json` file needs sorting.
2. **Run the sort script** - Use the `sort-redirects.ps1` script with the file path.

## Scripts

### sort-redirects.ps1

Sorts all entries in the JSON file alphabetically by path (ignoring leading `/` for `source_path_from_root`). Handles both `source_path_from_root` and `source_path` properties.

Location (relative to this skill file): `./scripts/sort-redirects.ps1`

| Parameter | Required | Description |
|-----------|----------|-------------|
| `RedirectionFile` | Yes | The path to a redirection JSON file (e.g., `.openpublishing.redirection.csharp.json`) |

**Example:**

```powershell
.\scripts\sort-redirects.ps1 -RedirectionFile ".openpublishing.redirection.csharp.json"
```

## Important Notes

- The script preserves all existing redirect entries, only changing their order.
- Sorting is case-sensitive and alphabetical by the normalized path (without leading `/`).