Przejdź do treści
Biblioteka skilli
Bezpieczeństwo · Przegląd i audyt

scv-scan

/scv-scan

Audytuje kod Solidity pod kątem 36 klas podatności w czterofazowym procesie: od listy kontrolnej po raport. Przydaje się przy przeglądzie kontraktów inteligentnych przed wdrożeniem.

Repozytorium
skills-curated ↗
Licencja
CC-BY-SA-4.0
Ostatnia zmiana repozytorium
14.07.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
38
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 14.07.2026, bez odwołań do wycofanych modeli i API.

Licencja

CC-BY-SA-4.0, otwarta.

Co robi i kiedy

Audytuje kod Solidity pod kątem 36 klas podatności w czterofazowym procesie: od listy kontrolnej po raport. Przydaje się przy przeglądzie kontraktów inteligentnych przed wdrożeniem.

Oryginalny opis (EN)

Audits Solidity codebases for smart contract vulnerabilities using a four-phase workflow (cheatsheet loading, codebase sweep, deep validation, reporting) covering 36 vulnerability classes. Use when auditing Solidity contracts for security issues, performing smart contract vulnerability scans, or reviewing Solidity code for common exploit patterns.

Jak działa

  1. When to Use
  2. When NOT to Use
  3. Rationalizations to Reject
  4. Reference Structure
  5. Audit Workflow
  6. Severity Guidelines
  7. Key Principles
Sekcje z nagłówków SKILL.md, w oryginale · 142 linii, 958 słów
Podgląd SKILL.md
---
name: scv-scan
description: "Audits Solidity codebases for smart contract vulnerabilities using a four-phase workflow (cheatsheet loading, codebase sweep, deep validation, reporting) covering 36 vulnerability classes. Use when auditing Solidity contracts for security issues, performing smart contract vulnerability scans, or reviewing Solidity code for common exploit patterns."
allowed-tools:
  - Read
  - Grep
  - Glob
  - Bash
  - Write
  - Task
---

# Smart Contract Vulnerability Auditor

Systematically audit a Solidity codebase for vulnerabilities using a four-phase approach that balances thoroughness with efficiency.

## When to Use

- Auditing a Solidity codebase for security vulnerabilities before deployment
- Reviewing smart contract code for common exploit patterns (reentrancy, overflow, access control, etc.)
- Performing a structured vulnerability scan across an entire Solidity project
- Validating that a contract follows security best practices after modifications

## When NOT to Use

- Auditing non-Solidity smart contracts (Vyper, Rust/Anchor, Move) — patterns are Solidity-specific
- Reviewing off-chain code (JavaScript, TypeScript backends) — use general security review instead
- When the user only wants gas optimization or code style feedback — this focuses on exploitable vulnerabilities
- For formal verification of invariants — use tools like Certora, Halmos, or Echidna instead

## Rationalizations to Reject

- "The compiler version is >=0.8.0 so overflow isn't possible" — `unchecked` blocks, assembly, and type downcasts still wrap
- "It uses OpenZeppelin so it's safe" — integration bugs, incorrect inheritance order, and missing modifiers on custom functions are common
- "That function is internal so it can't be exploited" — internal functions called from external entry points inherit the caller's context
- "There's no ETH involved so reentrancy doesn't apply" — ERC721 `_safeMint`, ERC1155 safe transfers, and ERC777 hooks all trigger callbacks
- "The contract is upgradeable so we can fix it later" — `initialize()` without `initializer` modifier is itself a critical vulnerability

## Reference Structure

```
references/
  CHEATSHEET.md          # Condensed pattern reference — always read first
  reentrancy.md          # Full reference files — read selectively in Phase 3
  overflow-underflow.md
  ...
```

Each full reference file in `references/` has these sections:

- **Preconditions** — what must be true for the vulnerability to exist
- **Vulnerable Pattern** — annotated Solidity anti-pattern
- **Detection Heuristics** — step-by-step reasoning to confirm the vulnerability
- **False Positives** — when the pattern appears but isn't exploitable
- **Remediation** — how to fix it

## Audit Workflow

### Phase 1: Load the Cheatsheet

**Before touching any Solidity files**, read `{baseDir}/skills/scv-scan/references/CHEATSHEET.md` in full.

This file contains a condensed entry for every known vulnerability class: name, what to look for (syntactic and semantic), and default severity. Internalize these patterns — they are your detection surface for the sweep phase. Do NOT read any full reference files yet.

### Phase 2: Codebase Sweep

Perform two complementary passes over the codebase.

#### Pass A: Syntactic Grep Scan

Search for the trigger patterns listed in the cheatsheet under "Grep-able keywords". Use grep or ripgrep to find matches.

For each match, record: file, line number(s), matched pattern, and suspected vulnerability type(s).

#### Pass B: Structural / Semantic Analysis

This pass catches vulnerabilities that have no reliable grep signature. Read through the codebase searching for any relevant logic similar to that explained in the cheatsheet.

For each finding in this pass, record: file, line number(s), description of the concern, and suspected vulnerability type(s).

#### Compile Candidate List

Merge results from Pass A and Pass B into a deduplicated candidate list. Each entry should look like:

```
- File: `path/to/file.sol` L{start}-L{end}
- Suspected: [vulnerability-name] (from CHEATSHEET.md)
- Evidence: [brief description of what was found]
```

### Phase 3: Selective Deep Validation

For each candidate in the list:

