CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

iterate-pr

Iterate on a PR until CI passes. Use when you need to fix CI failures, address review feedback, or continuously push fixes until all checks are green. Automates the feedback-fix-push-wait cycle.

Quality

86%

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

The canonical home for this skill is iterate-pr in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 well-sequenced, highly actionable workflow whose strongest qualities are explicit validation checkpoints, feedback loops, and exit conditions. The remaining improvements are small: trim the boilerplate 'When to Use' section, supply a concrete GraphQL reply example, and fix the fallback gh pr checks syntax.

Suggestions

Remove the generic 'When to Use' boilerplate ('Use this skill when tackling tasks related to its primary domain or functionality as described above') — it adds no information beyond the frontmatter description (conciseness).

Add a copy-paste-ready 'gh api' GraphQL example for 'addPullRequestReviewThreadReply', since replying to review threads is a core step currently specified only by mutation and input names (actionability).

Correct the fallback command to 'gh pr checks --json name,state,bucket,link' so it is executable as written (actionability).

DimensionReasoningScore

Conciseness

The body is lean, imperative operational guidance with no concept explanations Claude already knows, but has minor trimmable filler: the intro line 'Continuously iterate on the current branch until all CI checks pass and review feedback is addressed' duplicates the H1, and the closing 'Use this skill when tackling tasks related to its primary domain or functionality as described above' is generic boilerplate. Not 5 because of these padding instances; not 3 because the bulk of the ~180 lines earns its tokens.

4 / 5

Actionability

Nearly everything is executable — 'uv run ${CLAUDE_SKILL_ROOT}/scripts/fetch_pr_checks.py [--pr NUMBER]', 'gh pr view --json number,url,headRefName', documented JSON output schemas, concrete sleep intervals, and an example numbered prompt for low-priority items. Minor gaps keep it below anchor 5: the reply step names the 'addPullRequestReviewThreadReply' mutation with inputs but no ready-to-run example call, and the fallback 'gh pr checks name,state,bucket,link' omits the --json flag, so not quite copy-paste ready for every common case.

4 / 5

Workflow Clarity

Eight clearly sequenced steps with explicit validation checkpoints ('If local verification fails, fix before proceeding — do not push known-broken code', 'Stop if no PR exists'), genuine feedback loops (step 7's poll-fix-push-repeat cycle and step 8's return to step 2), and an exit-condition checklist (Success / Ask for help / Stop). This matches anchor 5 exactly: explicit validation steps, error-recovery loops, and checklists for a complex multi-phase process.

5 / 5

Progressive Disclosure

Well-organized sections (Bundled Scripts, Workflow, Exit Conditions, Fallback) with the two bundled scripts signaled one level deep via '${CLAUDE_SKILL_ROOT}/scripts/...' paths, each documented with usage and JSON output schema. It stays at 4 rather than 5 because all detail is inlined in a single ~180-line file with no reference files to offload material (reply etiquette, feedback category definitions), and no bundle files exist in the skill directory to verify the referenced script paths.

4 / 5

Total

17

/

20

Passed

Description

88%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 that explicitly states both what the skill does and when to use it, with multiple concrete actions and natural trigger terms like 'CI failures' and 'checks are green'. The only room for improvement is broader synonym coverage ('pull request', 'build failures').

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'fix CI failures', 'address review feedback', 'continuously push fixes until all checks are green' — framed by the overarching 'Iterate on a PR until CI passes', covering the complete feedback-fix-push-wait cycle the skill automates. It fits anchor 5 ('comprehensive coverage') rather than anchor 4 ('minor gaps') because every core capability of the stated cycle is named explicitly.

5 / 5

Completeness

It explicitly answers both what ('Iterate on a PR until CI passes... Automates the feedback-fix-push-wait cycle') and when ('Use when you need to fix CI failures, address review feedback, or continuously push fixes until all checks are green') with concrete trigger phrases. This structurally matches the anchor-5 example ('Extract text... Use when working with PDF files or when the user mentions...') rather than anchor 4, whose 'when' is less explicit.

5 / 5

Trigger Term Quality

Natural terms users would actually say are present: 'PR', 'CI', 'CI failures', 'review feedback', 'all checks are green'. A few natural variants are missing — 'pull request' spelled out, 'build failures', 'failing tests' — so it sits between anchor 4 ('good keyword coverage; a few natural terms missing') and anchor 5, noticeably above the midpoint but not comprehensive.

4 / 5

Distinctiveness Conflict Risk

The 'iterate until CI passes' framing carves a clear niche with distinct triggers, but 'fix CI failures' and 'address review feedback' could also plausibly trigger closely related code-review or one-off debugging skills — minor overlap risk matching anchor 4 ('mostly distinct') rather than anchor 5's 'minimal conflict risk'.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/iterate-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.