CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rule-mining

Read recent code review on this repository's pull requests, find the mistakes reviewers keep catching, and file a GitHub issue proposing a rule so agents get it right next time. Use when running the rule mining maintenance loop, or when asked what the agent keeps getting wrong in review. Files issues only; never changes code or docs.

77

Quality

97%

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

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

An exemplary instruction-only skill body: lean, fully actionable with concrete commands and templates, sequenced as an executable workflow with validation checkpoints (skip refuted, duplicate check, empty-result handling), and appropriately sized so no external files are needed. No dimension showed a defensible deduction.

DimensionReasoningScore

Conciseness

The ~40-line body is lean with zero concept explanations: every line is an instruction, a criterion, or a boundary ("Skip findings that were refuted or declined", "One-off bugs don't count"). It assumes Claude's competence and every token earns its place, matching the 5 anchor.

5 / 5

Actionability

Provides copy-paste-ready guidance: the exact command `gh pr list --state all`, a scope ("15 most recent pull requests"), the issue title template `Rule: <the rule in a few words>`, a structured body spec with links and a "Done when" line, and two concrete examples of repeat rules. For an instruction-only skill this matches the 5 anchor's fully-executable bar.

5 / 5

Workflow Clarity

Sections are ordered as the execution flow (read reviews → identify repeats → file), with explicit checkpoints: skip refuted findings, "No duplicates. Check the open issues first" before filing, and an explicit empty-result path ("Nothing found is a fine result"). Tool fallback is handled ("or whatever GitHub access you have"), so the batch/outward-facing filing step has its validation present and no cap applies.

5 / 5

Progressive Disclosure

Under 50 lines with no need for external references — none exist in the bundle — and the body is organized into four clear, well-scoped sections (intro, What to read, What counts as a repeat, What to file). Per the rubric's simple-skill guideline this scores 5 on organization alone.

5 / 5

Total

20

/

20

Passed

Description

92%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: concrete, third-person action statements, an explicit "Use when" clause with natural trigger phrases, and a clear scope boundary that distinguishes it from review/editing skills. The only gap is a few missing synonyms for the trigger terms.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Read recent code review on this repository's pull requests", "find the mistakes reviewers keep catching", "file a GitHub issue proposing a rule" — plus an explicit scope boundary ("Files issues only; never changes code or docs"). Coverage of what the skill does is complete, matching the comprehensive-coverage anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

Explicitly answers both questions: the "what" (read reviews, find repeated mistakes, file a GitHub issue) and the "when" via a concrete "Use when running the rule mining maintenance loop, or when asked what the agent keeps getting wrong in review" clause. This matches the 5 anchor's what-plus-concrete-trigger-phrases pattern; 4 would require the when-clause to be less explicit.

5 / 5

Trigger Term Quality

Includes natural phrases users would say — "code review", "pull requests", "rule mining maintenance loop", "what the agent keeps getting wrong in review" — but a few natural variants like "recurring review feedback" or "common review mistakes" are absent. This sits between the 4 and 5 anchors, fitting the good-but-not-comprehensive coverage at 4.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (mining review rules and filing issues) with distinct triggers, and "Files issues only; never changes code or docs" cleanly separates it from code-review or code-editing skills. Conflict risk with other skills is minimal, matching the 5 anchor rather than the minor-overlap 4 anchor.

5 / 5

Total

19

/

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

sjmaple/carnival

Path

tessl-factory/skills/rule-mining/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.