CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-pr

Pull Request creator skill with automated template, testing checklist, security audit checklist, and release notes generator.

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/git-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.

The body is a well-structured, highly actionable workflow: concrete git/dotnet/gh commands at every step, a complete PR template, and a validation gate before PR creation. Its main gaps are minor — a missing feedback loop for failed validation and a template that could be split into a reference file.

Suggestions

Add a short feedback loop after Step 2, e.g. 'If tests fail or the build has warnings, fix before proceeding — do not create the PR with a red build.'

Consider moving the full PR template and release-notes category rules into references/template.md, keeping SKILL.md as a lean workflow overview that points to them.

DimensionReasoningScore

Conciseness

The body is efficient: commands are given bare with no explanation of concepts Claude already knows, and the inlined template is the deliverable rather than padding. A few minor items could be trimmed (the 'Infrastructure & DB' checkbox line, the aside about saving to .github/PULL_REQUEST_TEMPLATE.md), keeping it at 'minor instances of over-explanation that could be trimmed' rather than fully lean.

4 / 5

Actionability

Every step has concrete, executable commands (git log main..HEAD --oneline, dotnet test --configuration Release, gh pr create with --title and --body-file) plus a copy-paste-ready template and a worked title example (feat(itau): add webhooks signature validation). Not a 5: the gh command hardcodes a sample title, and how pr_description.md is produced is described rather than shown.

4 / 5

Workflow Clarity

The four-step sequence is clearly ordered with a prerequisite validation gate (all tests pass, clean build) before PR creation, plus testing and security checklists. Not a 5: there is no feedback loop instructing what to do when tests or the build fail. PR creation is not destructive or batch, so the cap at 3 does not apply.

4 / 5

Progressive Disclosure

No bundle files exist and the ~100-line body is well organized into three clearly headed sections, which is good structure for a skill this size. Not a 5: the body exceeds the under-50-line simple-skill case, and the 40-line template plus release-notes rules are plausible candidates for a references/ split to slim the always-loaded overview.

4 / 5

Total

16

/

20

Passed

Description

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

The description does a solid job naming concrete capabilities but completely omits any usage trigger, which caps its completeness and limits its trigger-term coverage. It identifies a reasonably distinct niche, though the missing 'when' guidance leaves some routing ambiguity.

Suggestions

Append an explicit trigger clause, e.g. 'Use when creating, drafting, or preparing pull requests, or when the user mentions PRs or release notes.'

Include the common abbreviation and variants users actually say — 'PR', 'pull request', 'open/draft a PR' — alongside the current trigger terms.

Optionally mention the FinanceHub/.NET scope from the body so the skill is not triggered for PRs in unrelated projects, further sharpening distinctiveness.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities ('automated template, testing checklist, security audit checklist, and release notes generator'), matching the anchor for several specific actions with minor gaps. It is not a 5 because capabilities the body clearly covers (title formatting, branch analysis, test/build validation) are omitted, leaving minor coverage gaps.

4 / 5

Completeness

The 'what' is clear (PR creation with template, checklists, and release notes), but there is no 'Use when...' clause or any equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is concrete and multi-part rather than vague.

3 / 5

Trigger Term Quality

'Pull Request' and 'release notes' are natural terms users would say, but the description is missing common variations and synonyms — most notably the abbreviation 'PR', plus phrases like 'draft a PR' or 'open a pull request'. This matches the anchor for some relevant keywords but missing common variations.

3 / 5

Distinctiveness Conflict Risk

'Pull Request creator' carves out a mostly distinct niche with only minor overlap risk against closely related skills (commit-message generation, general git hygiene). It is not a 5 because without explicit triggers, edge requests like 'write release notes' or 'fix this commit message' could plausibly route here.

4 / 5

Total

14

/

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

JoseMD12/finance-hub

Path

.agents/skills/git-pr/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.