shipping

Use this skill when contributing changes to the FAST monorepo — creating pull requests, generating change files, writing PR descriptions, and keeping documentation up to date.

Quality

87%

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

82%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.

A highly actionable, well-structured shipping guide with concrete commands, validation checkpoints, and clear external references. Its main weaknesses are a few over-explained rationale passages and a topical rather than linear workflow organization.

Suggestions

Trim the rationale paragraphs (e.g., the two-paragraph explanation of why change-file comments are sentence-style) to one line each, since the rule itself is already clear.

Consider promoting the Acceptance checklist and change-file workflow into a single numbered 'Shipping workflow' sequence so the validation checkpoints read as one coherent process with explicit fix-and-retry loops.

Move the detailed per-section PR template fill-out guidance into a referenced file (e.g., a PR_GUIDE.md) so the body stays a lean overview.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with concrete commands, tables, and code blocks, but contains a few rationale/over-explanation passages (e.g., the multi-paragraph beachball comment justification) that could be trimmed.	4 / 5
Actionability	Fully executable guidance throughout — copy-paste ready commands (npm run change, build, test, checkchange, format:check, prebuild), a change-type table, conventional-commit examples, and a migration doc template cover the common cases.	5 / 5
Workflow Clarity	The Acceptance checklist gives an explicit validation sequence with feedback ('test fails' → write test first; build/test/format/checkchange before finishing), but the body is organized as a topical reference rather than one tightly-sequenced workflow with error-recovery loops throughout.	4 / 5
Progressive Disclosure	Well-sectioned with clearly signaled one-level-deep references to repo files (PR template, CONTRIBUTING.md, beachball.config.js, etc.); no bundle files exist, and some inlined PR/change-file detail could arguably live in separate files.	4 / 5
	Total	17 / 20 Passed

Description

92%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 strong, well-scoped description that names concrete actions, includes an explicit 'Use when' trigger, and is tightly bound to the FAST shipping domain. Only minor synonym coverage is lacking in trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'creating pull requests, generating change files, writing PR descriptions, and keeping documentation up to date' — comprehensively covering the FAST shipping workflow.	5 / 5
Completeness	Explicitly answers both 'what' (PRs, change files, PR descriptions, docs) and 'when' ('Use this skill when contributing changes to the FAST monorepo') with a concrete trigger phrase.	5 / 5
Trigger Term Quality	Includes natural terms a FAST contributor would say ('pull requests', 'change files', 'PR descriptions', 'contributing changes') with good coverage, though a few synonyms or variations are missing.	4 / 5
Distinctiveness Conflict Risk	Scoped to the 'FAST monorepo' with distinct shipping-specific triggers, giving it a clear niche with minimal conflict risk against other skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 1 missing, 1 deeper-than-1-level, 10 suspicious	Warning

	Total	15 / 16 Passed

Repository: microsoft/fast
Path: .github/skills/shipping/SKILL.md
Commit: a909e87

Reviewed: about 18 hours ago

Table of Contents

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.