Lean body using tables, terse rule IDs (FDOC-001..005), and copy-paste commands; assumes Claude's competence and avoids explaining TypeSpec or OpenAPI basics, with only minor redundancy between the Rules table and the referenced detail file.

Provides executable commands ('npx tsp format ...', 'npx tsp compile .'), a concrete rule table with remediation criteria, and a copy-paste output-format table — fully actionable guidance rather than abstract direction.

A numbered 7-step workflow with explicit post-edit verification checkpoints (format → compile → 'Verify that the files under openapi3/{version}/ are updated'), plus a Conservative Change Policy feedback gate before fixing.

SKILL.md is a concise overview that signals a single one-level-deep reference — [route-documentation-rules.md](references/route-documentation-rules.md), a real bundle file — keeping detail out of the main file with clear navigation.

Lists multiple concrete actions — 'Validates that all TypeSpec route operations ... have documentation comments and @summary decorators with correct voice' — naming exact checks rather than vague capability claims.

Explicitly answers both what (validates doc comments and @summary with correct voice) and when ('USE FOR: reviewing or authoring routes.tsp files ...'), with a clear exclusion clause, satisfying the explicit-trigger requirement.

Covers the natural terms a Foundry contributor would say — 'routes.tsp files', 'documentation comments', '@summary decorators', 'TypeSpec route operations' — plus explicit USE FOR / DO NOT USE FOR triggers.

Narrow niche scoped to a single path glob and a DO NOT USE FOR list (client.tsp, models.tsp, openapi3/), making conflict with other skills very unlikely.