Ark

This site is private. Enter the password to continue.

docs / cli / audit

ark audit

Evaluate your package against Ark's quality dimensions and receive a score, a verdict, and a price range. The audit is the gateway to publishing.

Syntax

Usage
ark audit [--static | --full]

Flags

FlagDefaultDescription
--statictrueStatic analysis only — free, instant, no Claude tokens
--fullfalseFull analysis including D6 Value (uses Claude — billed to creator)

Type-aware profiles (v0.2)

The audit adapts its expectations based on your package type in ark.json:

TypeCLAUDE.mdInstallertemplate/
osExpected in template/RequiredExpected
systemRequired at rootOptionalNot expected
agentRequired (anywhere)OptionalNot expected
skillNot requiredOptionalNot expected
bundleRequired (anywhere)OptionalNot expected

Static audit (default)

Runs D1–D5 using file analysis only. Free and instant. Required score: 60.

Terminal
$ ark audit --static

  Ark Audit — my-agent v1.0.0
  Mode: static | Profile: agent

   Structure        18/20
   Security         20/20
   Code Quality     16/20
   Completeness     13/15
   Robustness       11/15
  ─────────────────────────────────────
  Total               78/100

  Verdict: Certified
  Price range: $35 — $49

  Issues (1)

  LOW  Network calls found without timeout handling
       → Add --max-time (curl) or AbortSignal.timeout (fetch)
Smart detection. The auditor excludes _archive/ directories, filters false-positive secrets (env var references, placeholders), and contextualizes eval usage by risk level.

Full audit

Adds D6 Value evaluation using Claude. Evaluates originality, domain specificity, and documentation quality. Uses tokens from your creator account.

Terminal
$ ark audit --full --save

  Running full audit (D1–D6)...
  D6 uses Claude — estimated cost: $0.04

  D1 Structure        18/20
  D2 Security         19/20
  D3 Code Quality     16/20
  D4 Completeness     13/15
  D5 Robustness       11/15
  D6 Value             8/10    domain-specific, well-documented
  ─────────────────────────────────────
  Total               85/100

  Verdict: Certified
  Price range: $49 — $65

   Report saved: audit-report.json (hash: sha256:a3f7...)
--save is required for ark publish. The report is attached to your submission and verified by hash. The registry will reject packages with a missing or tampered report.

JSON output

Terminal
$ ark audit --static --output json

{
  "package": "my-agent@1.0.0",
  "mode": "static",
  "scores": {
    "structure": 18, "security": 19, "quality": 16,
    "completeness": 13, "robustness": 11
  },
  "total": 77,
  "verdict": "certified",
  "price_range": { "min": 35, "max": 49 }
}