CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

final-report

Final engagement report generation — executive summary, technical report, findings aggregation, attack path narrative, detection gap matrix, remediation roadmap.

Quality

75%

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/standard/decepticon/final-report/SKILL.md
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 content is highly actionable — complete, copy-paste-ready templates backed by precise aggregation rules and a strong validation checklist — and the workflow is clear if implicitly sequenced. Its weaknesses are redundancy (sorting/verification rules restated across three sections) and monolithic structure: both large templates are inlined rather than split into reference files.

Suggestions

Consolidate the duplicated sorting/verified/unverified rules from 'Finding metadata interpretation', 'Findings Aggregation Rules', and 'Interpreting quality status' into a single authoritative rules section.

Move the executive-summary and technical-report templates into references/ files (e.g. references/executive-summary.md, references/technical-report.md) and keep SKILL.md as a concise overview with well-signaled one-level-deep links.

Present the procedure as an explicit ordered step list (determine workflow version → extract findings → sort/correlate → assemble sections → run Quality Checklist) with a re-validate loop after any checklist item fails.

DimensionReasoningScore

Conciseness

Most content earns its place (templates, aggregation rules, checklist), but the same rules are stated redundantly: sort order appears in 'Sorting rules' (lines 43-46) and again in 'Findings Aggregation Rules' (line 402), and verified/unverified handling is covered three times (lines 44-46, 404-405, 429-430) plus again in 'Interpreting quality status'. Not 2: there is no padded explanation of concepts Claude already knows — the glossary is part of the client-facing template, not teaching material; not 4: the overlapping sections and the convoluted opening paragraph could be tightened into one authoritative rules section.

3 / 5

Actionability

Both templates are fully concrete, copy-paste-ready markdown with exact section structures, populated example rows, and placeholder conventions, plus concrete extraction field lists, sorting rules, and per-condition handling (empty paths, missing CVSS, false positives). Not 4: the guidance leaves no execution gaps — every workflow variant (v2 registry vs. pinned legacy) has specific, executable instructions covering the common cases.

5 / 5

Workflow Clarity

The process flows logically (determine workflow version → read findings/registry → sort and correlate → assemble from templates → apply aggregation rules → verify via the Quality Checklist), and the 13-item checklist is an explicit end-of-work validation gate with rules for empty sections and unfinished drafts. Not 5: the sequence is implied by section order rather than an explicitly numbered procedure with feedback loops (e.g. re-check the checklist after fixing a failed item); not 3: checkpoints are present and concrete, not merely implicit.

4 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but the two full templates (~240 of ~425 lines) are inlined in the single SKILL.md with no bundle files at all — content that would naturally live in references/executive-summary.md and references/technical-report.md. Matches the level-3 anchor: some structure, but content that should be separate is inline. Not 4: a ~425-line monolith with zero external references is a real organization gap, not a minor one; not 2: headers, table of contents in the template, and clear section navigation keep it usable.

3 / 5

Total

15

/

20

Passed

Description

71%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 specific and comprehensive about what the skill produces, listing all six deliverable components in a distinct niche. Its main weakness is the absence of explicit trigger guidance inside the description itself — the 'when' lives in metadata.when_to_use rather than the description — and slightly thin natural-language trigger variations.

Suggestions

Append a trigger clause to the description itself, e.g. 'Use when the engagement is complete and the user asks for the final report, executive summary, or technical report.'

Add natural trigger variations users would say, such as 'generate report', 'write the final report', or 'wrap-up report', to broaden trigger term coverage.

Mention the boundary versus single-finding reports (e.g. 'aggregates all FIND-* findings') to sharpen distinctiveness from the finding-report skill.

DimensionReasoningScore

Specificity

The description names the domain ('Final engagement report generation') and lists six concrete deliverable components — 'executive summary, technical report, findings aggregation, attack path narrative, detection gap matrix, remediation roadmap' — which comprehensively covers the skill's outputs. Not below 4: the coverage is complete rather than having minor gaps; the components are specific deliverables, matching the level-5 anchor's multiple concrete actions.

5 / 5

Completeness

The 'what' is clearly and concretely answered, but the description field contains no 'Use when...' clause or equivalent explicit trigger guidance, capping completeness at 3 per the rubric guideline. The when-guidance exists only in the separate metadata.when_to_use field, not in the description being evaluated.

3 / 5

Trigger Term Quality

Terms like 'executive summary', 'technical report', 'remediation' are natural phrases a user would say when needing this skill, giving good keyword coverage. Not 5: common variations such as 'generate report', 'write report', 'final report', or 'engagement complete' are absent, so coverage is not comprehensive; not 3 because the present terms go beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

'Final engagement report generation' carves a clear niche distinct from generic reporting, but a closely related sibling skill ('finding-report' in skillogy.requires) plus generic trigger words like 'technical report' create minor overlap risk. Not 5: the overlap with a per-finding reporting skill is plausible; not 3: the scope is well differentiated from general document skills.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 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

relative_links

Relative link issues: 1 suspicious

Warning

Total

13

/

16

Passed

Repository

PurpleAILAB/Decepticon

Path

packages/decepticon/decepticon/skills/standard/decepticon/final-report/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.