# Sort Redirects

> Sort Redirects is an Agent Skill for documents published in the dotnet/docs repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

- Skill name: `sort-redirects`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/dotnet/docs/blob/HEAD/.github/skills/sort-redirects/SKILL.md
- Repository: dotnet/docs (4,733 GitHub stars when collected)

## SKILL.md

# 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 `/`).

---

Source: https://www.openparable.com/skill/documents/sort-redirects (OpenParable). Cite the canonical URL above.