CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

land-pr

Get a pull request that Tessl opened for a Linear or GitHub issue ready for its owner the Perihelion way: answer review feedback, fix failing checks and conflicts test-first with the build skill on the existing branch, and tell the owner when it is ready. Opens no new pull request.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 dense, disciplined runbook for an autonomous PR-landing loop: exact gh/GraphQL commands, deterministic situation ordering, explicit test-first validation loops, and a hard invariants checklist. The only soft spots are a few over-packed sentences in the ready-note rules and a single-file layout that could surface some detail in its own sections or reference files.

DimensionReasoningScore

Conciseness

Lean and operational throughout: it assumes Claude's competence, gives commands without explaining git/GitHub basics, and almost every line is a rule or an exact command. A few dense passages could still be tightened, e.g. the ready-note rules in situation 4 ("then one line for each check that does not hold on the current head: it failed outside this PR's diff, it was not run, or it ran on a narrower command..."), which keeps it just below the every-token-earns-its-place anchor.

4 / 5

Actionability

Fully executable guidance: exact invocations like `gh pr view <n> --json number,state,headRefName,headRefOid,baseRefName,mergeable,labels,body,comments,reviews`, the complete reviewThreads GraphQL query, `gh pr checks <n> --json name,bucket,link`, `addPullRequestReviewThreadReply(input: {pullRequestReviewThreadId, body})`, and `gh api repos/<owner>/<repo>/actions/jobs/<job id>/logs`, with exact input file paths, env vars, and marker strings. The common cases are covered copy-paste ready.

5 / 5

Workflow Clarity

The round is sequenced deterministically (inputs, reading the record, "Take the first that applies" situation ordering, invariants, doing the work) with explicit validation and feedback loops: "Reproduce the finding or the failure as a failing test, see it fail, fix it, and run the tests again", "Read both again before every write", "confirm HEAD is the head you read", and exit-code handling ("exits with 1 when a check failed and 8 when checks are pending; those are results, not failed reads"). The 14-item invariants list acts as a checklist, matching the top anchor.

5 / 5

Progressive Disclosure

A single-file skill with clean section structure (inputs, reading the record, situations, invariants, doing the work, judgment); no bundle files exist and the body references none, so all content sits one level deep. It is not a 5: at roughly 170 lines it exceeds the well-organized-single-file size, and dense operational rules (e.g. the ready-note spec) are buried inside situation 4 rather than split out, which is a minor organization gap.

4 / 5

Total

18

/

20

Passed

Description

75%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 is specific, distinctive, and honest about boundaries, listing the skill's full action set in one tight sentence. Its one real weakness is the absence of an explicit "Use when..." trigger clause, which caps completeness and slightly limits natural-term coverage.

Suggestions

Add an explicit trigger clause, e.g. "Use when a pull request Tessl opened for a Linear or GitHub issue has unanswered review feedback, failed checks, or merge conflicts" (completeness).

Include the natural synonyms users actually say: "PR", "merge conflict", and "CI" alongside "pull request", "conflicts", and "failing checks" (trigger_term_quality).

DimensionReasoningScore

Specificity

Lists multiple concrete actions covering the whole job: "answer review feedback", "fix failing checks and conflicts test-first with the build skill on the existing branch", and "tell the owner when it is ready", plus the boundary "Opens no new pull request". Coverage is comprehensive rather than leaving minor gaps, so it matches the top anchor rather than 4.

5 / 5

Completeness

The "what" is explicit and concrete (answer feedback, fix checks and conflicts test-first, notify the owner), but there is no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only weakly implied by "a pull request that Tessl opened". Per the judging guidelines, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good natural keyword coverage: "pull request", "review feedback", "failing checks", "Linear", "GitHub issue". A few natural terms users would say are missing ("PR", "merge conflict", "CI"), which fits the 'good coverage, a few natural terms missing' anchor rather than the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

Highly distinctive niche: "a pull request that Tessl opened for a Linear or GitHub issue", "the Perihelion way", "the build skill", and the explicit boundary "Opens no new pull request" make it unlikely to trigger for the wrong skill.

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

perihelionhq/perihelion-platform-context

Path

plugins/canonical-workflow/skills/land-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.