CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

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-sequenced shipping workflow that is specific to this monorepo and lean throughout. The strongest improvement levers are an explicit recovery loop for failed verification checks and tightening the rationale prose and heading hierarchy.

DimensionReasoningScore

Conciseness

The body is dominated by lean, project-specific instruction (commands, tables, checkbox rules) with little padding. The main exception is the three-sentence rationale under 'Change comments' explaining why sentence-style reads cleanly, which could be trimmed to one line — matching anchor 4's 'minor instances of over-explanation'. It never drifts into anchor 2-3 territory of explaining concepts Claude already knows.

4 / 5

Actionability

Nearly every section gives copy-paste-ready commands (`npm run change`, `npm run checkchange`, `npm run change -- --branch origin/{branch-name}`, `npm run prebuild -w sites/website`), a change-type decision table, per-checkbox rules grounded in observable terminal output, and a complete migration-doc format template. This matches anchor 5's fully executable, common-case-covering guidance.

5 / 5

Workflow Clarity

The sequence is well-ordered (test-first for bug fixes with 'ensure that it is failing', pre-finish verification of build/test/format:check/checkchange, then change files and doc regeneration) with most checkpoints present. It falls short of anchor 5 because there is no explicit fix-and-retry feedback loop when a check fails (e.g., what to do when `checkchange` fails), though it comfortably exceeds anchor 3's implicit checkpoints.

4 / 5

Progressive Disclosure

All external references are repo files (PR template, CONTRIBUTING.md, beachball.config.js) that are one level deep and each annotated with its purpose, and the ~210-line body is organized into clearly headed sections. Minor gaps keep it at anchor 4 rather than 5: '## Key references' is oddly nested under '# Guardrails', and the ~50 lines of per-section PR-template instructions could arguably live in a reference file since the template itself is linked as the source of truth.

4 / 5

Total

17

/

20

Passed

Description

78%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 answers both what and when with mostly concrete actions. Its main weakness is a slightly generic trigger surface: one broad 'when' clause and a vague 'keeping documentation up to date' action, with a few natural synonyms (ship, commit message) missing.

DimensionReasoningScore

Specificity

The description names several concrete actions ('creating pull requests, generating change files, writing PR descriptions') but 'keeping documentation up to date' is generic and related work (commit conventions, breaking-change migrations) is uncovered. This matches anchor 4 (several specific actions, minor gaps) rather than anchor 5's comprehensive coverage, and clearly exceeds anchor 3's 1-2 concrete actions.

4 / 5

Completeness

Both parts are explicit: the 'what' is the enumerated action list and the 'when' is 'when contributing changes to the FAST monorepo'. However the 'when' is a single broad clause rather than concrete trigger phrases (compare anchor 5's 'when working with PDF files or when the user mentions PDFs, forms, or document extraction'), so anchor 4 fits best; it is well above anchor 3 where 'when' is only weakly implied.

4 / 5

Trigger Term Quality

Natural trigger terms include 'pull requests', 'PR descriptions', 'change files', 'contributing changes', and 'FAST monorepo' — phrases a user would naturally say. A few common variants are missing (e.g., 'ship/shipping', 'commit message', 'release'), which fits anchor 4's 'good keyword coverage; a few natural terms missing' rather than anchor 5's synonym-and-extension completeness.

4 / 5

Distinctiveness Conflict Risk

Scoping to 'the FAST monorepo' plus repo-specific artifacts (change files, beachball-style versioning) carves a clear niche with distinct triggers and minimal conflict risk with general skills. This matches anchor 5 and is clearly stronger than anchor 4's 'minor overlap risk with closely related skills'.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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

Reviewed

Table of Contents

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.