SkillTrace banner
handcraftedbygod handcraftedbygod

SkillTrace

Development community

Description

Behavioral scanner for Claude Skills: sandboxes and traces what a skill actually does instead of trusting its description.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

🛡️ SkillTrace

![SkillTrace banner](https://raw.githubusercontent.com/handcraftedbygod/SkillTrace/main/docs/assets/cli-hero.png)

[![PyPI](https://img.shields.io/pypi/v/skilltrace)](https://pypi.org/project/skilltrace/) [![Downloads](https://img.shields.io/pypi/dm/skilltrace)](https://pypi.org/project/skilltrace/) [![CI](https://img.shields.io/github/actions/workflow/status/handcraftedbygod/SkillTrace/ci.yml?branch=main&label=tests)](https://github.com/handcraftedbygod/SkillTrace/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/github/license/handcraftedbygod/SkillTrace)](LICENSE) ![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue) ![Windows · macOS · Linux](https://img.shields.io/badge/platform-Windows%20%C2%B7%20macOS%20%C2%B7%20Linux-lightgrey)

**A defensive, behavioral scanner for agent skills — Claude, Cursor, and Codex — built to close the detection gap SkillCloak identified in static-only tools.**

A July 2026 academic paper ([arXiv:2607.02357](https://arxiv.org/abs/2607.02357), HKUST) disclosed **SkillCloak**: malicious Claude/Codex skills that hide payloads (self-extracting blobs, obfuscated instructions in `.git/`-style paths) and evade static scanners more than 90% of the time. It made Hacker News and thehackernews.com. Every "skill security" tool available at the time was static-analysis-only, which is exactly what the paper shows is bypassable.

Traditional malware scanners inspect code. An agent skill can carry out its entire attack as natural-language instructions that an agent reads and follows with its own already-granted tool access, no executable payload required at all. That changes the detection problem from binary inspection to behavioral verification. SkillTrace runs a candidate skill inside a disposable, network-sandboxed container and reports what it *actually* does: network destinations (including decrypted HTTPS host/path/body), subprocess spawns, and out-of-scope file access, instead of just trusting its