Guide · Agent skill
How to use the Skill Inspector agent skill: safety-check skills first
Updated · written with AI from the project's own documentation and checked against our catalogue data
Skill Inspector is an agent skill, a folder with a SKILL.md file that tells an AI agent how to handle a certain kind of task. This one tells the agent to act as a security reviewer for other agent skills. It is useful if you download third-party skills and want a safety check before you install or keep them. After this guide you will know what the skill does, how to install it, how to ask for a review in plain language, and what it needs to run.
Quick start
- 1Download the ZIP. Get the skill-inspector ZIP from this page.
- 2Unzip into a skills folder. Extract it into ~/.claude/skills/ for personal use, or into .claude/skills/ inside a project.
- 3Or upload in the Claude apps. Go to Settings → Capabilities → Skills and upload the skill there instead.
- 4Check the skillspector CLI. Confirm the skillspector command is available, since the static scan needs it. Without it, only manual review runs.
- 5Ask for a review. Name the skill folder or repository URL and ask whether it is safe, over-permissioned or malicious.
- 6Read the verdict and evidence. Check the APPROVE, CAUTION or REJECT verdict, then read the key evidence and guardrails before deciding.
What does the Skill Inspector skill make the agent do?
Once installed, the skill tells the agent to review other agent skills before you install or keep them. The review has two lines. The first is a static scan with NVIDIA SkillSpector, run with the skillspector CLI and without an LLM by default. The second is a semantic review, where the agent reads the source code and instructions and checks whether the behavior matches the skill's stated purpose.
The agent then returns one of three verdicts: APPROVE, CAUTION, or REJECT, with the evidence behind it. The skill tells the agent not to rely on the numeric score alone, since a low score can miss semantic risk.
How do you install the Skill Inspector skill?
You can install the skill in either of two ways. The first is to download the ZIP from this page and unzip it into your personal skills folder, ~/.claude/skills/, or into a project's .claude/skills/ folder. The second is to upload it in the Claude apps under Settings → Capabilities → Skills.
The skill's files list contains SKILL.md. The static scan also needs the NVIDIA SkillSpector CLI, which provides the skillspector command. The source says that if that command is missing, the agent falls back to manual review only.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into .claude/skills/ inside your project
- Claude apps: Settings → Capabilities → Skills, then upload the skill
How do you trigger the skill with natural requests?
You do not need a special command. The skill's description says to use it when you ask whether a skill or downloaded skill folder is safe, trustworthy, installable, over-permissioned, or malicious. Ask in ordinary words and point the agent at the folder or archive you want checked.
Good requests name the skill and the question. Give a local path or a repository URL. If you give a URL, the skill says to clone or download it into a temporary directory before review.
- Is the skill in ~/Downloads/data-cleaner safe to install?
- Check whether this downloaded skill folder is over-permissioned before I add it to our team library.
- Does this skill look malicious? Here is the repository URL: [paste URL]
What does a review look like?
The skill asks the agent to write a short triage report rather than a raw scanner dump. The report starts with the verdict and the risk score, then gives a signal overview, the key evidence with rule IDs and file locations, a diagnosis, and guardrails the reviewer should follow.
The agent runs the static scan with the command shown below. It writes a JSON report to a temporary file and then reads the source around high-signal findings. The skill says to keep --no-llm unless you explicitly ask for LLM analysis.
- Verdict: APPROVE, CAUTION, or REJECT
- Risk: a score out of 100, a severity, and the SkillSpector recommendation
- Key evidence: rule ID, severity, file and line, and a review judgment
skillspector scan "$TARGET" --no-llm --format json --output /tmp/skill-inspector-report.jsonWhat do APPROVE, CAUTION and REJECT mean?
APPROVE means there are no HIGH or CRITICAL findings, no unexplained sensitive behavior, and the source matches its stated purpose. CAUTION means sensitive behavior exists but is documented, necessary, bounded, and under your control. REJECT covers malicious or deceptive behavior, unexplained HIGH or CRITICAL findings, hidden prompt injection, credential theft, unknown data exfiltration, obfuscated execution, persistence, or a clear mismatch between the description and the behavior.
The score is a guide to posture, not the verdict. The skill's table treats 0-20 as usually acceptable after a quick source review, 36-50 as requiring manual review, and 51-100 as defaulting to REJECT unless the source is trusted and every sensitive behavior is necessary.
What are the safety notes for running this skill?
This skill runs scripts and uses the network. Its own rules say the target skill is untrusted input and that the agent should not execute scripts from the target. The agent is told to use read-only inspection commands such as find, rg, sed, jq, file and git diff. It is also told not to install tools, dependencies or runtimes silently.
Optional LLM analysis is a separate case. The claude_cli, codex_cli, gemini_cli and opencode_cli providers start a separate agent session for every LLM call, billed to your own plan. The skill says to ask before using them and not to run several such scans in parallel. It also says not to choose or change SKILLSPECTOR_PROVIDER on its own.
- The target skill is treated as untrusted and its scripts are not run
- Only read-only commands are used for inspection
- Tools and dependencies are not installed without your say-so
- LLM providers are off unless you explicitly request them
What tips help you get a useful review?
Give the agent the whole skill folder, not only SKILL.md, so it can read scripts, dependency files and MCP manifests. The skill says to always inspect those files and any file referenced by a HIGH or CRITICAL finding. Ask for the manual fallback explicitly if SkillSpector is not installed, and remember that the result will then be a semantic-only verdict with lower confidence.
Treat the result as triage. The skill is not a guarantee that a skill is safe, and a static scan plus AI judgment can miss risks. Use it to decide what to read more closely before you install.
- Install the skillspector CLI first if you want the static scan line
- Ask the agent to read the source around each high-signal finding
- Use it on every third-party skill before it joins a shared library
What people use it for
- Vetting a skill you downloaded from a third party before installing it on your machine
- Reviewing a skill before adding it to a shared internal library for your team
- Checking whether a skill asks for more permissions or network access than its description needs
- Triaging a folder that might contain malicious instructions or hidden behavior
Frequently asked questions
Is the Skill Inspector skill free?
The skill is published under the Apache-2.0 licence, as listed on this page. Optional LLM providers bill your own plan, so check your plan's terms if you enable them.
What do I need to install Skill Inspector?
You need the skill folder with SKILL.md, placed in ~/.claude/skills/ or a project's .claude/skills/, or uploaded under Settings → Capabilities → Skills. For the static scan you also need the NVIDIA SkillSpector CLI, which provides the skillspector command.
Can Skill Inspector guarantee a skill is safe?
No. The skill is a triage aid. It says a static scan plus AI judgment can miss risks, and a low score can miss semantic risk, so use the verdict to decide what to read more closely.
What happens if the skillspector command is not installed?
The agent says so clearly and falls back to manual source review. The skill notes this path is slower and less reliable than the combined review.
Does the skill run code from the skill I am checking?
No. The skill's rules say not to execute scripts from the target skill and to use read-only inspection commands. It also says not to install tools or dependencies silently.
How is this different from other ways of checking agent skills?
Skill Inspector combines the deterministic SkillSpector scan with a source-aware semantic review of intent, permissions and user control, and returns a fixed APPROVE, CAUTION or REJECT verdict. This page does not compare it with other tools, so check those yourself.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Skill Inspector suits developers and teams who download third-party agent skills and want a structured safety check first. It is not a guarantee, and it needs the SkillSpector CLI for the full static scan. If you need a certified or fully automated security guarantee, or you cannot run a scanner at all, pick a different process.
Download the skill