# Send Openclaw Skill to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "shelv", "name": "Openclaw Skill", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/JoshuaOHanlon/shelv", "canonicalUrl": "https://clawhub.ai/JoshuaOHanlon/shelv", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/shelv", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shelv", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "references/api-reference.md", "references/error-handling.md", "references/shelf-lifecycle.md", "scripts/shelv-hydrate.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "shelv", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T18:53:21.485Z", "expiresAt": "2026-05-07T18:53:21.485Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shelv", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shelv", "contentDisposition": "attachment; filename=\"shelv-1.0.3.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "shelv" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/shelv" }, "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." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/shelv", "downloadUrl": "https://openagent3.xyz/downloads/shelv", "agentUrl": "https://openagent3.xyz/skills/shelv/agent", "manifestUrl": "https://openagent3.xyz/skills/shelv/agent.json", "briefUrl": "https://openagent3.xyz/skills/shelv/agent.md" } } ``` ## Documentation ### Shelv Shelv converts PDF documents (contracts, books, research papers, regulations) into structured Markdown filesystems. Upload a PDF, wait for processing, then hydrate the result into your workspace as real files you can explore with ls, cat, grep, and find. API base URL: https://api.shelv.dev Auth: Authorization: Bearer $SHELV_API_KEY on every request. Get your API key at shelv.dev → Settings → API Keys. ### 1. Upload a document Upload a PDF to create a new shelf. Processing runs asynchronously. SHELF_ID=$({baseDir}/scripts/shelv-upload.sh /path/to/document.pdf --name "My Document") With options: # Use a structuring template SHELF_ID=$({baseDir}/scripts/shelv-upload.sh document.pdf --name "Q4 Contract" --template legal-contract) # Enable review mode (pause before finalizing) SHELF_ID=$({baseDir}/scripts/shelv-upload.sh document.pdf --review) # Upload and wait for processing to complete SHELF_ID=$({baseDir}/scripts/shelv-upload.sh document.pdf --wait) The script prints the shelf public ID (e.g. shf_0123456789abcdef01234567) to stdout. Available templates: book, legal-contract, academic-paper. Omit to let Shelv auto-detect structure. Inline alternative (without the script): curl -X POST "https://api.shelv.dev/v1/shelves" \\ -H "Authorization: Bearer $SHELV_API_KEY" \\ -F "file=@document.pdf" \\ -F "name=My Document" Response (201): { "publicId": "shf_0123456789abcdef01234567", "name": "My Document", "status": "uploading", "template": null, "reviewMode": false, "pageCount": null, "createdAt": "2025-01-15T10:30:00.000Z", "updatedAt": "2025-01-15T10:30:00.000Z" } ### 2. Poll for processing completion Wait for a shelf to finish processing: {baseDir}/scripts/shelv-poll-status.sh shf_0123456789abcdef01234567 The script polls GET /v1/shelves/{id} every 5 seconds and prints the current status. It exits 0 when the shelf reaches ready or review, and exits 1 on failed (with error details) or timeout (10 minutes). Processing flow: uploading → parsing → structuring → verifying → ready If review mode is enabled, the flow pauses at review instead of ready. Inline alternative: curl -s "https://api.shelv.dev/v1/shelves/$SHELF_ID" \\ -H "Authorization: Bearer $SHELV_API_KEY" | jq '.status' ### 3. Hydrate a shelf into the workspace Download and extract the shelf's Markdown filesystem into your workspace: {baseDir}/scripts/shelv-hydrate.sh shf_0123456789abcdef01234567 This downloads the archive, verifies its checksum, and extracts it to ~/.openclaw/workspace/shelves//. The script prints a file listing after extraction. Override the directory name: {baseDir}/scripts/shelv-hydrate.sh shf_0123456789abcdef01234567 --name my-contract Replace an existing shelf (required if the directory already exists): {baseDir}/scripts/shelv-hydrate.sh shf_0123456789abcdef01234567 --force After hydration, explore the files: ls ~/.openclaw/workspace/shelves/my-contract/ cat ~/.openclaw/workspace/shelves/my-contract/README.md find ~/.openclaw/workspace/shelves/my-contract/ -name "*.md" grep -r "force majeure" ~/.openclaw/workspace/shelves/my-contract/ ### 4. List and browse existing shelves List all shelves: curl -s "https://api.shelv.dev/v1/shelves?page=1&limit=20" \\ -H "Authorization: Bearer $SHELV_API_KEY" | jq '.data[] | {publicId, name, status}' Get the file tree (flat JSON map of path → content): curl -s "https://api.shelv.dev/v1/shelves/$SHELF_ID/tree" \\ -H "Authorization: Bearer $SHELV_API_KEY" | jq '.files | keys[]' Response shape: { "shelfPublicId": "shf_0123456789abcdef01234567", "name": "My Contract", "fileCount": 8, "files": { "README.md": "# My Contract\\n...", "clauses/force-majeure.md": "# Force Majeure\\n..." } } ### 5. Read individual files without hydration Read a single file by path (useful for targeted lookups without downloading the full archive): curl -s "https://api.shelv.dev/v1/shelves/$SHELF_ID/files/README.md" \\ -H "Authorization: Bearer $SHELV_API_KEY" curl -s "https://api.shelv.dev/v1/shelves/$SHELF_ID/files/clauses/force-majeure.md" \\ -H "Authorization: Bearer $SHELV_API_KEY" Returns raw Markdown content (text/markdown). ### Workspace Conventions Hydrated shelves live at: ~/.openclaw/workspace/shelves/{name}/ The {name} is derived from the shelf's display name (lowercased, spaces and special characters replaced with hyphens). Override with --name when hydrating. If a directory already exists at the target path, the script will refuse to overwrite it unless --force is passed. After hydration, use standard Unix tools to explore: # List all files find ~/.openclaw/workspace/shelves/{name}/ -type f # Read a specific file cat ~/.openclaw/workspace/shelves/{name}/README.md # Search across all files grep -r "keyword" ~/.openclaw/workspace/shelves/{name}/ # Count files find ~/.openclaw/workspace/shelves/{name}/ -type f | wc -l ### Async Operations Shelf processing is asynchronous. After uploading, the shelf progresses through: uploading → parsing → structuring → verifying → ready Use the poll script to wait for completion: {baseDir}/scripts/shelv-poll-status.sh $SHELF_ID If the shelf reaches failed, the error message and failed step are printed. You can retry: curl -X POST "https://api.shelv.dev/v1/shelves/$SHELF_ID/retry" \\ -H "Authorization: Bearer $SHELV_API_KEY" For review mode shelves, approve to finalize: curl -X POST "https://api.shelv.dev/v1/shelves/$SHELF_ID/approve" \\ -H "Authorization: Bearer $SHELV_API_KEY" Or regenerate the structure: curl -X POST "https://api.shelv.dev/v1/shelves/$SHELF_ID/regenerate" \\ -H "Authorization: Bearer $SHELV_API_KEY" ### Status-Gated Endpoint Matrix Not all endpoints are available in every status. The archive, tree, and file endpoints require ready or review: EndpointProcessingreviewreadyfailedGET /v1/shelves/{id}YesYesYesYesGET .../treeNoYesYesNoGET .../files/*NoYesYesNoGET .../archive-urlNoYesYesNoPOST .../approveNoYesNoNoPOST .../regenerateNoYesNoNoPOST .../retryNoNoNoYes A 409 Conflict is returned if you call an endpoint outside its allowed statuses. ### Rate Limits ScopeLimitReads (GET)120 requests / minWrites (POST/DELETE)20 requests / minShelf creation10 / hour On 429 Too Many Requests, back off and retry after the indicated period. ### Reference Pointers For detailed API documentation, error codes, and lifecycle diagrams, see: {baseDir}/references/api-reference.md — Full endpoint docs and response shapes {baseDir}/references/shelf-lifecycle.md — Status flow, review mode, template behavior {baseDir}/references/error-handling.md — Error codes, retry strategies ## Trust - Source: tencent - Verification: Indexed source record - Publisher: JoshuaOHanlon - Version: 1.0.3 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-30T18:53:21.485Z - Expires at: 2026-05-07T18:53:21.485Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/shelv) - [Send to Agent page](https://openagent3.xyz/skills/shelv/agent) - [JSON manifest](https://openagent3.xyz/skills/shelv/agent.json) - [Markdown brief](https://openagent3.xyz/skills/shelv/agent.md) - [Download page](https://openagent3.xyz/downloads/shelv)