CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

yara-rule-authoring

Guides authoring of high-quality YARA-X detection rules for malware identification. Use when writing, reviewing, or optimizing YARA rules. Covers naming conventions, string selection, performance optimization, migration from legacy YARA, and false positive reduction. Triggers on: YARA, YARA-X, malware detection, threat hunting, IOC, signature, crx module, dex module.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

Excellent expert-level content: highly actionable commands and complete examples, a validation-rich workflow with feedback loops and a checklist, and tight token efficiency broken only by minor duplication and promotional asides. The significant defect is progressive disclosure — the bundle is missing workflows/rule-development.md, the entire examples/ directory, and the README, so several prominently cited paths resolve to nothing.

Suggestions

Add the missing workflows/rule-development.md and the five examples/*.yar files to the bundle (or remove the links), since the body cites them as "the full step-by-step guide" and rules "worth reading before writing your own" — dead paths are the biggest navigation defect.

Fix or remove the [README.md](../../README.md#scripts) link in the Scripts section; it does not resolve within the installed skill bundle.

Trim the duplicated yr/lint command blocks (Workflow, review, and Scripts sections repeat the same invocations) and the marketing claims in the YARA-X intro paragraph ("5-10x faster", "powers VirusTotal's production systems") to tighten conciseness.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious expert judgment (atom quality, endian traps, FP escalation ladder, rationalizations table) and assumes YARA knowledge rather than re-explaining it. Minor over-explanation keeps it from a 5: promotional claims ("5-10x faster regex", "It powers VirusTotal's production systems") in the intro, and the yr/lint commands repeated nearly verbatim across the Workflow, review, and Scripts sections. Not 3, because nearly every section earns its tokens with content Claude would not know.

4 / 5

Actionability

Fully executable guidance throughout: literal commands ("yr check rule.yar", "time yr scan -s rule.yar corpus/"), complete rule examples for macOS/crx/dex, and bundled scripts documented down to their exit-code semantics (0/1/2) and JSON output shape. The <resolved-...-path> placeholders are not a gap because the resolution convention is explicitly instructed up front, matching the copy-paste-ready top anchor.

5 / 5

Workflow Clarity

A 7-step development workflow with quality gates, a review workflow with concrete validation commands, explicit error-recovery feedback loops ("1-2 matches: investigate and tighten; 3-5: find different indicators; 6+: start over"; migration's fix-then-verify-without-relaxed loop), and a 14-item pre-deployment checklist — the top anchor's sequence, checkpoints, feedback loops, and checklist are all present.

5 / 5

Progressive Disclosure

Structure and signaling are otherwise strong (one-level-deep references/, a topic-mapped Further Reading table, scripts clearly linked), but a substantial share of outgoing links are dead in the actual bundle: workflows/rule-development.md (cited twice, billed as "the full step-by-step guide"), all five examples/*.yar files, and ../../README.md do not exist. Seven-plus unresolved referenced paths is a navigation failure beyond the "minor organization gaps" of the 4 anchor, fitting the some-structure-needs-better-organization 3 anchor.

3 / 5

Total

17

/

20

Passed

Description

88%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: third-person voice, explicit "Use when" trigger guidance, an enumerated trigger list, and comprehensive coverage of the skill's actions. The only weaknesses are the broad "signature"/"threat hunting" triggers creating mild overlap risk with network-detection skills, and the absence of file extensions or synonyms like "detection rules" in the trigger list.

DimensionReasoningScore

Specificity

"Use when writing, reviewing, or optimizing YARA rules. Covers naming conventions, string selection, performance optimization, migration from legacy YARA, and false positive reduction" lists multiple concrete actions with essentially complete coverage of the domain's sub-tasks, matching the comprehensive-coverage anchor. Not 4, because the coverage of what the skill does shows no meaningful gaps.

5 / 5

Completeness

Explicitly answers both: what ("Guides authoring of high-quality YARA-X detection rules for malware identification") and when ("Use when writing, reviewing, or optimizing YARA rules"), followed by an enumerated trigger list — the exact pattern of the top anchor. Not 4, because the when-clause is explicit and trigger-phrased rather than merely present.

5 / 5

Trigger Term Quality

"Triggers on: YARA, YARA-X, malware detection, threat hunting, IOC, signature, crx module, dex module" gives good natural-term coverage a user would actually say. Not 5, because it omits file extensions (.yar/.yara) and natural synonyms like "detection rules", which the top anchor requires.

4 / 5

Distinctiveness Conflict Risk

YARA-X rule authoring is a clear niche with mostly YARA-specific triggers, but "signature" and "threat hunting" are broad terms that could pull in IDS rule-writing or threat-intel use cases the body itself defers to other skills (Suricata/Snort). Minor overlap with closely related skills matches the 4 anchor rather than the minimal-conflict 5 anchor.

4 / 5

Total

18

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 7 missing, 1 suspicious

Warning

Total

15

/

16

Passed

Repository

trailofbits/skills

Path

plugins/yara-authoring/skills/yara-rule-authoring/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.