CtrlK
BlogDocsLog inGet started
Tessl Logo

fluid-pr-guide

Use when composing, writing, drafting, or reviewing a PR title, PR description, or PR body in Fluid Framework — provides title style, body template, and section guidance.

72

Quality

90%

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

90%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 tight, highly actionable skill body: concrete title conventions with real examples, an explicit CI validation gate, and specific per-section body rules with no padding. The residual gaps are minor — an unspecified wiki-link URL and external references that rely on repo context rather than bundled files.

DimensionReasoningScore

Conciseness

The 48-line body is lean: two title formats with syntax blocks, real example titles, a one-line hard prohibition ("Never use the `[bump]` prefix — that is reserved for automated bot PRs"), and tight per-section rules. Every token carries repo-specific information Claude could not know, matching anchor 5's lean-and-efficient ideal.

5 / 5

Actionability

Guidance is fully executable: title templates with type/scope lists, eight copy-adaptable real example titles across both styles, an explicit CI failure callout naming `.github/workflows/pr-validation.yml`, a concrete deletion rule for template sections, and the `AB#<item-id>` work-item format. Anchor 5's "specific examples cover the common cases" is met; the only minor omission is the unspecified wiki-link URL in Reviewer Guidance.

5 / 5

Workflow Clarity

The sequence is clear — pick a title style by repo ("Use Option A for build-tools PRs... For other PRs, use either style"), apply title rules, then build the body from the repo template and delete non-applicable sections — with an explicit CI checkpoint ("Leaving it in will cause the .github/workflows/pr-validation.yml check to fail"). It falls short of anchor 5 because the ordering is implied by section structure rather than stated, and there is no fix-and-retry loop if the CI check fails.

4 / 5

Progressive Disclosure

The skill is compact with no bundle files, and content is appropriately placed in well-organized sections (title styles → body template → section notes), matching the simple-skill case. It is anchor 4 rather than 5 because the two external references (`../../../build-tools/README.md`, `.github/pull_request_template.md`) point into the repo rather than a discoverable bundle, and "Link the wiki page" leaves a navigation target unspecified.

4 / 5

Total

18

/

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 strong description: it explicitly states both what the skill provides (title style, body template, section guidance) and when to use it, with natural trigger phrasing and a clear Fluid Framework niche. The only gaps are the missing "pull request" synonym and deliverable-level rather than action-level specificity.

Suggestions

Add the spelled-out synonym "pull request" (e.g., "PR (pull request) title/description") so users who type the full phrase still match the trigger.

Enumerate the concrete actions slightly more precisely, e.g., "formats PR titles with Conventional Commits or plain imperative style and fills in the PR body template section by section", to move from deliverable categories to distinct concrete actions.

Consider naming the distinguishing artifacts (changelog-driven title conventions, the CI preamble check) to further sharpen distinctiveness against generic commit-message or PR-writing skills.

DimensionReasoningScore

Specificity

"provides title style, body template, and section guidance" names three concrete deliverables and "composing, writing, drafting, or reviewing a PR title, PR description, or PR body" names concrete activities. It lists several specific capabilities but presents them as deliverable categories rather than an enumerated set of concrete actions, so it sits at anchor 4 rather than the comprehensive coverage of anchor 5.

4 / 5

Completeness

Both parts are explicit: an explicit "Use when..." clause with concrete trigger phrases ("composing, writing, drafting, or reviewing a PR title, PR description, or PR body in Fluid Framework") and an explicit what ("provides title style, body template, and section guidance"). This matches anchor 5's clear and explicit what-and-when with concrete triggers; it exceeds anchor 4 because the when-clause is already specific rather than merely present.

5 / 5

Trigger Term Quality

Natural user phrasing is well covered — "PR title", "PR description", "PR body", "composing", "writing", "drafting", "reviewing" — matching anchor 4's good coverage. It is not anchor 5 because the spelled-out synonym "pull request" is absent, leaving a common variation users would say uncovered.

4 / 5

Distinctiveness Conflict Risk

"in Fluid Framework" carves out a clear niche and the triggers (PR title/description/body composition) are distinct from adjacent skills like commit-message writing, giving minimal conflict risk per anchor 5. It is not a lower anchor because the domain qualifier prevents the generic overlap that anchors 2–3 describe.

5 / 5

Total

18

/

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 suspicious

Warning

Total

15

/

16

Passed

Repository
microsoft/FluidFramework
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.