Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

3.4 KB
Raw Blame
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://tt-a1i.github.io/archify/community/package.schema.json",
  "title": "Archify Community Package",
  "description": "Registry metadata for a standalone community package that builds on Archify. One file per package under community/packages/. The package content lives in the author's own repository; this file only indexes it.",
  "type": "object",
  "additionalProperties": false,
  "required": ["name", "type", "summary", "author", "repository", "archify", "schemaVersions"],
  "properties": {
    "name": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$",
      "description": "Lowercase kebab-case identifier, unique across the registry. Also the file name: community/packages/<name>.json."
    },
    "type": {
      "enum": ["skill", "recipe", "brand-marks", "locale", "wrapper"],
      "description": "skill: agent skill pack; recipe: scenario/recipe library; brand-marks: brand-mark catalog or preset; locale: meta.translations catalog; wrapper: standalone tool that emits Archify JSON IR and calls the CLI."
    },
    "summary": {
      "type": "object",
      "additionalProperties": false,
      "required": ["en", "zh"],
      "properties": {
        "en": { "type": "string", "minLength": 10, "maxLength": 160 },
        "zh": { "type": "string", "minLength": 6, "maxLength": 120 }
      }
    },
    "author": {
      "type": "object",
      "additionalProperties": false,
      "required": ["name"],
      "properties": {
        "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "\\S" },
        "url": { "type": "string", "pattern": "^https://[^\\s\\\\/?#@]+(?:[/?#][^\\s\\\\]*)?$", "format": "uri" }
      }
    },
    "repository": {
      "type": "string",
      "pattern": "^https://[^\\s\\\\/?#@]+(?:[/?#][^\\s\\\\]*)?$", "format": "uri",
      "description": "Public URL of the package source (git repository, npm page, or directory inside one)."
    },
    "archify": {
      "type": "string",
      "pattern": "^(\\^|~)\\d+\\.\\d+\\.\\d+$|^\\d+\\.\\d+\\.\\d+$|^>=\\d+\\.\\d+\\.\\d+ <\\d+\\.\\d+\\.\\d+$",
      "description": "Compatible Archify version range, e.g. ^3.0.1 or >=3.0.0 <4.0.0."
    },
    "schemaVersions": {
      "type": "array",
      "items": { "type": "integer", "minimum": 1 },
      "minItems": 1,
      "uniqueItems": true,
      "description": "Archify JSON IR schema_version values the package can author."
    },
    "homepage": {
      "type": "string",
      "pattern": "^https://[^\\s\\\\/?#@]+(?:[/?#][^\\s\\\\]*)?$", "format": "uri"
    },
    "tags": {
      "type": "array",
      "items": { "type": "string", "pattern": "^[a-z0-9-]{1,32}$" },
      "maxItems": 6,
      "uniqueItems": true
    },
    "evidence": {
      "type": "array",
      "maxItems": 8,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["label", "url"],
        "properties": {
          "label": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "\\S" },
          "url": { "type": "string", "pattern": "^https://[^\\s\\\\/?#@]+(?:[/?#][^\\s\\\\]*)?$", "format": "uri" }
        }
      },
      "description": "Links to verification evidence: validation receipts, screenshots, rendered example artifacts. Evidence is authored by the submitter; Archify never executes third-party package code."
    }
  }
}