CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-ops-cicd-github

Agent skill for ops-cicd-github - invoke with $agent-ops-cicd-github

52

1.00x
Quality

26%

Does it follow best practices?

Impact

100%

1.00x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agent-ops-cicd-github/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The markdown instruction section is compact and includes one solid executable workflow example, but the body is dominated by an inert configuration blob and offers no sequenced procedure or validation loop for pipeline creation. It reads as half config file, half checklist, with the checklist items too abstract to execute.

Suggestions

Add a sequenced workflow with explicit validation checkpoints, e.g. 1) detect project type, 2) write the workflow, 3) validate with `actionlint` or `act`, 4) only then commit — the absence of any validation step currently caps workflow clarity.

Move the 117-line cicd-engineer configuration block to a separate reference file (or trim it to what the task actually needs), keeping SKILL.md as a lean instructional overview.

Convert abstract best-practice bullets into concrete snippets, such as a caching example, a minimal-permissions `permissions:` block, and an environment protection rule example.

DimensionReasoningScore

Conciseness

Roughly 117 of ~165 body lines are an agent-configuration blob (triggers, capabilities, constraints, echo-hook scripts, integration metadata) that instructs nothing about the task, and bullets like 'Never hardcode secrets' and 'Use appropriate runners (ubuntu-latest)' restate knowledge Claude already has. This is 'noticeably verbose; several unnecessary explanations or padded sections' (anchor 2), not anchor 3, because the padding is a large fraction of the body rather than a few stray sentences.

2 / 5

Actionability

The one workflow-pattern YAML is executable and complete, but the rest of the guidance — 'Implement proper secret management', 'Set up caching and artifact management', 'Use environment protection rules' — is high-level direction without commands or snippets. That mix matches anchor 3 ('Some concrete guidance but incomplete'), falling short of anchor 4 because most responsibilities have no executable counterpart.

3 / 5

Workflow Clarity

There is no step sequence at all — the body lists parallel responsibilities and best practices, not an ordered procedure (no 'analyze project → write workflow → validate → commit' flow), and no validation checkpoint despite deployments being a batch/risky operation (the post-execution hook's 'validation' is a `cat | head -1`). Anchor 1's 'Steps missing or incoherent; no sequence; no validation' is the best fit; anchor 2 requires at least a rough sequence, which is absent.

1 / 5

Progressive Disclosure

The markdown portion has clear sections (responsibilities, best practices, workflow patterns, security) and no bundle files exist to reference, but the 117-line agent-config block is inline content that clearly belongs in a separate file, matching anchor 3's example of well-headed sections with a large inline block that should be split out. It is not anchor 2 because the surrounding markdown structure is genuinely good.

3 / 5

Total

9

/

20

Passed

Description

23%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 effectively a placeholder: an identity label and invocation syntax with no description of capabilities and no usage guidance. It would almost never be selected on merit, since a user's natural phrasing ('set up a GitHub Actions pipeline') matches nothing in it.

Suggestions

Rewrite the description to state concrete actions in third person, e.g. 'Creates and optimizes GitHub Actions workflows, including build/test/deploy pipelines, job matrices, and dependency caching.'

Add an explicit 'Use when...' clause covering natural trigger phrases such as 'GitHub Actions', 'CI/CD pipeline', 'workflow', 'deployment pipeline', or '.github/workflows' files.

Remove the meta invocation syntax ('invoke with $agent-ops-cicd-github') from the description; it consumes the description budget without describing what the skill does.

DimensionReasoningScore

Specificity

The description is 'Agent skill for ops-cicd-github - invoke with $agent-ops-cicd-github' — a label plus invocation syntax with zero capability verbs. Like the anchor-1 example 'Helps with documents', it names no concrete actions at all, so it matches anchor 1 rather than anchor 2 (which requires at least naming actions, however generic).

1 / 5

Completeness

The 'what' is a vague identity label with no statement of what the skill does, and the 'when' is entirely missing, matching anchor 2 ('Has a vague what and no when'). It is not anchor 1 only because the slug does convey a concrete domain (GitHub CI/CD); the missing 'Use when' clause also caps this dimension at 3, which it is well below.

2 / 5

Trigger Term Quality

The only candidate keywords ('ops', 'cicd', 'github') are embedded in a slug rather than natural phrases users say, and natural terms like 'GitHub Actions', 'CI/CD pipeline', or 'workflow' are absent. This sits between anchor 1 (only jargon/generic) and anchor 3 (some relevant natural keywords), matching anchor 2's 'one or two generic keywords; missing the natural phrases users say'.

2 / 5

Distinctiveness Conflict Risk

The slug names a specific niche (GitHub + CI/CD + ops), so it is not the 'very broad; high overlap risk' of anchor 2, but with no capability or trigger description it could still overlap with neighboring devops/deployment skills, matching anchor 3 ('Somewhat specific but could still overlap with similar skills').

3 / 5

Total

8

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ruvnet/ruflo
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.