CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

perl-patterns

Modern Perl 5.36+ idioms, best practices, and conventions for building robust, maintainable Perl applications.

Quality

66%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/perl-patterns/SKILL.md

The canonical home for this skill is perl-patterns in affaan-m/ECC

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 body is a strong, highly actionable patterns reference with executable Good/Bad examples and thorough coverage of modern Perl topics. Its weaknesses are inlined reference-scale content that belongs in separate files and sections that re-explain core Perl concepts Claude already knows.

Suggestions

Split the detailed reference material (OO patterns, regexes, tooling configs) into references/ files (e.g. references/oo.md, references/regex.md, references/tooling.md) and keep SKILL.md as an overview with well-signaled one-level-deep links.

Remove or compress sections teaching core Perl knowledge Claude already has (scalar vs list context, hash/array reference basics) and keep only the project-specific conventions.

Stop repeating 'use v5.36;' in every code block — state the preamble requirement once and show only the pattern-specific lines in each example.

DimensionReasoningScore

Conciseness

Mostly example-driven rather than padded, but several sections teach concepts Claude already knows ('Understand scalar vs list context — a core Perl concept', hash/array reference basics, commented explanations like '# Scalar context: count (5)'), and 'use v5.36' is repeated in nearly every block. This is more than the 'minor instances' of level 4, but not the noticeably padded verbosity of level 2.

3 / 5

Actionability

Code is concrete and copy-paste ready across the common cases: v5.36 preamble, signatures, postfix dereferencing, a complete Moo class with roles, named-capture regexes, three-arg open with autodie, Path::Tiny usage, project layout, Exporter pattern, perltidyrc/perlcriticrc configs, and a cpanfile, plus Good/Bad pairs and a legacy-to-modern table. It matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

This is a reference/patterns skill with no destructive or batch operations, so no validation checkpoints are required; 'When to Activate' and 'How It Works' ('apply these patterns as a bias toward modern Perl 5.36+ defaults... meant to be copied as starting points, then tightened') make the application guidance clear. It falls short of 5 only because there is no explicit sequence or verification guidance for applying the conventions.

4 / 5

Progressive Disclosure

The body has good section structure and an navigable idiom table, but ~450 lines of pattern reference (OO, regexes, tooling, file I/O) are all inlined in SKILL.md with no bundle files or references splitting the material. This matches 'Some structure... content that should be separate is inline'; it is above level 2 because section headers keep it well-organized and navigable.

3 / 5

Total

15

/

20

Passed

Description

48%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 clearly names its niche (modern Perl 5.36+) but reads as a topic label rather than an actionable, trigger-rich description. It lacks any 'when to use' guidance and concrete capability verbs, and misses natural trigger variations like .pl/.pm or 'Perl module'.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g. 'Use when writing, reviewing, or refactoring Perl code or modules (.pl, .pm), or migrating pre-5.36 code.'

Replace generic nouns ('idioms, best practices, and conventions') with concrete actions such as 'applies signatures, Moo-based OO, modern error handling, and tooling conventions (perltidy, perlcritic, cpanfile)'.

Include natural synonyms and file extensions users would mention (Perl script, Perl module, .pl, .pm, cpanfile) to strengthen trigger matching.

DimensionReasoningScore

Specificity

The description names the domain ('Modern Perl 5.36+ idioms, best practices, and conventions for building robust, maintainable Perl applications') but lists no concrete actions such as refactoring, reviewing, or writing modules. It matches the anchor 'Names the domain but actions are minimal or generic' rather than level 3, which requires 1-2 concrete actions.

2 / 5

Completeness

The 'what' is clear (idioms, best practices, and conventions for Perl applications), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is above level 2 because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

'Modern Perl 5.36+', 'Perl applications', and 'best practices' include the natural keyword 'Perl' a user would say, but common variations like '.pl', '.pm', 'Perl script', 'Perl module', or 'cpanfile' are missing. This fits 'Some relevant keywords but missing common variations or synonyms', not level 4's good keyword coverage.

3 / 5

Distinctiveness Conflict Risk

Perl is a clear niche with a distinct trigger term, so overlap risk is minor (mainly with generic coding-standards or code-review skills, where triggering may even be desired). It falls short of level 5 because the description lacks explicit trigger phrases that would fully sharpen distinctiveness.

4 / 5

Total

12

/

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

skill_md_line_count

SKILL.md is long (505 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/perl-patterns/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.