CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

references

External knowledge integration — HackerOne reports, PayloadsAllTheThings, Book of Secret Knowledge, CVE PoC corpora, bug bounty methodologies, and reference pentest agent architectures. Use these to calibrate, look up payloads, and accelerate research.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./packages/decepticon/decepticon/skills/shared/references/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 well-structured, lean overview: a compact catalogue table, scenario-driven guidance with concrete tool invocations and example arguments, and a clear 5-step workflow ending in a validation-minded checkpoint. Remaining improvements are trimming a few motivational sentences and moving the catalogue/reference-agent detail into one-level-deep bundle files.

Suggestions

Trim motivational flourishes (e.g. "Don't reinvent wheels..." and "Copy the report structure that got paid...") to pure guidance.

Add failure-path guidance to the workflow: what to do when ref_suggest returns nothing relevant or a ref_fetch fails or the grepped repo lacks the expected content.

Move the 13-entry catalogue table and the reference-agent descriptions into a references/catalogue.md file, keeping SKILL.md as a lean overview with one-level-deep pointers.

DimensionReasoningScore

Conciseness

The body is lean: a 13-row table instead of prose, one-line tool invocations, and no explanation of concepts Claude already knows (no 'what SSRF is', no library comparisons). Minor padding remains — e.g. "Don't reinvent wheels — if one of them solved a problem elegantly, borrow the pattern..." and "Copy the report structure that got paid — it's validated by triagers" are motivational flourishes that could be trimmed. Fits anchor 4 (efficient, minor trimmable instances); not 5 because a few sentences don't earn their tokens, not 2/3 because there is no real over-explanation.

4 / 5

Actionability

Concrete, copy-pasteable tool calls with realistic arguments appear throughout: ref_suggest(vuln_class="...", goal="recon"), payload_search(vuln_class="ssrf", keyword="imds"), ref_fetch("payloads-all-the-things") with target path /workspace/.references/... and a ~30s timing note, ref_grep with example queries ("DNS rebinding", "CVE-2024-1234"), plus the covered vuln-class list. Mostly executable with minor gaps — e.g. no note on the size/cost of ref_fetch("hackerone-reports") versus the ~30s PayloadsAllTheThings note. Anchor 4, not 5, for those small gaps; not 3 because the commands are concrete and complete rather than pseudocode.

4 / 5

Workflow Clarity

A clear 5-step workflow (identify class → ref_suggest → pick tier → ref_grep → record borrowed patterns as hypothesis nodes) is present, and it ends with an explicit checkpoint: "Record any borrowed payloads / patterns as `hypothesis` nodes in the graph until validated". The operations are read-only lookups, not destructive/batch, so the cap of 3 does not apply. Minor validation gaps (no guidance on what to do when ref_suggest returns nothing relevant, or when a fetched repo lacks the expected content) hold this at anchor 4 rather than 5; sequence and one checkpoint are present, so not 3.

4 / 5

Progressive Disclosure

The skill is a single self-contained file (no references/, scripts/, or assets/ bundle exists, and the body points only to external repos fetched at runtime, not to nested files) — so there is no multi-level reference nesting to penalize. Sections (catalogue, when-to-use per scenario, workflow, reference architectures) are well organized and navigable, and the catalogue is compact enough to justify inlining. It sits at anchor 4 (good structure, most content appropriately placed, minor gaps): the 13-entry catalogue table and the six reference-agent descriptions could arguably live in separate one-level-deep files for a leaner SKILL.md; not 5 because the file is ~75 lines, beyond the under-50-line simple-skill exception.

4 / 5

Total

16

/

20

Passed

Description

78%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: it names the concrete external sources and the actions performed on them, with an explicit use clause and highly distinctive triggers. The main improvement would be converting purpose-based 'Use these to...' guidance into situational 'Use when...' trigger phrases and covering a few more natural synonyms.

Suggestions

Add situational trigger phrases, e.g. 'Use when the user mentions HackerOne reports, needs a payload for a known vuln class, or asks to find a PoC for a CVE.'

Include a few more natural synonyms users would say, such as 'exploit', 'cheat sheet', or 'look up a payload', alongside the existing source names.

DimensionReasoningScore

Specificity

The description names concrete sources ("HackerOne reports", "PayloadsAllTheThings", "Book of Secret Knowledge", "CVE PoC corpora") and several actions ("calibrate, look up payloads"), but "accelerate research" and "External knowledge integration" are somewhat generic headers, leaving minor gaps in coverage. This fits anchor 4 (several specific actions, minor gaps) rather than 5, since the actions are fewer and less concrete than a full multi-action enumeration, and not 3 because more than 1-2 concrete actions and the exact source catalogue are named.

4 / 5

Completeness

The 'what' is clear (curated external reference corpora for pentest work) and an explicit use clause exists ("Use these to calibrate, look up payloads, and accelerate research"), so the cap of 3 for a missing use clause does not apply. However, the 'when' is expressed as purposes rather than concrete trigger situations (no 'Use when the user mentions X or needs Y'), matching anchor 4 (both present, 'when' could be more explicit) rather than 5.

4 / 5

Trigger Term Quality

Natural terms a pentest user would say are present: "HackerOne", "payloads", "bug bounty", "CVE PoC", "pentest". A few common synonyms a user might naturally say are missing (e.g., "exploit", "cheat sheet", "methodology" is present but "OSINT"/"look up a payload" phrasing varies). Good coverage with a few natural terms missing matches anchor 4; not 5 because synonym coverage is incomplete, not 3 because most domain-relevant keywords users actually utter are there.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche — third-party reference corpora and reference agent architectures for pentest work — with distinctive triggers (named sources like HackerOne and PayloadsAllTheThings) unlikely to collide with sibling skills. This matches anchor 5; it is not 4 because the named sources and 'external knowledge integration' framing make overlap with any adjacent skill minimal.

5 / 5

Total

17

/

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/references/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.