CtrlK
BlogDocsLog inGet started
Tessl Logo

github-workflow

Install and operate a full GitHub issue-to-merge workflow for any repository using event-driven and cron missions. Handles issue planning, PR monitoring, CI fixing, staging review, and post-merge learning.

64

Quality

76%

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/github-workflow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

The body is an exemplary instruction-only skill: lean, highly actionable with named tools and parameters, a clearly sequenced install workflow with an explicit validation loop, and clean one-level-deep progressive disclosure into a real reference file. No dimension showed meaningful weakness.

DimensionReasoningScore

Conciseness

The body is lean and sectioned with no padding or basic-concept explanation; every line earns its place (e.g., 'All implementation work on non-main branches', 'Memory update runs only after successful merge'). Matches the 'lean and efficient; every token earns its place' anchor; not a 2 because there is no unnecessary explanation to tighten.

3 / 3

Actionability

Concrete, named tool calls and parameters throughout ('Call mission_create with name, goal (the prompt), and cadence', 'run event_emit with a synthetic issue.opened payload', 'check mission_list'), and the referenced file supplies copy-paste-ready JSON mission templates. Per the instruction-only scoring note, absence of inline code is not penalized since the guidance is fully actionable; matches the 'fully executable/specific examples' anchor.

3 / 3

Workflow Clarity

The install procedure is a clear 1–6 sequence and is followed by an explicit Validation feedback loop (emit synthetic event -> confirm a mission fired -> check status -> confirm no unrelated missions fired), which is exactly the validation checkpoint + error-recovery pattern the anchor rewards for batch installs. Not a 2 because explicit checkpoints are present rather than implicit.

3 / 3

Progressive Disclosure

The body is a concise overview that signals exactly one one-level-deep reference via a markdown link ('Open [workflow-routines.md](references/workflow-routines.md)'), and that file exists and holds the detailed templates. Matches the 'clear overview with well-signaled one-level-deep references; content appropriately split' anchor; not a 2 because organization and signaling are clean and shallow.

3 / 3

Total

12

/

12

Passed

Description

52%

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 and distinctive about its GitHub workflow automation niche, but it lacks any explicit 'Use when...' trigger guidance and contains no natural user keywords within the description text itself. Those gaps pull trigger_term_quality and completeness down despite strong capability specificity.

Suggestions

Add a 'Use when...' clause naming natural user phrases (e.g., 'Use when setting up GitHub issue-to-merge automation, CI/PR automation, or repo workflow setup') to lift completeness to 3.

Weave in natural trigger terms a user would actually say ('GitHub workflow', 'CI automation', 'PR automation') directly in the description rather than only in the activation block, to raise trigger_term_quality.

Keep the concrete action list and third-person voice as-is; only the trigger/when layer is missing.

DimensionReasoningScore

Specificity

Enumerates multiple concrete actions — 'Handles issue planning, PR monitoring, CI fixing, staging review, and post-merge learning' — matching the 'lists multiple specific concrete actions' anchor. Not a 2, since the actions are comprehensive rather than partial; voice is correctly third person.

3 / 3

Completeness

It clearly answers 'what' (install/operate a workflow covering planning through learning) but offers no explicit 'when' guidance, capping at 2 per the rubric's missing-'Use when' rule. Not a 3 because no explicit trigger clause exists; not a 1 because the 'what' is strong and specific.

2 / 3

Trigger Term Quality

The description contains no natural user-facing keywords or 'Use when...' triggers; it relies on technical phrasing like 'event-driven and cron missions' and 'issue-to-merge workflow'. The natural trigger terms (github workflow, CI automation) live only in the activation block, not the description, so it matches the 'no natural keywords; technical jargon' anchor rather than the 'some relevant keywords' level 2.

1 / 3

Distinctiveness Conflict Risk

The narrow 'GitHub issue-to-merge workflow' niche with event/cron missions is distinctive and unlikely to fire for unrelated skills, matching the 'clear niche with distinct triggers' anchor. It is not a 2 because the domain is specific rather than broadly overlapping.

3 / 3

Total

9

/

12

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.

Validation15 / 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
nearai/ironclaw
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.