plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "yarkr",
  "version": "0.1.0",
  "description": "Find and retrieve public AI skills, agent definitions, and MCP configurations from Yarkr.",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Yarkr",
        "shortDescription": "Skills for your AI workflows",
        "longDescription": "Discover public skills, agent definitions, and MCP configurations in Yarkr. Search by task, retrieve versioned instructions, and load supporting skill files when needed. This plugin connects to the public, read-only Yarkr server.",
        "category": "Developer Tools",
        "defaultPrompt": [
          "Find a skill for documenting software architecture.",
          "Find public agent definitions for code review.",
          "Find MCP configurations for my development workflow."
        ],
        "developerName": "Posterus Ltd.",
        "websiteURL": "https://posterus.ventures",
        "supportURL": "https://yarkr.com/imprint",
        "privacyPolicyURL": "https://yarkr.com/privacy",
        "termsOfServiceURL": "https://yarkr.com/terms",
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "logoDark": "./assets/icon.png",
        "composerIconDark": "./assets/icon.png"
      },
      "publication": {
        "release_notes": "Initial plugin connecting to the public Yarkr MCP server.",
        "countries": []
      },
      "review": {
        "prompts": [
          "Find a skill for documenting software architecture.",
          "Find public agent definitions for code review.",
          "Find MCP configurations for my development workflow."
        ],
        "commerce": false,
        "commerce_description": "This public, read-only plugin does not involve payments or purchases.",
        "test_cases": {
          "positive": [
            {
              "description": "Search and retrieve a public skill. Public endpoint; no login required.",
              "prompt": "Find a public skill for documenting software architecture and summarize its instructions.",
              "tools_triggered": "search_packages, get_skill",
              "expected_behavior": "Search with query architecture, kind skill, scope all. Retrieve a returned name with get_skill; base the summary on the retrieved instructions and report the returned version. If the catalog has no match, explain that without inventing one."
            },
            {
              "description": "Discover an agent and render it for Codex. Verified public fixture: addyosmani/code-reviewer@0.6.15. Search code review, then retrieve this result if available. Report catalog changes rather than inventing a result.",
              "prompt": "Find a public code review agent and show me its definition for Codex.",
              "tools_triggered": "search_packages, get_agent",
              "expected_behavior": "Search for code review with kind agent and scope all. Use a returned name with get_agent and harness codex. Show only the returned definition and dependencies; report no matching agent if none exists."
            },
            {
              "description": "Discover an MCP configuration without resolving secrets. Verified public fixture: posterus-ltd/github@0.0.0-arks-library.1792108578.gbefeb5a. Search GitHub and select this result if available.",
              "prompt": "Find a public MCP configuration for GitHub and explain its setup.",
              "tools_triggered": "search_packages, get_mcp_config",
              "expected_behavior": "Search query GitHub, kind mcp, scope all. Retrieve a returned package using get_mcp_config. Explain only returned configuration; preserve vault and environment references without requesting or resolving their values. Report no match if none exists."
            },
            {
              "description": "Follow-up to the first skill case. Conversation context: benjaminastera/architecture@0.0.0-main.1794338341.ga550a5e was retrieved and its manifest lists trade-off-analysis.md.",
              "prompt": "Read trade-off-analysis.md from that same skill version and summarize how to document a decision.",
              "tools_triggered": "get_skill_file",
              "expected_behavior": "Call get_skill_file with name benjaminastera/architecture, version 0.0.0-main.1794338341.ga550a5e, and path trade-off-analysis.md. Summarize context, options, decision and rationale, accepted trade-offs, consequences and mitigations, and revisit triggers from the returned file. Do not guess a different path."
            },
            {
              "description": "Read guidance without modifying a registry or repository.",
              "prompt": "Explain how to create a Yarkr ark of skills for architecture documentation.",
              "tools_triggered": "get_guide",
              "expected_behavior": "Call get_guide with name create-ark, type skill, and topic architecture documentation. Explain the returned steps without claiming an ark was created."
            }
          ],
          "negative": [
            {
              "description": "The public connection has no package deletion tool. Explain this limitation; do not call discovery or retrieval tools to simulate deletion.",
              "prompt": "Delete an architecture skill from the Yarkr registry."
            },
            {
              "description": "The public connection cannot grant private access or change memberships. Explain this limitation without calling tools or claiming access was granted.",
              "prompt": "Give everyone access to my private Yarkr packages."
            },
            {
              "description": "The plugin cannot process purchases. Explain this limitation without invoking tools or claiming payment occurred.",
              "prompt": "Buy a paid Yarkr plan using my credit card."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1lv3CM2aQBCSLT_bffFDoSKpy7xW4sYNq/view?usp=sharing"
      },
      "apps": "./.app.json"
    }
  },
  "author": {
    "name": "Posterus Ltd."
  }
}