1. **Read the full reference file** for the suspected vulnerability type (e.g., `{baseDir}/skills/scv-scan/references/reentrancy.md`). Read it now — not before.
2. **Walk through every Detection Heuristic step** against the actual code. Be precise — trace variable values, check modifiers, follow call chains.
3. **Check every False Positive condition**. If any false positive condition matches, discard the finding and note why.
4. **Cross-reference**: one code location can match multiple vulnerability types. If the cheatsheet maps the same pattern to multiple references, read and validate against each.
5. **Confirm or discard.** Only confirmed findings go into the final report.

### Phase 4: Report

For each confirmed finding, output:

```
### [Vulnerability Name]

**File:** `path/to/file.sol` L{start}-L{end}
**Severity:** Critical | High | Medium | Low | Informational

**Description:** What is vulnerable and why, in 1-3 sentences.

**Code:**
```solidity
// The vulnerable code snippet
```

**Recommendation:** Specific fix, referencing the Remediation section of the reference file.
```

After all findings, include a summary section:

```
## Summary

| Severity | Count |
|----------|-------|
| Critical | N     |
| High     | N     |
| Medium   | N     |
| Low      | N     |
| Info     | N     |
```

Write the final report to `scv-scan.md`.

## Severity Guidelines

- **Critical**: Direct loss of funds, unauthorized fund extraction, permanent freezing of funds
- **High**: Conditional fund loss, access control bypass, state corruption exploitable under realistic conditions
- **Medium**: Unlikely fund loss, griefing attacks, DoS on non-critical paths, value leak under edge conditions
- **Low**: Best practice violations, gas inefficiency, code quality issues with no direct exploit path
- **Informational**: Unused variables, style issues, documentation gaps

## Key Principles

- **Cheatsheet first, references on-demand.** Never read all full reference files upfront. The cheatsheet gives you ambient awareness; full references are for validation only.
- **Semantic > syntactic.** The hardest bugs don't grep. Cross-function reentrancy, missing access control, incorrect inheritance — these require reading and reasoning, not pattern matching.
- **Trace across boundaries.** Follow state across function calls, contract calls, and inheritance chains. Hidden external calls (safe mint/transfer hooks, ERC-777 callbacks) are as dangerous as explicit `.call()`.
- **One location, multiple bugs.** A single line can be vulnerable to reentrancy AND unchecked return value. Check all applicable references.
- **Version matters.** Always check `pragma solidity` — many vulnerabilities are version-dependent (e.g., overflow is checked by default in >=0.8.0).
- **False positives are noise.** Be rigorous about checking false positive conditions. A shorter report with high-confidence findings is more valuable than a long one padded with maybes.
Pliki w paczce (38)
  • SKILL.md 7 KB
  • references/CHEATSHEET.md 18 KB
  • references/arbitrary-storage-location.md 2 KB
  • references/assert-violation.md 2 KB
  • references/asserting-contract-from-code-size.md 2 KB
  • references/authorization-txorigin.md 2 KB
  • references/delegatecall-untrusted-callee.md 2 KB
  • references/dos-gas-limit.md 2 KB
  • references/dos-revert.md 3 KB
  • references/hash-collision.md 2 KB
  • references/inadherence-to-standards.md 3 KB
  • references/incorrect-constructor.md 2 KB
  • references/incorrect-inheritance-order.md 2 KB
  • references/insufficient-access-control.md 2 KB
  • references/insufficient-gas-griefing.md 3 KB
  • references/lack-of-precision.md 2 KB
  • references/missing-protection-signature-replay.md 2 KB
  • references/msgvalue-loop.md 3 KB
  • references/off-by-one.md 2 KB
  • references/outdated-compiler-version.md 2 KB
  • references/overflow-underflow.md 2 KB
  • references/reentrancy.md 3 KB
  • references/requirement-violation.md 3 KB
  • references/shadowing-state-variables.md 3 KB
  • references/signature-malleability.md 2 KB
  • references/timestamp-dependence.md 3 KB
  • references/transaction-ordering-dependence.md 3 KB
  • references/unbounded-return-data.md 3 KB
  • references/unchecked-return-values.md 2 KB
  • references/unencrypted-private-data-on-chain.md 3 KB
  • references/unexpected-ecrecover-null-address.md 2 KB
  • references/uninitialized-storage-pointer.md 2 KB
  • references/unsafe-low-level-call.md 2 KB
  • references/unsecure-signatures.md 3 KB
  • references/unsupported-opcodes.md 3 KB
  • references/unused-variables.md 3 KB
  • references/use-of-deprecated-functions.md 3 KB
  • references/weak-sources-randomness.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie scv-scan.

Migawka bazy z 13.11.2026 · wersja paczki 01792e6ef81e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 95solidity-security
    Podpowiada bezpieczne wzorce w Solidity i sprawdza kontrakty pod kątem znanych błędów przed wdrożeniem.
  • 100solidity-security
    Podpowiada dobre praktyki bezpieczeństwa smart kontraktów, żeby zapobiegać typowym podatnościom przy pisaniu i audycie.
  • 100scan
    Szybko skanuje kontrakty Solidity pod kątem podatności opisanych w audytach DeFi, przed audytem albo przy przeglądzie kodu.
  • 100solidity-security
    Uczy zasad bezpiecznych kontraktów w Solidity, pomaga przy audycie istniejących kontraktów i wdrażaniu zabezpieczeń przed typowymi podatnościami w aplikacjach blockchain.
  • 95solidity-security
    Opisuje dobre praktyki bezpieczeństwa smart kontraktów w Solidity, które zapobiegają typowym podatnościom, przy pisaniu kontraktów, ich audycie i wdrażaniu zabezpieczeń.
  • 100audit
    Przegląda kontrakty Solidity i EVM pod kątem podatności, testując hipotezy i zapisując raport w Markdown i JSON.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.