Tessl • The management layer for AI agent skills

SkillPublic

redirect-article

Deletes a markdown article and creates a redirect entry pointing to a different article. Use when consolidating articles, renaming or moving content, removing outdated documentation, or reorganizing the docs structure while preserving existing URLs.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

76%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Highly actionable and well-structured content with an externalized script, concrete commands, and lookup tables. The main gap is the absence of validation steps for a destructive workflow, plus some redundant repetition of the script mandate and a lookup table that could live in a reference file.

Suggestions

Add explicit validation checkpoints to the workflow: after running create-redirect-entry.ps1, verify the entry exists and the JSON parses (e.g., re-run a read of the file or a json validity check), and after link updates, confirm no remaining references to the old article path.

State the script mandate once (a single bold "ALWAYS use the script; never hand-edit the JSON" note) and consolidate the link-update guidance into one place instead of listing it both in the Steps sequence and again as section 2.

Move the 18-row product-area redirection table into a references/ file (e.g., references/redirection-files.md) and keep only the file-selection rule plus a pointer in SKILL.md.

Dimension	Reasoning	Score
Conciseness	The body is lean with tables and a copy-paste example instead of concept explanations, but the script mandate is repeated three times ("DO NOT manually edit", "REQUIRED: Use the script", "ALWAYS use this script") and link updating is listed both in the Steps sequence and again as section 2, so it sits just above the midpoint between anchors 3 and 4.	4 / 5
Actionability	Fully executable guidance throughout: a verified script path (./scripts/create-redirect-entry.ps1), a parameter table, a copy-paste-ready PowerShell invocation, the exact JSON entry format, concrete search globs (*/.md, */.yml), and an 18-row redirection-file lookup table covering the common cases.	5 / 5
Workflow Clarity	The delete → create redirect → update links sequence is clearly ordered, but this is a destructive/batch operation (file deletion plus bulk link edits) with no validation checkpoints — nothing verifies the redirect entry landed correctly or that no stale links remain — which caps workflow clarity at 3 per the rubric guideline.	3 / 5
Progressive Disclosure	Good structure with the script properly externalized (location given, one level deep, path verified to exist) and no nested references; the 18-row redirection-file table is borderline reference material inlined in SKILL.md, a minor organization gap.	4 / 5
	Total	16 / 20 Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-crafted description that clearly states both the capability and four explicit usage triggers in a docs-repo niche. The only weakness is trigger-term breadth — a few natural synonyms (delete, .md, broken links) would round out coverage.

Dimension	Reasoning	Score
Specificity	"Deletes a markdown article and creates a redirect entry pointing to a different article" names the domain with two concrete actions, but omits capabilities the skill covers (e.g., updating internal links), leaving minor gaps in coverage rather than the comprehensive multi-action coverage of a 5.	4 / 5
Completeness	It explicitly answers both what ("Deletes a markdown article and creates a redirect entry pointing to a different article") and when ("Use when consolidating articles, renaming or moving content, removing outdated documentation, or reorganizing the docs structure while preserving existing URLs") with four concrete trigger phrases.	5 / 5
Trigger Term Quality	"consolidating articles", "renaming or moving content", "removing outdated documentation", "reorganizing the docs structure" are natural user phrasings, but common variations like "delete an article" triggers, ".md", or "broken links" synonyms are missing, so coverage is good but not comprehensive.	4 / 5
Distinctiveness Conflict Risk	"markdown article", "redirect entry", and "preserving existing URLs" carve out a clear docs-repository niche with distinct triggers and minimal overlap with other skills; voice is properly third-person.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: dotnet/docs
Path: .github/skills/redirect-article/SKILL.md
Revision: bcbe167

Reviewed: 1 month ago

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

redirect-article

Table of Contents

Is this your skill?