nurokhq/nurok

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "nurok",
  "version": "0.1.0",
  "description": "Search and read Nurok knowledge bases with source evidence through a remote MCP connection and reusable skills.",
  "author": {
    "name": "Nurok",
    "email": "support@nurok.ai",
    "url": "https://github.com/nurokhq"
  },
  "homepage": "https://github.com/nurokhq/skills",
  "repository": "https://github.com/nurokhq/skills",
  "license": "Apache-2.0",
  "keywords": [
    "nurok",
    "knowledge-base",
    "openakb",
    "search",
    "mcp"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Nurok",
        "shortDescription": "Knowledge answers with sources",
        "longDescription": "Find, browse, and read Nurok knowledge bases, then answer with source-level evidence. The bundled skill uses the remote Nurok MCP service, so supported ChatGPT mobile, web, Mac, Windows, and Codex surfaces do not need a local CLI or Python installation for this workflow. Public knowledge bases support anonymous reads. Private access depends on the connected account and service permissions. This release provides read-only knowledge workflows; it does not create, capture, modify, delete, or publish knowledge bases. Availability depends on your account, workspace, and client support.",
        "developerName": "Nurok",
        "category": "Productivity",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://github.com/nurokhq/skills",
        "supportURL": "https://github.com/nurokhq/skills/issues",
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "defaultPrompt": [
          "Find a Nurok knowledge base about my topic.",
          "Answer my question from a Nurok knowledge base with source evidence.",
          "Show a Nurok knowledge base's structure and revision history."
        ],
        "privacyPolicyURL": "https://nurok.ai/legal/privacy",
        "termsOfServiceURL": "https://nurok.ai/legal/terms"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Browse one bounded page of the public catalog without credentials. Do not select a KB by popularity for a topical question.",
              "prompt": "Show me two public Nurok knowledge bases with links.",
              "tools_triggered": "kb_list",
              "expected_behavior": "Call kb_list with visibility public and limit 2. Display only returned titles and web_url values, and disclose if more pages exist. Do not invoke a shell or require CLI installation."
            },
            {
              "description": "Resolve the public yellow/alchemist-flagship fixture and inspect its live metadata. Report unavailable if the fixture is removed or access changes.",
              "prompt": "What is the Nurok knowledge base yellow/alchemist-flagship about, and what revision is live?",
              "tools_triggered": "kb_resolve",
              "expected_behavior": "Resolve owner_handle yellow and slug alchemist-flagship. Summarize returned metadata and revision; preserve the returned canonical kb_id and web_url. Do not invent a revision or claim source-level verification for metadata alone."
            },
            {
              "description": "Browse the same public fixture's structure at the revision returned by resolve.",
              "prompt": "Show the top-level sections of yellow/alchemist-flagship.",
              "tools_triggered": "kb_resolve, kb_sections_list",
              "expected_behavior": "Resolve the fixture, then list sections using its returned kb_id, revision and depth 1. Show returned hierarchy, preserve Section IDs, and disclose pagination instead of treating a partial page as complete."
            },
            {
              "description": "Search and retrieve application evidence from yellow/alchemist-flagship; availability and current content may vary.",
              "prompt": "According to yellow/alchemist-flagship, what does the original source say about applying? Include source evidence.",
              "tools_triggered": "kb_resolve, kb_search, kb_section_get, kb_artifact",
              "expected_behavior": "Search the resolved KB for application-related evidence at one revision, retrieve the supporting Section and its provenance, and identify the evidence granularity. Cite only returned public Source URIs; for Sources explicitly marked private, show only opaque Source IDs and non-identifying provenance. If required provenance is unavailable, mark it incomplete. Never treat a search snippet as fully verified evidence."
            },
            {
              "description": "Inspect a bounded page of revision history for the resolved public fixture.",
              "prompt": "Show the recent revision history of yellow/alchemist-flagship.",
              "tools_triggered": "kb_resolve, kb_changelog",
              "expected_behavior": "Resolve the KB, then call kb_changelog with the returned kb_id and a bounded limit. Report only returned revisions, timestamps and messages; disclose missing fields and continuation when present."
            }
          ],
          "negative": [
            {
              "description": "Deletion is outside this read-only release. Explain the boundary without calling mutation tools, executing CLI commands, or claiming deletion.",
              "prompt": "Delete yellow/alchemist-flagship permanently."
            },
            {
              "description": "Capture and publication are outside this release. Explain that additional authorized capabilities are required; do not crawl sources, create artifacts, or publish anything.",
              "prompt": "Capture these websites and publish a new Nurok knowledge base."
            },
            {
              "description": "A similarly named local folder is not remote KB evidence. Explain the plugin has no local-filesystem access, request a published KB identity if reading Nurok is intended, and do not invoke a shell or read local files.",
              "prompt": "Search my local ~/Documents/nurok folder and upload every file."
            }
          ]
        }
      }
    }
  }
}