CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

forgejo-advisory-review

Step-by-step procedure for producing ONE advisory COMMENT review on a Forgejo pull request — clone at the head sha, fetch the diff, apply general and language review criteria, post a single Reviews-API review with inline comments, recover from 422s, then verify and close the kanban card. Use when a kanban card assigns an advisory PR review on git.home.claydon.co.

Quality

94%

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 strong operational procedure: fully executable commands, explicit validation gates and retry loops for the risky external-posting step, and graceful failure handling at every branch. The only minor costs are a slightly padded framing intro and a monolithic single-file layout where a couple of sections could be split into references.

DimensionReasoningScore

Conciseness

The body is dense with operational detail Claude cannot know (card key table, refs/pull/<n>/head, Reviews-API payload, 422 semantics, kanban gates) with zero tutorial padding about git or JSON. Not 5: the three-paragraph framing intro ("You have been handed a kanban card... this skill tells you how to carry it out") is meta-narrative that could be trimmed to a sentence. Not 3: everything beyond that intro is load-bearing — commands, failure branches, and the worked example all earn their tokens.

4 / 5

Actionability

Every step ships copy-paste-ready commands: the git clone/fetch/checkout block, curl calls with auth header and exact API paths, a full JSON review payload, and a worked example that maps diff hunks to correct new_position line numbers. Failure paths have concrete recovery procedures (422 recompute-and-retry up to 3 times, kanban_block reasons). Not 4: there are no gaps — even the edge cases (head sha mismatch, missing language skill, low turn budget) have explicit instructions.

5 / 5

Workflow Clarity

Steps 0–8 are clearly sequenced with validation checkpoints throughout: HEAD-sha verification after checkout, verification that the posted review landed (matching commit_id and bot login) as a hard gate before kanban_complete, and a 422 feedback loop (recompute from the @@ header, re-POST, retry cap) for the external posting operation. Not 4: the rubric-critical feedback loops and the "MUST NOT complete unless the check passes" gate are explicit, and a low-turn-budget fallback defines how to degrade gracefully.

5 / 5

Progressive Disclosure

The skill is a single self-contained file with no bundle files (no references/, scripts/, or assets/), well-organized into numbered sections with a key table and a worked example — appropriate for a procedure whose every step runs on each invocation. Not 5: it does not demonstrate the reference-splitting pattern at all; the worked example and 422-recovery sections (~60 lines) could live in one-level-deep reference files to slim the always-loaded body. Not 3: structure is clear, nothing is buried or nested, and navigation is trivial.

4 / 5

Total

18

/

20

Passed

Description

100%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 exemplary: it names every stage of the procedure concretely, uses third person, and pairs it with an explicit, host-scoped trigger clause that mirrors how the skill is actually invoked. No vagueness, padding, or over-claims are present.

DimensionReasoningScore

Specificity

The description enumerates the full pipeline in concrete actions: "clone at the head sha, fetch the diff, apply general and language review criteria, post a single Reviews-API review with inline comments, recover from 422s, then verify and close the kanban card" — comprehensive and specific, matching the anchor for multiple concrete actions with full coverage. Not 4: no meaningful coverage gaps exist; every stage of the procedure is named.

5 / 5

Completeness

Both questions are answered explicitly and concretely: the "what" is the step-by-step procedure for one advisory COMMENT review, and the "when" is "Use when a kanban card assigns an advisory PR review on git.home.claydon.co" — a clear trigger phrase, matching the anchor exactly. Not 4: the when-clause is fully explicit with a concrete trigger condition, not merely present.

5 / 5

Trigger Term Quality

Natural trigger phrasing is complete for the domain: "Forgejo pull request", "advisory PR review", "kanban card", "git.home.claydon.co", plus synonyms (PR/pull request, advisory review, COMMENT review). The trigger clause mirrors exactly what a user or orchestrator would say when this skill is needed. Not 4: no natural term for this niche is missing.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — one advisory COMMENT review on a Forgejo PR, driven by a kanban card, scoped to a single host — with minimal overlap risk against generic code-review or git skills. Not 4: the host-scoped trigger and the kanban-card-only activation make confusion with any other skill very unlikely.

5 / 5

Total

20

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

14

/

16

Passed

Repository

rikdc/ai-skills

Path

plugins/forgejo-review/skills/forgejo-advisory-review/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.