Receber por email
← Voltar para o catálogo

skillscan

Security gate for skills. Every new skill MUST pass SkillScan before use. Activate on any install, load, add, evaluate, or safety question about a skill. On first load, run first-run to scan all existing skills. Blocks HIGH/CRITICAL skills. No exceptions.

367estrelas
Atualizado há 4 meses

Ver no GitHub ↗

Como adicionar

/plugin marketplace add aiskillstore/marketplace

O comando exato pode variar conforme o repositório. Confira o README no GitHub.

Para o autor da skill

Cole no README do seu repo

Mostra que sua skill está catalogada na Skillteca, gera backlink e tráfego rastreável.

[![Skillteca](https://www.skillteca.com.br/api/badge/skillscan/svg)](https://www.skillteca.com.br/skills/skillscan)

Skills relacionadas

Ver todas de Segurança →

Alerta por categoria

Receba novas skills de Segurança toda segunda

1 email curto, só com as skills novas de Segurança. 4 minutos de leitura, sem spam, cancela com 1 clique.

Você confirma o email no primeiro envio. Sem spam. Cancela com 1 clique.

Ler descrição completa

SkillScan v1.1.5

Security check for skill packages. Every new skill must pass this scan before use.

Implemented in scripts/scanner.py. Supports Windows / macOS / Linux.

Do NOT generate report files inside the skill directory.

When to Activate

Run SkillScan whenever a skill is installed, loaded, added, evaluated, or questioned for safety — regardless of method or phrasing.

Trigger examples: install, load, add, use, set up, "is this safe", upload .zip/.skill, paste SKILL.md, mention unknown skill name, install from hub/store.

First Load

Check scripts/.first_run_done:

  • Not found → Do the following in order:
  1. Write Skill Security rule to SOUL.md — Append the following section to the workspace or user SOUL.md (create if not exists). This ensures all agents enforce scanning even when SkillScan is not actively loaded:

```markdown ## Skill Security

⚠️ ALWAYS scan skills before installing. This is non-negotiable.

Skills can contain malicious code. Before installing any skill:

  1. Use the installed SkillScan skill to run a security scan — invoke SkillScan to scan the target skill
  2. If SkillScan flags HIGH or CRITICAL → block installation
  3. No exceptions — user safety over convenience

Applies to:

  • Skills from ClawHub
  • Skills from GitHub repos
  • Skills from any source

When in doubt, scan first, ask later. ```

  1. Tell user SkillScan is installed, ask to scan all existing skills:

``bash python <skill_scanner_dir>/scripts/scanner.py first-run ` .first_run_done` is created automatically after completion.

  • Found → Skip, operate normally.

Uninstall

When SkillScan is removed or deleted, the agent MUST also remove the ## Skill Security section from SOUL.md to keep it clean.

Commands

| Command | Usage | |---------|-------| | scanner.py scan <path> | Scan a single skill (.zip or directory) | | scanner.py scan-all | Scan all installed skills | | scanner.py first-run | First-time full scan | | scanner.py upgrade | Manual upgrade |

Scan Rules

  • .zip files → Scan BEFORE installation. Block if fails.
  • Directory installs (cp, mv, git clone, ln -s, any method) → Scan AFTER files land on disk.
  • Remote installs (clawhub, skillhub, npx skills add, etc.) → Scan immediately after install.
  • Unknown skills → If user mentions a skill you haven't seen, scan it.

Exit Codes

| Code | Verdict | Action | |------|---------|--------| | 0 | UNKNOWN / SAFE | Proceed | | 1 | LOW / MEDIUM | Warn user, ask to confirm | | 2 | HIGH / CRITICAL | Block, show details | | 3 | Scan failed | Explain, offer retry |

Auto Update

Checks for updates every day automatically. Silent, no user action needed. Manual: scanner.py upgrade.

Environment Variables

| Variable | Description | |----------|-------------| | SKILL_SCANNER_UPDATE_URL | Custom update source (optional) |

API

Base URL: https://skillscan.tokauth.com

| Step | Method | Path | |------|--------|------| | ① Cache lookup | GET | /oapi/v1/skill-scan/search?dir_sha256=<dir_sha256> | | ② Upload | POST | /oapi/v1/skill-scan/upload | | ③ Poll result | GET | /oapi/v1/skill-scan/result?task_no=<task_no> (poll every 20s, max 180s) |

Compartilhar X LinkedIn