Methodology

public · how assets are evaluated

How Vettd evaluates AI assets.

01

Structure

Vettd examines the submitted package or repository for required files, naming conventions, documentation completeness, and the presence of expected directories.

02

Security

Static analysis looks for credential exposure, unsafe shell patterns, metadata endpoint probing, name-squatting signals, and multi-step attack chains.

03

Safety

Each finding carries a severity. The severity levels, and the thresholds that compute a grade from them, are listed below.

High level by design

This page describes the categories of evidence Vettd looks at, the thresholds used to assign letter grades, and the severity levels applied to findings.

Evidence-based, not absolute

Vettd analyzes submitted packages, repository content, and scan data available at the time of submission. A scan with no findings is inconclusive, not a pass.

What these five agentic asset types mean. Repository is a separate directory kind.

skillSkill

A packaged instruction set an agent loads to do a task: a SKILL.md plus optional scripts and references.

PromptPrompt

A reusable instruction or template you hand to a model.

MCP serverMCP server

A service that exposes tools or data to an agent over the Model Context Protocol.

AgentAgent

A model-driven worker that you configure with a model, instructions, and tools, then run to do a task. It is not a harness or a runtime.

AppAgentic app

A multi-agent application: several agents orchestrated together, often deployed as a service.

Every signal shown on the site belongs to one of these categories. The category decides how the signal is judged, not how much data we happen to have.

SafetyGraded

Security and structural defects; whether something is wrong

Reliability & QualityGraded

Whether it works, and whether it is well made

PerformanceMeasured

How heavy it is to run, per invocation

CostMeasured

What it costs to run over time, based on the services and environment it declares today

CompatibilityUnjudged

What it needs to run, including dependencies, tools, and environment, and where it may conflict

PopularityUnjudged

Public repository reputation statistics

CharacteristicsUnjudged

Neutral descriptors such as license, language, and archived state

A shape is what kind of claim a signal is. Five shapes can be produced by a rule; absence is a display state, not a produced signal. The most useful question is not how big the number is but whether a change in it is real.

MeasurementReproducible under the stated method

An exact value produced by a stated method

EstimateNot reproducible; it can move from sampling noise alone

A statistic over samples

FactDirectly read from the artifact

A neutral descriptor read directly off the artifact

ClassificationNot reproducible; a judgment

A bucket assigned by inference, with a confidence

FindingNot applicable; a judgment

Something wrong; the only shape that obligates action

AbsenceNot applicable

Not assessed; assessed with nothing found; or a notice about the assessment itself

Popularity figures are public repository statistics. They are context and can change on their own, without the asset changing.

Vettd reports where each signal came from. Not every source is active yet.

ScanLive

Deterministic analysis of the submitted artifact

ResearchLive

Public repository data gathered from the web

EvaluationPlanned

Model-driven assessment of how it behaves, by simulating execution

Grades are computed from findings that carry a severity. Both Safety and Reliability & Quality are graded categories: each produces its own letter grade, computed independently from its own findings by the thresholds below. Info findings never count. Categories judged as measured or unjudged do not produce a grade. Thresholds are evaluated in order from F to A; the first tier whose condition is met wins.

A

Low-severity findings only (fewer than 4 lows)

No medium, high, or critical findings in this category, and fewer than four lows.

B

4 or more lows, or any medium present (fewer than 3 mediums)

Pattern-level findings with no confirmed data flow to a vulnerability, or at least one known weakness class.

C

3 or more mediums, or any high present (fewer than 3 highs)

One or more findings with conditional exploitability, or serious harm conditional on an additional factor.

F

3 or more highs, or any critical present

At least one critical finding, or three or more high findings in the category.

Each finding is assigned one of five severity levels. Severity decides whether a finding counts toward a grade: info findings never do, and every other level feeds the grade for its category.

critical

Adversarial intent, or a pattern that fires unconditionally in the context where it appears, with no exploitability preconditions.

high

Serious harm, but conditional on one more factor: caller-controlled input reaching the vulnerable operation, a specific environment, or a permissive configuration.

medium

A known weakness class with conditional exploitability, limited impact in isolation, or meaningful false-positive risk.

low

A heuristic match only. It has a high false-positive rate and no confirmed data flow to a vulnerability.

info

An observation with no direct harm path that does not contribute to a grade.

Skills

8 checks

For public skills in the directory, Vettd evaluates package structure, documentation quality, and security signals. It looks at signals both in isolation and as sequences, because the difference between a careless mistake and an intentional attack is often visible in the chain of behaviors, not any single one.

What Vettd looks at

  • Whether required structure is present, such as SKILL.md and supporting directories like scripts, references, assets, or evals.
  • Whether the description is clear enough to explain what the skill does and when it should be used.
  • Whether the instructions appear to include concrete workflow guidance, examples, validation steps, or checklists.
  • Whether the package contains security red flags like embedded secrets, unsafe shell patterns, destructive commands, or environment files that should not ship.
  • Whether scripts access known credential file paths such as cloud provider credentials, SSH private keys, or container registry configs.
  • Whether scripts probe cloud instance metadata endpoints, which have no legitimate use in a skill and are a known credential-theft vector.
  • Whether the skill name is suspiciously close to a known popular skill, which is a common pattern in supply-chain attacks.
  • Whether any dangerous signals form a chain (credential access followed by encoding and outbound transmission, or remote code fetched and piped to a shell) that suggests intentional attack design rather than negligent coding.

Why it matters

  • These checks help users judge whether a skill looks maintainable, testable, and safe to install.
  • They separate well-documented submissions from packages that need more scrutiny before use.
  • A well-documented skill can still be harmful if it ships credentials or unsafe commands, so security signals matter as much as documentation quality.
  • Treating every dangerous API as equally suspicious produces too much noise. A skill that calls eval() is not the same as one that fetches remote code, decodes it from base64, and executes it on install. Vettd tries to surface that difference.
A skill score reflects the evidence visible in the submitted package. It is not a guarantee of safety in every environment.

Framework labels in the directory are reference context. They indicate which standards a submitter or reviewer is using, not automated end-to-end compliance certifications.

OWASP

A broad application security reference used to reason about common software and web risk patterns.

NIST 800-53

A large control catalog for security and privacy programs, frequently used in regulated or enterprise environments.

CMMC

A maturity model used in the defense industrial base to assess cybersecurity practices and process rigor.

ISO 42001

An AI management system standard focused on governance, accountability, risk management, and organizational controls for AI.

EU AI Act

A regulatory framework that classifies AI use cases by risk and imposes obligations based on how the system is used.

CISA

A practical security reference point associated with US cyber defense guidance, advisories, and operational best practices.

Vettd analyzes the submitted artifact and public repository data. It does not run the asset or observe runtime behavior, and signals are only as fresh as the last scan or import.

What Vettd does not check