CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

66

Quality

80%

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 ./skills/iterate-pr/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, well-crafted skill that provides a comprehensive CI iteration workflow with excellent actionability and workflow clarity. The step-by-step process includes proper validation checkpoints, feedback loops, and clear exit conditions. The main weakness is moderate verbosity—some sections could be tightened, and there's minor redundancy in how review bot handling is described across multiple steps.

Suggestions

Remove the boilerplate 'When to Use' section at the end—it adds no value beyond what the skill title and description already convey.

Consolidate review bot handling into a single reference point rather than mentioning it in steps 3, 4, and 7 separately.

DimensionReasoningScore

Conciseness

The skill is fairly long (~200 lines) and includes some redundancy—e.g., the LOGAF explanation and review bot handling are repeated across multiple sections (step 3 feedback handling, step 4 wait logic, step 7 monitoring). The feedback reply format section is detailed but appropriate given the complexity. Some tightening is possible (e.g., the 'When to Use' boilerplate at the end adds nothing), but most content is genuinely instructive rather than explaining things Claude already knows.

3 / 5

Actionability

The skill provides fully executable commands throughout—specific bash commands, exact script paths with variable references, JSON output schemas, GraphQL mutation names, git commands, and concrete examples like the numbered feedback list format. The fallback section provides alternative CLI commands. Every step has copy-paste ready guidance.

5 / 5

Workflow Clarity

The workflow is clearly sequenced (8 numbered steps) with explicit validation checkpoints: local verification before pushing (step 6), CI polling loop with feedback checks (step 7), post-CI feedback re-check, and clear feedback loops (fix → verify locally → push → monitor → repeat). Exit conditions, escalation criteria ('ask for help' after 2 attempts), and stop conditions are all explicitly defined. The polling loop in step 7 is particularly well-structured with sub-steps.

5 / 5

Progressive Disclosure

The skill is well-structured with clear sections (Bundled Scripts, Workflow steps, Exit Conditions, Fallback). Script documentation is appropriately placed at the top with JSON schemas. However, no bundle files were provided to verify, and the content is somewhat long—the detailed feedback handling rules and reply format could potentially be split into a separate reference file. The single-file approach is reasonable given the workflow nature, but it's on the edge of needing decomposition.

4 / 5

Total

17

/

20

Passed

Description

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

This is a solid description that clearly communicates both what the skill does and when to use it, with an explicit 'Use when' clause containing relevant trigger scenarios. Its main weakness is that the specific actions are described at a process level rather than listing granular capabilities, and it could benefit from additional trigger term synonyms like 'pull request', 'build failures', or 'tests failing'.

Suggestions

Add synonym trigger terms like 'pull request', 'build failures', 'tests failing', 'pipeline errors', or specific CI platforms (e.g., 'GitHub Actions', 'CircleCI') to improve discoverability.

List more concrete actions such as 'reads CI logs', 'identifies failing tests', 'applies code fixes', 'monitors check status' to increase specificity.

DimensionReasoningScore

Specificity

Names the domain (PR/CI) and describes the general action ('iterate on a PR until CI passes', 'fix CI failures', 'address review feedback', 'push fixes'), but doesn't list specific concrete actions like reading CI logs, running tests locally, parsing error messages, or committing fixes. The actions described are more process-level than granular.

3 / 5

Completeness

Clearly 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'). The 'Use when' clause is explicit with concrete trigger scenarios.

5 / 5

Trigger Term Quality

Includes good natural keywords like 'PR', 'CI', 'CI failures', 'review feedback', 'checks', 'green', and 'push fixes' that users would naturally say. Missing some variations like 'pull request', 'pipeline', 'build failures', 'tests failing', 'GitHub Actions', or 'CI/CD'.

4 / 5

Distinctiveness Conflict Risk

Fairly distinct with its focus on the iterative CI fix cycle for PRs, which is a specific niche. Minor overlap risk with general git/PR skills or CI configuration skills, but the emphasis on the automated feedback-fix-push-wait loop differentiates it well.

4 / 5

Total

16

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.