Official agent skill

Redirection

by MicrosoftDocs in MicrosoftDocs/semantic-kernel-docs

How to delete, rename, or move articles on Microsoft Learn while preserving Platform IDs, preventing broken links, and managing redirects.

OfficialMITAuto-check passedAI & LLM Engineering

Install Redirection

skills CLI

$ npx skills add MicrosoftDocs/semantic-kernel-docs --skill redirection -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install MicrosoftDocs/semantic-kernel-docs redirection --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/MicrosoftDocs/semantic-kernel-docs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/redirection .claude/skills/redirection && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "redirection" agent skill from https://github.com/MicrosoftDocs/semantic-kernel-docs/tree/main/.github/skills/redirection into .claude/skills/redirection/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "redirection", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/MicrosoftDocs/semantic-kernel-docs/tree/main/.github/skills/redirection

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add MicrosoftDocs/semantic-kernel-docs --skill redirection -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install MicrosoftDocs/semantic-kernel-docs redirection --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MicrosoftDocs/semantic-kernel-docs.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.github/skills/redirection .agents/skills/redirection && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "redirection" agent skill from https://github.com/MicrosoftDocs/semantic-kernel-docs/tree/main/.github/skills/redirection into .agents/skills/redirection/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "redirection", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add MicrosoftDocs/semantic-kernel-docs --skill redirection -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install MicrosoftDocs/semantic-kernel-docs redirection --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MicrosoftDocs/semantic-kernel-docs.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.github/skills/redirection .cursor/skills/redirection && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "redirection" agent skill from https://github.com/MicrosoftDocs/semantic-kernel-docs/tree/main/.github/skills/redirection into .cursor/skills/redirection/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "redirection", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/MicrosoftDocs/semantic-kernel-docs.git --path .github/skills/redirection

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add MicrosoftDocs/semantic-kernel-docs --skill redirection -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install MicrosoftDocs/semantic-kernel-docs redirection --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MicrosoftDocs/semantic-kernel-docs.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.github/skills/redirection .gemini/skills/redirection && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "redirection" agent skill from https://github.com/MicrosoftDocs/semantic-kernel-docs/tree/main/.github/skills/redirection into .gemini/skills/redirection/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "redirection", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install MicrosoftDocs/semantic-kernel-docs redirection

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add MicrosoftDocs/semantic-kernel-docs --skill redirection -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/MicrosoftDocs/semantic-kernel-docs.git skills-src && mkdir -p .github/skills && cp -r skills-src/.github/skills/redirection .github/skills/redirection && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "redirection" agent skill from https://github.com/MicrosoftDocs/semantic-kernel-docs/tree/main/.github/skills/redirection into .github/skills/redirection/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "redirection", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add MicrosoftDocs/semantic-kernel-docs --skill redirection -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install MicrosoftDocs/semantic-kernel-docs redirection --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MicrosoftDocs/semantic-kernel-docs.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.github/skills/redirection .opencode/skills/redirection && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "redirection" agent skill from https://github.com/MicrosoftDocs/semantic-kernel-docs/tree/main/.github/skills/redirection into .opencode/skills/redirection/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "redirection", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: redirection
GitHub stars: 264
Token cost: ~1.5k tokens
SKILL.md length: 722 words
Files: 1
Skills in repo: 7
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

How to delete, rename, or move articles on Microsoft Learn while preserving Platform IDs, preventing broken links, and managing redirects.

Works in 2 steps: Don't change content during file… → Eliminate duplicate content
AI & LLM Engineering work in your project
SKILL.md covers Purpose, When Redirection Is Required, The Redirection File and Platform ID, plus 5 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Redirection is an agent skill from MicrosoftDocs/semantic-kernel-docs, published by the product's own GitHub organization. How to delete, rename, or move articles on Microsoft Learn while preserving Platform IDs, preventing broken links, and managing redirects.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering. The repository describes itself as: Semantic Kernel (SK) is a lightweight SDK enabling integration of AI Large Language Models (LLMs) with conventional programming languages. The licence is MIT.

When your agent uses it

AI & LLM Engineering work in your project

Example prompts

“/redirection”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

Don't change content during file operations. The Platform ID relies on
Eliminate duplicate content

What it can do on your machine

Read from SKILL.md and the folder at commit 6997e10. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are json, yaml and powershell).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- learn.microsoft.com
- bing.com
- search.google.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Redirection loads about 1.5k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 722 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~38
When it runs · the whole SKILL.md, loaded when a task matches: ~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MicrosoftDocs/semantic-kernel-docs at commit 6997e10, republished under its MIT licence (© MicrosoftDocs). 722 words, ~1,494 tokens.

