Skip to content
TakoAPI
Back to skills

shelv

by joshuaohanlon

Web & Frontend Development
358Downloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Convert PDFs into structured Markdown filesystems and hydrate them into your workspace for exploration.

Description

What This Skill Does

Shelv converts PDF documents into structured Markdown filesystems accessible via standard Unix tools. Upload a PDF through the API, wait for async processing, then extract the result into your workspace as real files. Supports templates for books, legal contracts, and academic papers.

Converts opaque PDFs into grep-able, find-able Markdown files without any custom parsing code or PDF libraries.

When to Use It

  • Searching a legal contract for specific clauses with grep
  • Extracting chapters from a research paper into browsable files
  • Converting a regulatory document for version-controlled editing
  • Scanning a book's structure before reading
  • Pulling targeted sections from a PDF without downloading the full archive

Example Workflow

INPUT

User asks: convert contract.pdf into searchable files and find all force majeure clauses

AGENT
  1. 1

    Upload contract.pdf using shelv-upload.sh with --template legal-contract and capture the shelf ID

  2. 2

    Poll processing status with shelv-poll-status.sh until shelf reaches ready state

  3. 3

    Hydrate the shelf into the workspace using shelv-hydrate.sh

  4. 4

    Run grep -r "force majeure" over the hydrated directory to find matching files

  5. 5

    Read matching clause files with cat

OUTPUT

Markdown files for each contract section under ~/.openclaw/workspace/shelves/contract/, with force majeure clause content printed to terminal

Requirements

  • SHELV_API_KEY environment variable
  • Shelv account at shelv.dev

Installation

clawhub install joshuaohanlon/shelv

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links