{
  "schema_version": 1,
  "name": "TokRepo",
  "description": "Agent-native typed registry for AI assets: skills, prompts, knowledge, MCP configs, scripts, CLI tools, configs, and packs.",
  "website": "https://tokrepo.com",
  "api_base": "https://api.tokrepo.com",
  "cli": {
    "package": "tokrepo",
    "install": "npx -y tokrepo@latest",
    "agent_eval": "tokrepo eval-agent --json",
    "agent_baseline_eval": "tokrepo eval-agent --suite agent-baseline --json"
  },
  "mcp": {
    "package": "tokrepo-mcp-server",
    "command": "npx -y tokrepo-mcp-server",
    "hosted_endpoint": "https://tokrepo.com/mcp",
    "hosted_transport": "streamable_http_json_rpc"
  },
  "capabilities": {
    "planning_time_discovery": true,
    "task_capability_matching": true,
    "agent_bootstrap_instructions": true,
    "project_agent_memory": true,
    "planning_precheck_cli": true,
    "post_task_handoff": true,
    "handoff_plan_mcp": true,
    "search_json": true,
    "detail_json": true,
    "install_plan_v2": true,
    "codex_install_target": true,
    "dry_run": true,
    "stage_only": true,
    "manifest": true,
    "sessions": true,
    "uninstall": true,
    "rollback": true,
    "metadata_quality_report": true,
    "agent_eval": true,
    "agent_funnel_events": true,
    "starter_templates": true,
    "agent_ecosystem_distribution": true,
    "agent_task_economy": true,
    "agent_task_harness_eval": true,
    "agent_task_ledger_eval": true,
    "high_value_task_loop": true,
    "long_running_task_contract": true,
    "six_layer_agent_growth": true,
    "registry_listing_manifest": true,
    "portable_agent_manifest": true,
    "tool_catalog_manifest": true,
    "root_agent_text_entry": true,
    "copilot_instruction_bootstrap": true,
    "cline_instruction_bootstrap": true,
    "windsurf_instruction_bootstrap": true,
    "openhands_microagent_bootstrap": true,
    "aider_conventions_bootstrap": true,
    "agent_fit_ranking": true,
    "agent_asset_contract": true,
    "agent_readiness_score": true,
    "trust_contract": true,
    "raw_metadata_endpoint": true,
    "target_adapters": true,
    "hosted_mcp_endpoint": true,
    "trust_history_audit": true,
    "metadata_sync_check": true,
    "project_lockfile": true,
    "project_installed_state": true,
    "asset_verification": true,
    "agent_evidence_bundle": true,
    "sbom_lite": true,
    "signature_evidence": true,
    "handoff_quality_gate": true,
    "trust_manifest": true,
    "agent_trust_score_v2": true,
    "policy_packs": true,
    "eval_evidence": true,
    "multi_agent_compatibility_matrix": true,
    "capability_resolution": true,
    "hosted_capability_resolution": true,
    "post_task_harvest": true,
    "harvest_plan_mcp": true,
    "agent_task_receipts_eval": "Public deterministic task-run receipts with last_run_at, next_due_at, freshness_status, verification_command, evidence_digest, outcome_oracle, task_outcome_verdict, and user_effect.",
    "outcome_oracle_receipts": "Outcome-oracle receipts prove long-running task freshness and user-effect verdicts instead of relying on a scheduled state row alone."
  },
  "source_of_truth": {
    "install_plan": "api_install_plan_v2",
    "agent_asset_contract": "mcp.agent_asset_contract derived from workflow.agent_metadata plus install_plan",
    "agent_readiness_score": "mcp.agent_readiness six-component score",
    "agent_metadata": "workflow.agent_metadata",
    "search_ranking": "workflow.agent_fit",
    "trust": "workflow.trust",
    "provenance": "workflow.provenance",
    "target_adapter": "install_plan.target_adapter",
    "planning_discovery": "mcp.tokrepo_discover",
    "agent_bootstrap": "cli.tokrepo_init_agent",
    "project_agent_memory": "cli.tokrepo_init_agent writes .tokrepo/agent.json",
    "post_task_handoff": "cli.tokrepo_agent_handoff",
    "mcp_handoff_plan": "mcp.tokrepo_handoff_plan",
    "agent_ecosystem_distribution": "agent-ecosystem.json",
    "agent_task_economy": "agent-task-economy.json",
    "agent_task_harness_eval": "evals/agent-task-harness.json",
    "agent_task_ledger_eval": "evals/agent-task-ledger.json",
    "agent_growth_layers": "agent-ecosystem.json.six_layer_agent_growth",
    "agent_funnel": "api_agent_funnel",
    "mcp_registry": ".well-known/mcp/server.json",
    "asset_verification": "cli.tokrepo_verify",
    "agent_evidence_bundle": "cli.tokrepo_verify and cli.tokrepo_install_plan evidence_bundle",
    "sbom_lite": "evidence_bundle.sbom",
    "signature_evidence": "evidence_bundle.signature_evidence",
    "handoff_quality_gate": "cli.tokrepo_agent_handoff quality_gate",
    "trust_history_audit": "cli.tokrepo_audit",
    "hosted_mcp": "https://tokrepo.com/mcp",
    "metadata_sync": "scripts/sync_agent_metadata.mjs",
    "trust_manifest": ".well-known/tokrepo-trust.json",
    "policy_pack": "policy-packs/default-agent-policy.json",
    "agent_eval_evidence": "evals/*.json",
    "local_install_state": "~/.codex/tokrepo/install-manifest.json",
    "project_lockfile": "TokRepo.lock",
    "project_installed_state": ".tokrepo/state.json",
    "session_audit": "~/.codex/tokrepo/sessions/*.json",
    "multi_agent_compatibility": "evals/multi-agent-compatibility.json",
    "capability_resolution": "mcp.tokrepo_resolve_capability and cli.tokrepo_resolve",
    "post_task_harvest": "cli.tokrepo_harvest",
    "mcp_harvest": "mcp.tokrepo_harvest",
    "agent_task_receipts_eval": "https://tokrepo.com/evals/agent-task-receipts.json"
  },
  "schemas": {
    "agent_discovery": "https://tokrepo.com/schemas/agent-discovery.schema.json",
    "agent_memory": "https://tokrepo.com/schemas/agent-memory.schema.json",
    "agent_metadata": "https://tokrepo.com/schemas/agent-metadata.schema.json",
    "agent_fit": "https://tokrepo.com/schemas/agent-fit.schema.json",
    "agent_asset_contract": "https://tokrepo.com/schemas/agent-asset-contract.schema.json",
    "agent_readiness": "https://tokrepo.com/schemas/agent-readiness.schema.json",
    "install_plan": "https://tokrepo.com/schemas/install-plan.schema.json",
    "install_manifest": "https://tokrepo.com/schemas/install-manifest.schema.json",
    "install_session": "https://tokrepo.com/schemas/install-session.schema.json",
    "trust": "https://tokrepo.com/schemas/trust.schema.json",
    "provenance": "https://tokrepo.com/schemas/provenance.schema.json",
    "target_adapter": "https://tokrepo.com/schemas/target-adapter.schema.json",
    "asset_verification": "https://tokrepo.com/schemas/asset-verification.schema.json",
    "agent_evidence_bundle": "https://tokrepo.com/schemas/agent-evidence-bundle.schema.json",
    "handoff_package": "https://tokrepo.com/schemas/handoff-package.schema.json",
    "agent_audit": "https://tokrepo.com/schemas/agent-audit.schema.json",
    "agent_trust_score": "https://tokrepo.com/schemas/agent-trust-score.schema.json",
    "trust_manifest": "https://tokrepo.com/schemas/trust-manifest.schema.json",
    "policy_pack": "https://tokrepo.com/schemas/policy-pack.schema.json",
    "tokrepo_lock": "https://tokrepo.com/schemas/tokrepo-lock.schema.json",
    "project_state": "https://tokrepo.com/schemas/tokrepo-project-state.schema.json",
    "capability_resolution": "https://tokrepo.com/schemas/capability-resolution.schema.json",
    "harvest_report": "https://tokrepo.com/schemas/harvest-report.schema.json"
  },
  "endpoints": {
    "search": "https://api.tokrepo.com/api/v1/tokenboard/workflows/list?keyword={query}&target={target}&kind={kind}&policy={policy}",
    "detail": "https://api.tokrepo.com/api/v1/tokenboard/workflows/detail?uuid={uuid}",
    "install_plan": "https://api.tokrepo.com/api/v1/tokenboard/workflows/install-plan?uuid={uuid}&target={target}",
    "raw_metadata": "https://tokrepo.com/metadata/{uuid_or_slug}.json",
    "raw_content": "https://tokrepo.com/raw/{uuid_or_slug}",
    "agent_instructions": "https://tokrepo.com/agent-instructions/tokrepo.md",
    "agent_manifest": "https://tokrepo.com/.well-known/agent.json",
    "agent_card": "https://tokrepo.com/.well-known/agent-card.json",
    "tool_catalog": "https://tokrepo.com/.well-known/tool-catalog.json",
    "mcp_server_manifest": "https://tokrepo.com/.well-known/mcp/server.json",
    "hosted_mcp": "https://tokrepo.com/mcp",
    "root_mcp_manifest": "https://tokrepo.com/mcp.json",
    "agents_txt": "https://tokrepo.com/agents.txt",
    "agent_ecosystem": "https://tokrepo.com/agent-ecosystem.json",
    "agent_task_economy": "https://tokrepo.com/agent-task-economy.json",
    "eval_agent_task_harness": "https://tokrepo.com/evals/agent-task-harness.json",
    "eval_agent_task_ledger": "https://tokrepo.com/evals/agent-task-ledger.json",
    "agent_growth_layers": "https://tokrepo.com/agent-ecosystem.json#six_layer_agent_growth",
    "trust_manifest": "https://tokrepo.com/.well-known/tokrepo-trust.json",
    "agent_memory_schema": "https://tokrepo.com/schemas/agent-memory.schema.json",
    "agent_asset_contract_schema": "https://tokrepo.com/schemas/agent-asset-contract.schema.json",
    "agent_readiness_schema": "https://tokrepo.com/schemas/agent-readiness.schema.json",
    "tokrepo_lock_schema": "https://tokrepo.com/schemas/tokrepo-lock.schema.json",
    "project_state_schema": "https://tokrepo.com/schemas/tokrepo-project-state.schema.json",
    "asset_verification_schema": "https://tokrepo.com/schemas/asset-verification.schema.json",
    "agent_evidence_bundle_schema": "https://tokrepo.com/schemas/agent-evidence-bundle.schema.json",
    "handoff_package_schema": "https://tokrepo.com/schemas/handoff-package.schema.json",
    "agent_audit_schema": "https://tokrepo.com/schemas/agent-audit.schema.json",
    "agent_trust_score_schema": "https://tokrepo.com/schemas/agent-trust-score.schema.json",
    "trust_manifest_schema": "https://tokrepo.com/schemas/trust-manifest.schema.json",
    "policy_pack_schema": "https://tokrepo.com/schemas/policy-pack.schema.json",
    "default_policy_pack": "https://tokrepo.com/policy-packs/default-agent-policy.json",
    "eval_agent_baseline": "https://tokrepo.com/evals/agent-baseline.json",
    "eval_agent_discovery": "https://tokrepo.com/evals/agent-discovery.json",
    "eval_install_safety": "https://tokrepo.com/evals/install-safety.json",
    "eval_handoff_quality": "https://tokrepo.com/evals/handoff-quality.json",
    "eval_agent_onboarding_compliance": "https://tokrepo.com/evals/agent-onboarding-compliance.json",
    "eval_trust_evidence_coverage": "https://tokrepo.com/evals/trust-evidence-coverage.json",
    "eval_multi_agent_compatibility": "https://tokrepo.com/evals/multi-agent-compatibility.json",
    "agent_distribution_matrix": "https://tokrepo.com/agent-distribution-matrix.json",
    "agent_events": "https://api.tokrepo.com/api/v1/tokenboard/agent/events",
    "agent_funnel": "https://api.tokrepo.com/api/v1/tokenboard/agent/funnel",
    "capability_resolution_schema": "https://tokrepo.com/schemas/capability-resolution.schema.json",
    "harvest_report_schema": "https://tokrepo.com/schemas/harvest-report.schema.json",
    "eval_agent_task_receipts": "https://tokrepo.com/evals/agent-task-receipts.json"
  },
  "cli_commands": {
    "init_agent": "tokrepo init-agent --target all",
    "agent_check": "tokrepo agent-check \"<task>\" --json",
    "verify": "tokrepo verify <uuid> --target codex --json",
    "audit": "tokrepo audit <uuid> --target codex --json",
    "agent_handoff": "tokrepo agent-handoff --json",
    "project_installed": "tokrepo installed --project --json",
    "installed": "tokrepo installed --target codex --json",
    "update_plan": "tokrepo sync-installed --target codex --dry-run --json",
    "uninstall_plan": "tokrepo uninstall <uuid> --target codex --dry-run --json",
    "rollback_plan": "tokrepo rollback --last --target codex --dry-run --json",
    "resolve": "tokrepo resolve \"<task>\" --target codex --json",
    "harvest": "tokrepo harvest --changed --json"
  },
  "agent_distribution": {
    "primary_install": "npx -y tokrepo-mcp-server",
    "project_memory": "tokrepo init-agent --target all",
    "machine_manifest": "https://tokrepo.com/.well-known/tokrepo.json",
    "portable_agent_manifest": "https://tokrepo.com/.well-known/agent.json",
    "a2a_agent_card": "https://tokrepo.com/.well-known/agent-card.json",
    "tool_catalog": "https://tokrepo.com/.well-known/tool-catalog.json",
    "ecosystem_distribution": "https://tokrepo.com/agent-ecosystem.json",
    "task_economy_contract": "https://tokrepo.com/agent-task-economy.json",
    "task_harness_eval": "https://tokrepo.com/evals/agent-task-harness.json",
    "task_ledger_eval": "https://tokrepo.com/evals/agent-task-ledger.json",
    "mcp_registry_manifest": "https://tokrepo.com/.well-known/mcp/server.json",
    "hosted_mcp": "https://tokrepo.com/mcp",
    "root_mcp_manifest": "https://tokrepo.com/mcp.json",
    "llms_entry": "https://tokrepo.com/llms.txt",
    "agents_text_entry": "https://tokrepo.com/agents.txt",
    "instruction_template": "https://tokrepo.com/agent-instructions/tokrepo.md",
    "starter_template": "https://tokrepo.com/agent-instructions/tokrepo.md#starter-template",
    "project_lifecycle_state": "TokRepo.lock + .tokrepo/state.json via tokrepo installed --project --json",
    "agent_evidence_bundle": "tokrepo verify and tokrepo plan expose evidence_bundle with provenance_v2, SBOM-lite, signature_evidence, policy_compatibility, and eval_evidence",
    "handoff_quality_gate": "tokrepo agent-handoff exposes quality_gate, package_manifest, SBOM, provenance, and ready_to_push before tokrepo_push",
    "marketplace_listing_pack": "https://tokrepo.com/agent-ecosystem.json#agent_marketplace_listing",
    "distribution_matrix": "https://tokrepo.com/agent-distribution-matrix.json",
    "six_layer_growth_plan": "https://tokrepo.com/agent-ecosystem.json#six_layer_agent_growth",
    "trust_manifest": "https://tokrepo.com/.well-known/tokrepo-trust.json",
    "default_policy_pack": "https://tokrepo.com/policy-packs/default-agent-policy.json",
    "baseline_eval_evidence": "https://tokrepo.com/evals/agent-baseline.json",
    "eval_evidence": "https://tokrepo.com/evals/agent-discovery.json",
    "onboarding_compliance": "https://tokrepo.com/evals/agent-onboarding-compliance.json",
    "trust_evidence_coverage": "https://tokrepo.com/evals/trust-evidence-coverage.json",
    "multi_agent_compatibility": "https://tokrepo.com/evals/multi-agent-compatibility.json",
    "recommended_targets": [
      "AGENTS.md",
      "CLAUDE.md",
      "GEMINI.md",
      ".cursor/rules/tokrepo.mdc",
      ".github/copilot-instructions.md",
      ".github/instructions/tokrepo.instructions.md",
      ".clinerules/tokrepo.md",
      ".windsurf/rules/tokrepo.md",
      ".roo/rules/tokrepo.md",
      ".openhands/microagents/repo.md",
      "CONVENTIONS.md",
      ".mcp.json",
      ".tokrepo/agent.json"
    ],
    "capability_resolution": "tokrepo_resolve_capability or tokrepo resolve \"<task>\" --json returns selected asset, verification evidence, install_plan, lifecycle_contract, and next_mcp_calls",
    "post_task_harvest": "tokrepo_harvest or tokrepo harvest --changed --json returns private-by-default package drafts before tokrepo_push",
    "task_receipts_eval": "https://tokrepo.com/evals/agent-task-receipts.json"
  },
  "agent_funnel_events": [
    "init_agent",
    "agent_check",
    "capability_resolve",
    "agent_handoff",
    "handoff_plan",
    "harvest_plan",
    "mcp_discover",
    "mcp_search",
    "mcp_detail",
    "verify_asset",
    "audit_asset",
    "install_plan",
    "install_dry_run",
    "install_apply",
    "rollback_plan",
    "push"
  ],
  "mcp_tools": {
    "discover": "tokrepo_discover",
    "find_for_task": "tokrepo_find_for_task",
    "search": "tokrepo_search",
    "detail": "tokrepo_detail",
    "edges": "tokrepo_edges",
    "install_plan": "tokrepo_install_plan",
    "verify": "tokrepo_verify",
    "install_codex": "tokrepo_codex_install",
    "installed": "tokrepo_installed",
    "update": "tokrepo_update",
    "uninstall": "tokrepo_uninstall",
    "rollback": "tokrepo_rollback",
    "handoff_plan": "tokrepo_handoff_plan",
    "push": "tokrepo_push",
    "resolve_capability": "tokrepo_resolve_capability",
    "harvest": "tokrepo_harvest"
  },
  "target_adapters": [
    {
      "target": "codex",
      "adapter": "skill-directory",
      "root": "~/.codex/skills",
      "entrypoint": "SKILL.md",
      "manifest_path": "~/.codex/tokrepo/install-manifest.json",
      "staging_root": "~/.codex/tokrepo/staged/{uuid}",
      "install_modes": [
        "single",
        "bundle",
        "split",
        "stage_only"
      ],
      "activates_files": true,
      "status": "native"
    },
    {
      "target": "claude_code",
      "adapter": "skill-directory",
      "root": "~/.claude/skills",
      "entrypoint": "SKILL.md",
      "install_modes": [
        "single",
        "bundle",
        "split",
        "stage_only"
      ],
      "activates_files": true,
      "status": "planned"
    },
    {
      "target": "gemini_cli",
      "adapter": "skill-directory",
      "root": "~/.gemini/skills",
      "entrypoint": "GEMINI.md",
      "install_modes": [
        "single",
        "bundle",
        "split",
        "stage_only"
      ],
      "activates_files": true,
      "status": "planned"
    }
  ],
  "recommended_agent_flow": [
    "understand_task",
    "load_project_agent_memory",
    "detect_capability_gap",
    "detect_high_value_task",
    "resolve_capability_gap",
    "discover",
    "detail",
    "verify_asset_trust",
    "inspect_evidence_bundle",
    "audit_trust_history_when_material",
    "plan",
    "dry_run",
    "install_or_stage",
    "use_capability",
    "verify",
    "evaluate_task_outcome",
    "record_outcome",
    "handoff_reusable_improvement",
    "harvest_reusable_output",
    "check_handoff_quality_gate",
    "record_manifest",
    "record_anonymous_funnel_event",
    "push_reusable_improvement",
    "rollback_if_needed",
    {
      "step": "audit_task_receipt",
      "action": "Fetch /evals/agent-task-receipts.json before treating a long-running task as fresh or outcome-verified.",
      "required_evidence": [
        "freshness_status",
        "outcome_oracle",
        "task_outcome_verdict",
        "user_effect"
      ]
    }
  ],
  "recommended_commands": [
    "npx -y tokrepo-mcp-server",
    "tokrepo init-agent --target all",
    "tokrepo agent-check \"<task>\" --json",
    "MCP tokrepo_resolve_capability",
    "tokrepo resolve \"<task>\" --target codex --json",
    "tokrepo search <capability_gap> --kind skill --policy allow --json",
    "tokrepo search <capability_gap> --target codex --kind skill --policy allow --json",
    "tokrepo detail <uuid> --json",
    "tokrepo verify <uuid> --target codex --json",
    "tokrepo audit <uuid> --target codex --json",
    "jq .evidence_bundle",
    "tokrepo install <uuid> --target codex --dry-run --json",
    "tokrepo install <uuid> --target codex --yes",
    "tokrepo installed --target codex --json",
    "tokrepo rollback --last --target codex --dry-run --json",
    "tokrepo agent-handoff --json",
    "MCP tokrepo_harvest",
    "tokrepo harvest --changed --json",
    "jq .handoff_quality_gate",
    "MCP tokrepo_handoff_plan",
    "tokrepo agent-handoff --json",
    "curl -s https://tokrepo.com/mcp",
    "curl -s https://tokrepo.com/agent-ecosystem.json",
    "curl -s https://tokrepo.com/agent-task-economy.json",
    "curl -s https://tokrepo.com/evals/agent-task-harness.json",
    "curl -s https://tokrepo.com/evals/agent-task-ledger.json",
    "curl -s https://tokrepo.com/.well-known/tokrepo-trust.json",
    "curl -s https://tokrepo.com/policy-packs/default-agent-policy.json",
    "tokrepo eval-agent --suite agent-baseline --json",
    "node scripts/run_agent_task_receipts.mjs --check-public",
    "curl -s https://tokrepo.com/evals/agent-baseline.json",
    "curl -s https://tokrepo.com/evals/agent-task-receipts.json",
    "curl -s https://tokrepo.com/evals/agent-discovery.json",
    "curl -s https://api.tokrepo.com/api/v1/tokenboard/agent/funnel?days=7",
    "tokrepo sync-installed --target codex --dry-run --json",
    "tokrepo uninstall <uuid> --target codex --dry-run --json"
  ]
}