CtrlK
BlogDocsLog inGet started
Tessl Logo

find-reviewable-pr

Finds open PRs in the dotnet/maui and dotnet/docs-maui repositories that are good candidates for review, prioritizing by milestone, priority labels, partner/community status.

62

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/find-reviewable-pr/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 body with executable commands, a complete parameter table, and a well-sequenced workflow including explicit failure handling. The main costs are token-efficiency — the category taxonomy is repeated three times and Quick Start examples duplicate the parameter table — and a script path that does not match the actual bundle layout.

Suggestions

Collapse the triple category listing: keep the numbered Priority Categories list, and reduce Step 3 and Tips to short bullets that only add new information (emoji, table columns, review guidance) without restating category definitions.

Trim the Quick Start block to 3-4 representative invocations (default, -Category all, one filter, -OutputFormat json) since the parameter table already documents every category and platform value.

Use the bundle-relative script path 'scripts/query-reviewable-prs.ps1' in the body so the reference matches the actual bundle structure.

DimensionReasoningScore

Conciseness

Mostly efficient — a tight parameter table and executable commands — but the category taxonomy is explained three times (Priority Categories list, the Step 3 emoji list, and the Tips section: 'P/0 PRs should always be reviewed first', 'Approved PRs are ready to merge', 'Milestoned PRs have deadlines'), and the 11 Quick Start commands largely duplicate what the parameter table already specifies. Not a 2 because nothing explains concepts Claude already knows; not a 4 because the triple repetition is more than minor trimmable over-explanation.

3 / 5

Actionability

Fully executable, copy-paste-ready commands: 'pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Category milestoned', plus a complete parameter table with values ('-Platform android, ios, windows, maccatalyst, all'), defaults, and ranges ('-Limit 1-100, default 100'). Specific examples cover the common cases; matches the 5 anchor exactly.

5 / 5

Workflow Clarity

Clear three-step sequence (run script → check warnings → present all categories) with an explicit failure checkpoint: 'If the script fails... STOP - Do not attempt fallback queries... Report the error... Suggest retry', plus a concrete warning template to surface missing read:project scope. Not a 5 because there is no explicit check for empty results or guidance on verifying pwsh availability, leaving minor validation gaps.

4 / 5

Progressive Disclosure

Bundle structure is one script (scripts/query-reviewable-prs.ps1) referenced consistently from the body, and the body content (parameters, workflow, categories) is appropriately placed in SKILL.md rather than inlined from elsewhere. Not a 5 because every reference uses the repo path '.github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1' instead of the actual bundle-relative 'scripts/query-reviewable-prs.ps1' — a minor organization gap versus the actual bundle layout; not a 3 because structure and signaling are otherwise good.

4 / 5

Total

16

/

20

Passed

Description

70%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, specific description that pins the domain to two named repositories with concrete prioritization criteria, making it highly distinctive. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which caps completeness, and it misses the spelled-out 'pull requests' synonym.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user asks to find a PR to review, wants milestoned/partner/community PRs, or mentions the review queue in dotnet/maui or dotnet/docs-maui.'

Include the spelled-out synonym 'pull requests' alongside 'PRs' so both phrasings trigger the skill.

Optionally name one more concrete action (e.g., 'presents results by category' or 'filters by platform') to round out capability coverage.

DimensionReasoningScore

Specificity

Quotes: 'Finds open PRs in the dotnet/maui and dotnet/docs-maui repositories that are good candidates for review, prioritizing by milestone, priority labels, partner/community status.' It names a concrete action (find open PRs), specific repositories, and concrete prioritization criteria. Not a 5 because it lists only one action verb with its criteria rather than multiple distinct concrete actions; not a 3 because the scope and criteria are far more concrete than 'names domain and 1-2 concrete actions'.

4 / 5

Completeness

The 'what' is clear (finds and prioritizes reviewable open PRs in two named repos), but there is no 'Use when...' or equivalent trigger clause — the 'when' is only weakly implied by 'good candidates for review'. Per judging guidelines, a missing explicit trigger clause caps completeness at 3. Not a 4 because 'when' is absent, not merely less explicit.

3 / 5

Trigger Term Quality

Natural terms present: 'open PRs', 'good candidates for review', 'milestone', 'priority labels', 'partner/community'. These match what a maintainer would say ('find a PR to review'). Not a 5 because the spelled-out 'pull requests' synonym and phrases like 'review queue' or 'needs review' are missing; not a 3 because keyword coverage is good, not just some relevant keywords.

4 / 5

Distinctiveness Conflict Risk

Names the exact repositories (dotnet/maui, dotnet/docs-maui) and a repo-specific workflow (milestone/priority-label prioritization, partner/community status), giving it a clear niche with minimal overlap risk against generic PR-review skills. Clearly matches the 5 anchor; nothing pushes toward 4 since no generic phrasing remains.

5 / 5

Total

16

/

20

Passed

Validation

100%

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/maui
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.