Agent Skills Library

So you found a skill.

Before you install it, build confidence from independent evidence: provenance, complete contents, permissions, dependencies, security signals, reliability, and the path future updates will take.

Security · Pre-install checklist · Last reviewed August 19, 2026

01

Treat the candidate as untrusted

Review it in a read-only, isolated workspace. Do not run its scripts, install its dependencies, follow its own audit instructions, open shortened links, or provide secrets.

Stop condition

If you cannot inspect the complete versioned package before installation, do not install it.

Record the exact name, owner, registry, source URL, version or commit, release date, and hash first. Evidence only applies to the artifact it actually examined.

02

Check these sources, in order

  • Host and installer documentation: Confirm install location, visibility, precedence, sandboxing, permissions, secret handling, install hooks, update behavior, and rollback from the current primary documentation.
  • Registry listing and security details: Check publisher identity, ownership changes, versions, changelogs, moderation, user reports, and the exact version and date covered by every scan result.
  • Original source repository: Follow the registry provenance link. Compare owners, tags or commits, contents, and hashes; then inspect maintenance, security issues, license, and release history.
  • Complete skill package: Read SKILL.md and every referenced file, script, configuration, active asset, hook, and nested archive. Inventory commands, files, tools, credentials, downloads, and network destinations.
  • Dependencies and artifacts: Resolve direct and transitive dependencies, check official registries and advisories, verify downloaded binaries, and flag unversioned or runtime-fetched code and instructions.
  • Independent security analysis: Scan the exact staged version with a reputable skill scanner. For higher-risk skills, use different scanner approaches and reconcile their findings rather than trusting a score.
  • Primary product and API documentation: Verify each claimed command, permission, and workflow with the providers the skill controls. Reject broader access or infrastructure that the actual task does not need.
  • Organizational evidence: Check internal policy, approved endpoints, data classification, prior reviews, and required approvals. Name an owner for updates, incidents, re-review, and removal.

03

Pass security and reliability gates

A listing badge, install count, official-looking name, or clean scanner result is one signal—not a certificate.

  • The purpose is recurring and useful enough to justify another trust boundary.
  • Publisher, source, artifact, version, and hashes form a consistent provenance chain.
  • Files, tools, network access, credentials, and scopes follow least privilege.
  • Data destinations, retention, logging, and telemetry are understood and acceptable.
  • Actual instructions, scripts, dependencies, and network behavior match the listing.
  • Failure, retries, cancellation, and malformed input do not create broader actions or data loss.
  • Compatibility and observable tests cover the intended host, runtime, operating system, and scope.
  • Independent scans and human review are resolved for the exact approved version.

04

Will it update automatically?

Verify every update layer. Read the host and installer docs; identify whether this is a managed marketplace install, registry install, Git source, or copied folder; inspect origin records, lockfiles, versions, hashes, channels, and pin state; then search scheduled tasks, CI, startup hooks, and agent instructions for update commands.

Also check runtime fetches. A skill can remain unchanged on disk while downloading new instructions or code whenever it runs.

Classify the result

Automatic, command-triggered, pinned/locked, untracked/manual, dynamic at runtime, or unresolved. Do not install while the update path is unresolved.

Current OpenClaw documentation uses an explicit openclaw skills update --all command for registry-managed skills and records their origin for later updates. Git and local skills are refreshed by reinstalling them. That package layer is command-triggered unless a person, agent, startup hook, CI workflow, or scheduler runs the command automatically.

Before every update, diff the complete old and new packages, permissions, dependencies, and destinations; re-run review and scans; and preserve the approved artifact and rollback path.

05

Make an evidence-backed decision

Approve for a sandbox, approve an exact version with controls, rewrite the useful workflow internally, or reject it. Record the owner, approver, scope, evidence, open findings, update classification, pin or lock, rollback plan, and next review date.

Confidence belongs to a specific artifact, scope, and moment—not to a skill name forever.

Use the checklist

The guide explains why. This shorter working checklist keeps the decisions and stop conditions you need while reviewing a real skill.

32 checks

Safety rule

  1. Capture the exact candidate

    Tie every finding to one artifact and one intended use.

  2. Inspect the complete package

    Read what will actually be installed, not only the listing or SKILL.md.

  3. Verify trust and access

    Independent evidence should agree about who published the skill and what it can reach.

  4. Scan and test independently

    A scanner is one input to a review, not the decision.

  5. Understand every update path

    A fixed folder can still change behavior through automation or runtime downloads.

  6. Decide and record

    Approval belongs to a specific artifact, scope, and moment—not to a skill name forever.

Raise the bar for high-risk access

For access to sensitive data, money, production systems, messaging, identity, or destructive tools, require a named human approver, organizational policy checks, stronger isolation, and more than one review method.

Choose one outcome

Sandbox only
Use low-value data, least privilege, monitoring, and no production credentials.
Approve with controls
Approve one version or hash, restricted scope, a named owner, update review, monitoring, and rollback.
Rewrite internally
Keep the useful workflow when third-party provenance, permissions, or maintenance are insufficient.
Reject
Stop for unresolved provenance, hidden behavior, excess privilege, risky data handling, material findings, no rollback, or unknown update behavior.
Copy the evidence record
Skill and publisher:
Registry and source URLs:
Approved version, commit, and hash:
Intended host, scope, and purpose:
Files, scripts, dependencies, and binaries reviewed:
Permissions, credentials, and data handling:
Network destinations and runtime fetches:
Scanner names, versions, dates, and results:
Reliability and compatibility evidence:
Update classification and evidence:
Controls, monitoring, and rollback:
Open findings:
Decision, approver, owner, and review date:

Take it with you

Download the same checklist as Markdown for an agent, repository, review ticket, or notes app.

Download the Markdown checklist ↓

Primary references

← Back to the resource library