Download SKILL.mdSave it as .claude/skills/redirection/SKILL.md (or your agent's skills folder).

name: redirection
description: How to delete, rename, or move articles on Microsoft Learn while preserving Platform IDs, preventing broken links, and managing redirects.

Skill: Redirection on Microsoft Learn

Purpose

This skill describes how to properly redirect content when articles are deleted, renamed, or moved on Microsoft Learn. Proper redirection prevents broken links, avoids 404 errors, and ensures the Platform ID algorithm correctly associates the new location with the original content.

When Redirection Is Required

Redirection is always required for:

Renaming files (not just article titles)
Moving a file to a different folder or directory
Migrating content to a new repository
Merging files

These operations are treated as "remove and replace" by the platform, not as in-place updates.

The Redirection File

Redirects are managed in a JSON file at the repo root, typically named .openpublishing.redirection.json. Each entry maps an old source path to a new target URL.

Entry Format

json

{
  "redirections": [
    {
      "source_path_from_root": "/articles/ai-services/content-safety/concepts/custom-categories-rapid.md",
      "redirect_url": "/azure/ai-services/content-safety/concepts/custom-categories",
      "redirect_document_id": true
    }
  ]
}

Properties

Property	Required	Description
`source_path_from_root`	Yes	Absolute path to the old file in the repo. Must start with `/`.
`redirect_url`	Yes	Target URL — can be a relative path, a site-relative path on Microsoft Learn, or an external URL.
`redirect_document_id`	No	Set to `true` to transfer the document ID (and reporting data like page views and rankings) from the old article to the target. Defaults to `false` if omitted.

Platform ID

The Platform ID is a unique identifier for Learn documents, designed to replace the Document ID system. Unlike Document ID, the Platform ID is automatically generated based on content similarity and URL redirection relationships.

Best Practices for Platform ID Continuity

Don't change content during file operations. The Platform ID relies on a 90% content similarity threshold. If similarity drops below 90%, the platform treats the documents as distinct entities with different IDs. Rename or move first, then make content changes in a separate PR.
Eliminate duplicate content:
- Same repo: Delete the original and set up redirection in the same PR.
- Cross-repo migration: Publish in the target repo and create the redirect in a first PR, then delete the old document within 24 hours in a second PR. After 24 hours the Platform ID is finalized.

[!WARNING] Not following redirection policies risks losing historical BI data. The Platform ID is also used by recommendations and search services — changes to the ID can make content inaccessible or degrade search results.

Redirection Workflows

Deprecating Content (Keep Published, Remove from Search)

Add the ROBOTS: NOINDEX metadata as the last entry in the article's YAML frontmatter, then republish:

yaml

ROBOTS: NOINDEX

This tells search engines not to index the page while still allowing crawlers to follow links on it to other pages.

Deleting an Article

Ensure you're listed as author in the article's metadata (update if not).
Delete the article file.
Add a redirect entry in .openpublishing.redirection.json pointing to an appropriate replacement page.
Include both the deletion and the redirect in the same PR.

Show full SKILL.md (266 more words)Show less

Renaming a File

Create a copy of the article with the new file name.
Delete the old file.
Add a redirect from the old path to the new path in the redirection file.
Update the TOC entry for the article.

Moving a File

Same process as renaming — create the file in the new location, delete the original, add the redirect, and update the TOC.

Updating Cross-References

Don't rely on redirects alone for internal links. After any file operation, scan for and update cross-references:

powershell

# Find all files linking to the old article
Get-ChildItem -Recurse -Include *.md |
    Select-String '<old-article-name>' |
    Group-Object Path |
    Select-Object Name

Update or remove these cross-links in the same or a follow-up PR.

Post-Merge Checklist

After your PR merges, complete these steps:

Step	Details
Test redirects in staging	Verify the old URL redirects to the correct target before signing off
Update FWLinks	Check the FWLink tool for any links pointing to the old article and update them
Manage inbound links	Identify high-traffic non-Microsoft inbound links (blogs, forums) and coordinate updates if possible
Remove search cache (rare)	Only if content must be removed urgently for legal or severe customer issues — use Bing and Google removal tools
Review old redirects	Periodically review and clean up redirect entries based on your org's retention policy
Check Platform ID Dashboard	Verify that file URL changes follow best practices

Relationship with TOC and Breadcrumbs

When you delete, rename, or move an article, you must also update the corresponding TOC entry to reflect the new file path. If the move changes the article's URL structure, verify that the breadcrumb tocHref mappings still apply correctly.

Reference

Files

Just SKILL.md in .github/skills/redirection of MicrosoftDocs/semantic-kernel-docs.

Open the folder on GitHubat commit 6997e10

Compare with similar skills

Redirection next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Redirection compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Redirection this skillMicrosoftDocs/semantic-kernel-docs	264	—	~1.5k	Automated safety check: Pass	MIT	today
Agent BuildershareAI-lab/learn-claude-code	78k	6 repos	~1.2k	Automated safety check: Pass	MIT	9 days ago
Add Uint Supportpytorch/pytorch	104k	2 repos	~2.3k	Automated safety check: Pass	Custom licence	today
Peft Fine TuningOrchestra-Research/AI-Research-SKILLs	13k	9 repos	~3.1k	Automated safety check: Pass	MIT	3 mo ago
Segment Anything Model GuideOrchestra-Research/AI-Research-SKILLs	13k	9 repos	~3.3k	Automated safety check: Pass	MIT	3 mo ago
1passwordtrpc-group/trpc-agent-go	1.8k	15 repos	~656	Automated safety check: Pass	Apache-2.0	today

Similar skills

Agent Builder
shareAI-lab/learn-claude-code
Design and build AI agents for any domain. An agent skill from shareAI-lab/learn-claude-code.
78k GitHub starsUsed in 6 repos~1.2k tokens
AI & LLM EngineeringAuto-check passed
Add Uint Support
pytorch/pytorch
Add unsigned integer (uint) type support to PyTorch operators by updating ATDISPATCH macros.
104k GitHub starsUsed in 2 repos~2.3k tokens
AI & LLM EngineeringAuto-check passed
Peft Fine Tuning
Orchestra-Research/AI-Research-SKILLs
Parameter-efficient fine-tuning for LLMs using LoRA, QLoRA, and 25+ methods.
13k GitHub starsUsed in 9 repos~3.1k tokens
AI & LLM EngineeringAuto-check passed
Segment Anything Model Guide
Orchestra-Research/AI-Research-SKILLs
Guide to using Meta's Segment Anything Model for zero-shot image segmentation with point, box or mask prompts, or automatic mask generation.
13k GitHub starsUsed in 9 repos~3.3k tokens
AI & LLM EngineeringAuto-check passed
1password
trpc-group/trpc-agent-go
Set up and use 1Password CLI (op). An agent skill from trpc-group/trpc-agent-go.
1.8k GitHub starsUsed in 15 repos~656 tokens
AI & LLM EngineeringAuto-check passed
Chroma Vector Database
Orchestra-Research/AI-Research-SKILLs
Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.
13k GitHub starsUsed in 8 repos~2.3k tokens
AI & LLM EngineeringAuto-check passed

Questions about Redirection

What does Redirection do?

How to delete, rename, or move articles on Microsoft Learn while preserving Platform IDs, preventing broken links, and managing redirects. Redirection is an agent skill from MicrosoftDocs/semantic-kernel-docs, published by the product's own GitHub organization. How to delete, rename, or move articles on Microsoft Learn while preserving Platform IDs, preventing broken links, and managing redirects.

When should I use Redirection?

Redirection fits situations like: AI & LLM Engineering work in your project.

How do I install Redirection in Claude Code?

Run `npx skills add MicrosoftDocs/semantic-kernel-docs --skill redirection -a claude-code`. Or copy the skill folder (.github/skills/redirection in MicrosoftDocs/semantic-kernel-docs) into .claude/skills/redirection in your project. Claude Code loads it when a task matches its description.

How do I install Redirection in Codex?

Run `npx skills add MicrosoftDocs/semantic-kernel-docs --skill redirection -a codex`. Or copy the skill folder (.github/skills/redirection in MicrosoftDocs/semantic-kernel-docs) into .agents/skills/redirection in your project. Codex loads it when a task matches its description.

Can I use Redirection in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MicrosoftDocs/semantic-kernel-docs --skill redirection -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/redirection, .gemini/skills/redirection, .github/skills/redirection and .opencode/skills/redirection in your project.

What does Redirection need to run?

SKILL.md names no scripts, command-line tools or credentials: Redirection is instructions for the agent only.

Does Redirection access the network?

SKILL.md names 3 domains. As links in the text: learn.microsoft.com, bing.com and search.google.com. This is read from the text; nothing was executed.

Is Redirection safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Redirection use?

Redirection is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Redirection use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Redirection?

Skills that share tags, products or a category with Redirection: Agent Builder (shareAI-lab/learn-claude-code, 78k stars), Add Uint Support (pytorch/pytorch, 104k stars), Peft Fine Tuning (Orchestra-Research/AI-Research-SKILLs, 13k stars) and Segment Anything Model Guide (Orchestra-Research/AI-Research-SKILLs, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Redirection?

MicrosoftDocs (a GitHub organization, an official publisher) maintains it in MicrosoftDocs/semantic-kernel-docs, which has 264 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

Source: MicrosoftDocs/semantic-kernel-docs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Redirection

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Skill: Redirection on Microsoft Learn

Purpose

When Redirection Is Required

The Redirection File

Entry Format

Properties

Platform ID

Best Practices for Platform ID Continuity

Redirection Workflows

Deprecating Content (Keep Published, Remove from Search)

Deleting an Article

Renaming a File

Moving a File

Updating Cross-References

Post-Merge Checklist

Relationship with TOC and Breadcrumbs

Reference

Files

Compare with similar skills

Similar skills

More from MicrosoftDocs/semantic-kernel-docs

Related

Questions about Redirection