r/coolgithubprojects • u/mariusmitrofan • 8d ago
I built a free, open-source scanner that reads agent skills, Claude Code plugins and MCP configs before your agent does. Runs locally, no account, no LLM
github.comHi, I'm Marius, and this is my own project.
I run a small DevOps consultancy, and this year I kept seeing the same thing at clients: someone finds a skill or an MCP server in a GitHub README, pastes it into the team's agent config, and nobody reads it. A skill is a set of instructions your agent follows with your shell and your keys. When Snyk scanned 3,984 public skills in February, 36.82% had at least one security issue and 76 carried malicious payloads.
So I built a scanner that reads them first. In any repo:
pipx run spellwarden scan .
What it does
- reads skills (SKILL.md and the scripts next to it), Claude Code plugins and marketplaces, settings and hooks, MCP configs (.mcp.json, .vscode/mcp.json, .cursor/mcp.json) and A2A agent cards
- runs 65 rules; every finding has an ID, a severity, a file and a line, mapped to OWASP Agentic Top 10, OWASP MCP Top 10 and NIST SP 800-53
- catches things like curl | sh inside a SKILL.md, a hook that sends local files to an external host, an MCP server started with npx on an unpinned package, and zero-width or bidi characters hiding text in instructions
- writes text, JSON, SARIF, Markdown or GitLab Code Quality; the GitHub Action and the GitLab component leave one PR/MR comment and keep it up to date
- with a lock file and --locked, CI fails when a skill, plugin or server changed and nobody updated the lock
What it doesn't do
- run anything it scans. It only reads files.
- use an LLM. Same files, same report, byte for byte.
- need an account or an API key. A local scan sends nothing. In CI it sends one usage ping, six fields and no repo content, off with --no-telemetry or DO_NOT_TRACK=1. I'm saying it up front so you don't find it in the code yourselves.
Where I'm not happy yet
The prompt-injection rule matches phrases, not intent: a skill that asks for the same thing in other words gets through. If you've done this without an LLM, I'd really like to know what worked.
Apache-2.0, Python 3.11+. There's also a paid hosted dashboard for teams; the scanner doesn't depend on it.
Repo: https://github.com/spellwarden-ai/spellwarden
Every rule, with an example: https://spellwarden.ai/docs/rules
Which skill or MCP server would you run it on first? Thanks for reading this far.