Ark

This site is private. Enter the password to continue.

docs / getting-started / quick-start

Quick start

Install the CLI

Ark is distributed as an npm package. Install it globally or use npx to run commands directly.

Terminal
$ npm install -g ark-pm

# Or use npx (no install needed)
$ npx ark-pm search voice

Browse & install packages

Search the registry from your terminal. Every package shows its audit score and price.

Terminal
$ ark search voice

  voice-writer      agent   75  Free     Writes in your authentic voice
  daily-recap       skill   78  Free     End-of-day summary

$ ark install voice-writer

   Installed in ~/.ark/packages/voice-writer/
Paid packages require an activation code. Buy on getark.dev, then install with ark install package-name --code ARK-XXXX.

Create your first package

Got a skill, agent, or system you want to publish? Start with ark init in your project directory.

Terminal
$ cd my-agent/
$ ark init

   Created ark.json

$ cat ark.json

This creates a manifest file describing your package:

ark.json
{
  "name": "my-agent",
  "version": "1.0.0",
  "type": "agent",
  "category": "creative",
  "description": "...",
  "platforms": ["claude-code"],
  "author": {
    "name": "Your Name",
    "email": "you@example.com"
  }
}

Audit your package

Before publishing, run the audit to see your score. Ark evaluates 6 dimensions:

DimensionPointsWhat it measures
Structure20ark.json, file organization, installer
Security20No secrets, permissions, injection safety
Code Quality20Syntax, error handling, documentation
Completeness15All components present and documented
Robustness15Error recovery, idempotence, compat
Value10Originality, domain depth (full mode)
Terminal
$ ark audit --static

  Structure        18/20
  Security         17/20
  Code Quality     15/20
  Completeness     12/15
  Robustness       11/15
  ─────────────────────────
  Total            73/100
  ✓ Certified

  Price range: $35 — $49
Score 60+ is required to publish. Gold (90+) gets featured placement. See Scoring & verdicts for details.

Publish

Once your score is 60 or above, submit to the registry. Packages go through manual review (24-48h) before appearing on the marketplace.

Terminal
$ ark publish

   Archive created (12.4 KB)
   Audit report attached (score: 73)
   Submitted to registry

  Review takes 24-48h. We'll email you.

Next steps

Now that you know the basics: