{
  "schemaVersion": "1.0",
  "item": {
    "slug": "silverbullet-skill",
    "name": "SilverBullet API",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ramonitor/silverbullet-skill",
    "canonicalUrl": "https://clawhub.ai/ramonitor/silverbullet-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/silverbullet-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=silverbullet-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "examples/demo.py",
      "pyproject.toml",
      "server.py",
      "tests/__init__.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/silverbullet-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/silverbullet-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/silverbullet-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/silverbullet-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/silverbullet-skill/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "SilverBullet MCP Server",
        "body": "This skill provides an MCP server for interacting with SilverBullet, a self-hosted markdown-based note-taking app."
      },
      {
        "title": "Via ClawdHub",
        "body": "clawdhub install silverbullet"
      },
      {
        "title": "Manual",
        "body": "cd ~/.clawdbot/skills/silverbullet\nuv venv\nsource .venv/bin/activate\nuv pip install -e ."
      },
      {
        "title": "1. Set SilverBullet URL",
        "body": "export SILVERBULLET_URL=\"http://localhost:3000\"\n\nOr add to your shell profile (~/.zshrc / ~/.bashrc)."
      },
      {
        "title": "2. Configure mcporter",
        "body": "Add to ~/.mcporter/mcporter.json:\n\n{\n  \"servers\": {\n    \"silverbullet\": {\n      \"command\": \"python\",\n      \"args\": [\"{baseDir}/server.py\"],\n      \"transport\": \"stdio\",\n      \"env\": {\n        \"SILVERBULLET_URL\": \"http://localhost:3000\"\n      }\n    }\n  }\n}\n\nReplace {baseDir} with the actual skill path (e.g., ~/.clawdbot/skills/silverbullet)."
      },
      {
        "title": "3. Verify Installation",
        "body": "mcporter list silverbullet\n\nShould show all available tools."
      },
      {
        "title": "Available Tools",
        "body": "ToolDescriptionlist_filesList all files in the SilverBullet spaceread_pageRead markdown content from a pagewrite_pageCreate or update a pagedelete_pageDelete a pageappend_to_pageAppend content to an existing pagesearch_pagesSearch pages by name patternget_page_metadataGet page metadata (modified, created, permissions)ping_serverCheck if SilverBullet server is availableget_server_configGet server configuration"
      },
      {
        "title": "List all pages",
        "body": "mcporter call silverbullet.list_files"
      },
      {
        "title": "Read a page",
        "body": "mcporter call silverbullet.read_page path:\"index.md\"\nmcporter call silverbullet.read_page path:\"journal/2024-01-15.md\""
      },
      {
        "title": "Create or update a page",
        "body": "mcporter call silverbullet.write_page path:\"notes/meeting.md\" content:\"# Meeting Notes\\n\\n- Item 1\\n- Item 2\""
      },
      {
        "title": "Append to a page",
        "body": "mcporter call silverbullet.append_to_page path:\"journal/today.md\" content:\"## Evening Update\\n\\nFinished the project.\""
      },
      {
        "title": "Search for pages",
        "body": "mcporter call silverbullet.search_pages query:\"meeting\""
      },
      {
        "title": "Delete a page",
        "body": "mcporter call silverbullet.delete_page path:\"drafts/old-note.md\""
      },
      {
        "title": "Check server status",
        "body": "mcporter call silverbullet.ping_server"
      },
      {
        "title": "Natural Language Examples",
        "body": "Once configured, you can ask Moltbot:\n\n\"List all my SilverBullet pages\"\n\"Read my index page from SilverBullet\"\n\"Create a new page called 'Project Ideas' with a list of features\"\n\"Search for pages containing 'meeting' in the name\"\n\"Append today's notes to my journal\"\n\"What's the last modified date of my TODO page?\"\n\"Is my SilverBullet server running?\""
      },
      {
        "title": "Server not responding",
        "body": "Check if SilverBullet is running: curl http://localhost:3000/.ping\nVerify SILVERBULLET_URL is set correctly\nCheck firewall/network settings"
      },
      {
        "title": "Permission denied errors",
        "body": "SilverBullet pages can be read-only. Check the X-Permission header or use get_page_metadata to verify permissions."
      },
      {
        "title": "Tool not found",
        "body": "Verify mcporter config: cat ~/.mcporter/mcporter.json\nTest server directly: python {baseDir}/server.py (should start without errors)\nCheck Python/uv installation: which python3 uv"
      },
      {
        "title": "API Reference",
        "body": "See SilverBullet HTTP API for full documentation of the underlying REST API."
      }
    ],
    "body": "SilverBullet MCP Server\n\nThis skill provides an MCP server for interacting with SilverBullet, a self-hosted markdown-based note-taking app.\n\nInstallation\nVia ClawdHub\nclawdhub install silverbullet\n\nManual\ncd ~/.clawdbot/skills/silverbullet\nuv venv\nsource .venv/bin/activate\nuv pip install -e .\n\nConfiguration\n1. Set SilverBullet URL\nexport SILVERBULLET_URL=\"http://localhost:3000\"\n\n\nOr add to your shell profile (~/.zshrc / ~/.bashrc).\n\n2. Configure mcporter\n\nAdd to ~/.mcporter/mcporter.json:\n\n{\n  \"servers\": {\n    \"silverbullet\": {\n      \"command\": \"python\",\n      \"args\": [\"{baseDir}/server.py\"],\n      \"transport\": \"stdio\",\n      \"env\": {\n        \"SILVERBULLET_URL\": \"http://localhost:3000\"\n      }\n    }\n  }\n}\n\n\nReplace {baseDir} with the actual skill path (e.g., ~/.clawdbot/skills/silverbullet).\n\n3. Verify Installation\nmcporter list silverbullet\n\n\nShould show all available tools.\n\nAvailable Tools\nTool\tDescription\nlist_files\tList all files in the SilverBullet space\nread_page\tRead markdown content from a page\nwrite_page\tCreate or update a page\ndelete_page\tDelete a page\nappend_to_page\tAppend content to an existing page\nsearch_pages\tSearch pages by name pattern\nget_page_metadata\tGet page metadata (modified, created, permissions)\nping_server\tCheck if SilverBullet server is available\nget_server_config\tGet server configuration\nUsage Examples\nList all pages\nmcporter call silverbullet.list_files\n\nRead a page\nmcporter call silverbullet.read_page path:\"index.md\"\nmcporter call silverbullet.read_page path:\"journal/2024-01-15.md\"\n\nCreate or update a page\nmcporter call silverbullet.write_page path:\"notes/meeting.md\" content:\"# Meeting Notes\\n\\n- Item 1\\n- Item 2\"\n\nAppend to a page\nmcporter call silverbullet.append_to_page path:\"journal/today.md\" content:\"## Evening Update\\n\\nFinished the project.\"\n\nSearch for pages\nmcporter call silverbullet.search_pages query:\"meeting\"\n\nDelete a page\nmcporter call silverbullet.delete_page path:\"drafts/old-note.md\"\n\nCheck server status\nmcporter call silverbullet.ping_server\n\nNatural Language Examples\n\nOnce configured, you can ask Moltbot:\n\n\"List all my SilverBullet pages\"\n\"Read my index page from SilverBullet\"\n\"Create a new page called 'Project Ideas' with a list of features\"\n\"Search for pages containing 'meeting' in the name\"\n\"Append today's notes to my journal\"\n\"What's the last modified date of my TODO page?\"\n\"Is my SilverBullet server running?\"\nTroubleshooting\nServer not responding\nCheck if SilverBullet is running: curl http://localhost:3000/.ping\nVerify SILVERBULLET_URL is set correctly\nCheck firewall/network settings\nPermission denied errors\n\nSilverBullet pages can be read-only. Check the X-Permission header or use get_page_metadata to verify permissions.\n\nTool not found\nVerify mcporter config: cat ~/.mcporter/mcporter.json\nTest server directly: python {baseDir}/server.py (should start without errors)\nCheck Python/uv installation: which python3 uv\nAPI Reference\n\nSee SilverBullet HTTP API for full documentation of the underlying REST API."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ramonitor/silverbullet-skill",
    "publisherUrl": "https://clawhub.ai/ramonitor/silverbullet-skill",
    "owner": "ramonitor",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/silverbullet-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/silverbullet-skill",
    "agentUrl": "https://openagent3.xyz/skills/silverbullet-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/silverbullet-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/silverbullet-skill/agent.md"
  }
}