CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

contracts-overview

Smart contract audit lane — Solidity/EVM pattern scanner, Slither ingestion, Foundry PoC generation, DeFi attack playbooks.

Quality

83%

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

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

A tight, command-driven catalog page: lean routing table, concrete workflow, and a useful severity rubric, with detail correctly deferred to per-vulnerability skills. Minor gaps are the vague 'etc.' for PoC generators and the absence of an explicit retry/discard loop for failing PoCs.

Suggestions

Replace 'via foundry_reentrancy_test etc.' in step 6 with a mapping from vulnerability type to the specific PoC generator tool (or point to the playbook rows that contain it).

Add a brief failure branch after step 7, e.g. 'If a PoC fails, fix the precondition or discard — do not promote failing tests.'

DimensionReasoningScore

Conciseness

The body is three lean sections: a playbook routing table, an 8-step numbered workflow of concrete commands, and a severity-tier table. It assumes Claude's competence (no explanation of what reentrancy or Slither is) and every token earns its place, matching the 5 anchor.

5 / 5

Actionability

Steps are executable with concrete commands ('bash("find /workspace/src -name *.sol | head -50")', 'slither . --json slither.json', 'forge test -vvv --match-contract Test_') and named tool calls ('solidity_scan_file', 'slither_ingest', 'kg_query'). Not a 5: step 6's 'foundry_reentrancy_test etc.' leaves the per-vulnerability test generators vague, and no example PoC snippet is shown.

4 / 5

Workflow Clarity

The 8-step sequence is clearly ordered from mapping to promotion, and there is a pass/fail gate (run 'forge test', then 'Promote passing PoCs as validated findings'). Not a 5: no explicit feedback loop for failing PoCs (fix/retry/discard guidance) and no baseline negative-control step in the body, though the workflow is not destructive so no cap applies.

4 / 5

Progressive Disclosure

Under 50 lines with well-organized sections and no inlined bulk content; per-vulnerability detail is pushed one level deep to sibling SKILL.md files via a clearly labeled routing table. This matches the small-skill exception (under 50 lines, no external reference files needed) for a top score.

5 / 5

Total

18

/

20

Passed

Description

75%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 crisp, capability-dense description in third person with excellent domain keywords and low conflict risk. Its only material weakness is the missing 'Use when...' trigger clause, which caps completeness at 3.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user mentions smart contracts, Solidity, EVM, web3 audits, Slither, Foundry PoCs, or DeFi exploits.'

Add one or two natural synonyms users might say ('web3', 'blockchain security', 'exploit') to broaden trigger coverage.

Consider whether 'audit lane' routing jargon is a phrase a user would naturally say; replace or supplement it with a plain capability phrase.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'Solidity/EVM pattern scanner', 'Slither ingestion', 'Foundry PoC generation', 'DeFi attack playbooks' — covering scan, ingest, PoC, and playbook layers with no vague filler. This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage) and exceeds the 4 anchor, which implies coverage gaps; none are evident within the stated domain. It uses third person voice, so no person-penalty applies.

5 / 5

Completeness

The 'what' is clear (scanner, Slither ingestion, PoC generation, playbooks), but there is no 'Use when...' clause or equivalent explicit trigger guidance in the description, which caps completeness at 3 per the judging guidelines. Not a 2 because the 'what' is concrete and comprehensive, not vague.

3 / 5

Trigger Term Quality

Strong natural keywords: 'smart contract', 'Solidity', 'EVM', 'Slither', 'Foundry', 'DeFi', 'audit' — exactly what a user in this domain would say. Not a 5 because common variations like 'web3', 'blockchain', 'exploit', or 'security review' are absent.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (smart contract / EVM security auditing) with domain-specific triggers (Slither, Foundry, DeFi) that virtually no other skill type would claim, matching the 5 anchor's 'clear niche with distinct triggers; minimal conflict risk'.

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/standard/contracts/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.