You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 4ae7c7b
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: README.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -934,13 +934,15 @@ SkillSpector uses a two-stage detection pipeline:
934
934
- High recall (catches most issues)
935
935
- Moderate precision (some false positives)
936
936
937
-
A valid, root-level OpenSSF Model Signing signature (`skill.oms.sig`) is retained in the
938
-
component inventory as type `oms_signature`, but excluded from static and LLM content analysis.
939
-
OMS bundles necessarily contain long base64-encoded payload, signature, and certificate fields;
940
-
generic obfuscated-code checks can otherwise misclassify those fields as hidden executable content.
941
-
The recognizer checks the minimal OMS DSSE/in-toto structure; it does not verify the signature,
942
-
certificate chain, transparency-log entry, or signer identity. Invalid or unrecognized signature
943
-
files are scanned normally.
937
+
OpenSSF Model Signing / DSSE bundles remain in content analysis, regardless of
938
+
filename. Static and LLM analyzers inspect decoded JSON payloads, readable DER
939
+
certificate/signature content, and all unknown wrapper fields. Strictly parsed
940
+
binary fields are projected rather than treated as executable base64; canonical
941
+
bytes remain available to YARA and fingerprints. Unsupported encodings (including
942
+
environments without the optional `cryptography` dependency) retain raw fields
943
+
and produce an explicit incomplete-analysis warning. Findings in decoded content
944
+
point to the original bundle and label their projection in evidence. None of this
945
+
verifies signatures, certificate chains, transparency logs, or signer identity.
944
946
945
947
### Stage 2: LLM Semantic Analysis (Optional)
946
948
- Evaluates context and intent
@@ -969,7 +971,7 @@ The tool requires outbound HTTPS access to `api.osv.dev` for live vulnerability
969
971
SkillSpector is defense-in-depth, not a sandbox. Know what it does and does not do before relying on it:
970
972
971
973
-**It never executes the scanned skill.** All analysis is static (regex, Python AST, YARA) plus optional LLM evaluation of file *contents* — the skill's code is never run.
972
-
-**LLM analysis sends analyzer-eligible file contents to the configured provider.** When LLM analysis is enabled (the default), file contents are sent to the active `SKILLSPECTOR_PROVIDER` endpoint. Recognized OMS signature files are excluded. Use `--no-llm` to keep contents local (static analysis only).
974
+
-**LLM analysis sends analyzer-eligible file contents to the configured provider.** When LLM analysis is enabled (the default), file contents are sent to the active `SKILLSPECTOR_PROVIDER` endpoint. DSSE payloads and readable signing metadata are included. Use `--no-llm` to keep contents local (static analysis only).
973
975
-**SC4 sends dependency names to OSV.dev.** The supply-chain check queries [OSV.dev](https://osv.dev) with the package names and versions the skill declares, to look up known CVEs. This is fundamental to the check and runs even with `--no-llm`. It sends dependency coordinates (not file contents), requires no API key, and falls back to a bundled list when OSV.dev is unreachable.
974
976
-**It does not sandbox the host.** SkillSpector flags risky patterns *before* you install a skill; it does not contain or isolate a skill you choose to install anyway.
Copy file name to clipboardExpand all lines: docs/DEVELOPMENT.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -81,7 +81,7 @@ All targets assume the virtual environment is **already created and activated**.
81
81
|`zip_bytes`, `mode`| Optional zip input and scan mode |
82
82
|`components`| List of relative file paths in the skill |
83
83
|`file_cache`| Map of path → file contents |
84
-
|`inspection_ledger`| Structured evidence for files excluded, skipped, or failed during analysis; a recognized OMS signature is recorded as an `oms_signature` scope exclusion. |
84
+
|`inspection_ledger`| Structured evidence for files excluded, skipped, or failed during analysis; unsupported DSSE decoding is recorded as an `oms_signature` partial event; successfully projected bundles remain in analysis without a scope exclusion. |
0 commit comments