CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

finding-protocol

Canonical finding schema, evidence references, verification semantics, and report quality.

Quality

71%

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 ./packages/decepticon/decepticon/skills/shared/finding-protocol/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 highly actionable, well-structured protocol: a complete copy-paste canonical finding template, concrete naming and event examples, and an explicit verification gate with separation of duties. Its only weaknesses are mild redundancy, a distributed (rather than enumerated) workflow sequence, and reference-grade tables inlined in the main file.

DimensionReasoningScore

Conciseness

The body is dense, directive, and free of concept-explanation padding, with only minor trimmable redundancy (the one-file-per-finding rule is restated in "Rules" and the verification enum values appear in both the template comments and the semantics section). Fits anchor 4 (efficient with minor instances that could be trimmed) rather than 3, since nothing is genuinely unnecessary.

4 / 5

Actionability

The skill supplies a fully copy-paste-ready canonical template with all required fields and inline enum comments, plus concrete artifacts: an exact filename example (findings/high_01_cross-tenant-document-read.md), a complete timeline.jsonl event example, an 8-scheme location table with normalization rules, and named tools (cvss_score, validate_workspace_finding). As an instruction-only skill its guidance is concrete and covers the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The role sequence is clear (proof producer returns candidates, orchestrator alone registers/commits drafts, verifier edits only its assigned UUID/path) with an explicit verification checklist gate ("positive command and discriminating success signal", "equivalent negative-control command") and commit milestones. Not 5 because the end-to-end sequence is distributed across sections rather than enumerated, and error recovery beyond status enums is implicit.

4 / 5

Progressive Disclosure

A single-file skill (no bundle directories exist) with clear, logically ordered section headers and no nested references. It exceeds 50 lines and inlines reference-grade material (the 8-row location scheme table, CWE/VRT guidance) that could live in a separate reference file, so it fits anchor 4 (good structure, minor organization gaps) rather than 5.

4 / 5

Total

17

/

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 identifies a specific, well-differentiated domain but is a verbless noun list: it never says what the skill does and provides no "Use when..." trigger guidance, capping completeness. Natural trigger terms users would say (e.g. "vulnerability", "record a finding") are absent from the description text.

Suggestions

Add verb-led actions to state what the skill does, e.g. "Defines the canonical schema for recording security findings: required frontmatter fields, evidence pointers, verification requirements, and severity classification."

Add an explicit trigger clause, e.g. "Use when writing, recording, or verifying a finding (FIND- IDs, findings/ directory, severity labels, evidence pointers)."

Include natural synonyms users would actually say — "vulnerability", "document a vulnerability", "security finding" — alongside "finding".

DimensionReasoningScore

Specificity

The description names the domain via concrete nouns ("Canonical finding schema, evidence references, verification semantics, and report quality") but contains no action verbs, so nothing states what the skill actually does. It fits anchor 2 (domain named, actions absent/minimal) rather than 1 (the nouns are concrete artifacts, not pure abstract fluff) or 3 (no concrete actions are listed).

2 / 5

Completeness

The 'what' is present only as a topic scope list with no verb defining the skill's action, and the 'when' is entirely absent — no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3. Not 2 because the scope nouns concretely identify the subject matter rather than being vague like "Helps with documents".

3 / 5

Trigger Term Quality

Relevant domain keywords appear ("finding", "evidence", "verification", "report"), but natural user phrasings and common synonyms like "vulnerability" or "write/record a finding" are missing from the description itself (trigger phrases such as "FIND-" and "findings/" exist only in metadata.when_to_use). This matches anchor 3: some relevant keywords but missing common variations, short of anchor 4's good natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

"Canonical finding schema" and "verification semantics" carve a clear reporting/record-keeping niche distinct from attack-technique or recon skills. Not 5 because "report quality" and "verification" carry minor overlap risk with sibling reporting/verification skills and no distinct triggers are explicitly stated.

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

PurpleAILAB/Decepticon

Path

packages/decepticon/decepticon/skills/shared/finding-protocol/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.