rafter-skill-review

Vet third-party SKILL.md files and agent configs for malware, prompt injection, and data exfiltration before installation.

27|13|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/Raftersecurity/rafter-cli --skill rafter-skill-review-raftersecurity
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rafter-skill-review
Source: https://github.com/Raftersecurity/rafter-cli/tree/main/python/rafter_cli/resources/skills/rafter-skill-review
Command: npx skills add https://github.com/Raftersecurity/rafter-cli --skill rafter-skill-review-raftersecurity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Installing a third-party agent skill grants it Read, Bash, and network access under your identity, yet most users install skills without any security review. This Skill gates that decision by combining a deterministic CLI scan with structured manual review checklists so malicious or leaky skills are caught before they run. ## Core Features & Use Cases - Deterministic first pass: Runs rafter skill review against a local path or git URL to extract secrets, URLs, high-risk shell patterns, obfuscation signals, and frontmatter tool grants into a JSON report. - Branch-specific review playbooks: Provides separate workflows for new installs, updates to trusted skills, and investigations of suspicious skills, each pointing to focused sub-docs on provenance, malware indicators, prompt injection, data practices, telemetry, and changelog diffs. - Use Case: Before installing a community SKILL.md from GitHub, run the review command, then walk the authorship-provenance and prompt-injection checklists to confirm the author is legitimate, no hidden instructions exist, and allowed-tools matches the stated purpose. ## Quick Start Ask the agent to vet a third-party skill before installing it, for example: review the skill at ./third-party-skill/ and tell me whether it is safe to install.

Frequently Asked Questions about rafter-skill-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a third-party SKILL.md is safe to install?▼

Run `rafter skill review <path-or-git-url>` to get a JSON report of secrets, URLs, and risky shell patterns, then walk the review branch matching your situation. A clean exit code is necessary but not sufficient; prompt injection and provenance issues require the manual checklists.

How to review a skill update before overwriting an installed version?▼

Diff the old and new versions, then re-check any changes to allowed-tools, outbound URLs, shell invocations, and filesystem writes using the changelog-review checklist. Maintainer transfers or republished packages reset trust and require full re-review as a new install.

Can a clean scan result guarantee a skill is safe?▼

No. The deterministic pass only catches regex-visible issues like secrets and high-risk commands. Prompt injection, hidden instructions, authorship fraud, and telemetry leaks are invisible to scanning, so the manual sub-doc checklists are always required.

What prompt injection signs should I look for in a SKILL.md?▼

Check for zero-width or bidi-override characters, HTML comments with imperative text, phrases like "ignore previous instructions" outside code fences, and unpinned WebFetch URLs. Any single confirmed injection vector is grounds to reject the skill.

When should I reject a skill instead of installing it?▼

Reject when obfuscated code, binary blobs, postinstall scripts, credential-path reads, or live unpinned fetches appear, or when allowed-tools exceeds the stated purpose. Also reject on recent ownership transfers combined with sudden version bumps.