verify

Verify ade CLI changes end-to-end by seeding offline stores and driving generated artifacts in a browser.

2.4k|255|Updated Mar 12, 2025
One-click install
npx skills add https://github.com/landing-ai/ade-cli --skill verify-landing-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: verify
Source: https://github.com/landing-ai/ade-cli/tree/main/.claude/skills/verify
Command: npx skills add https://github.com/landing-ai/ade-cli --skill verify-landing-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Testing the ade CLI normally requires live API calls to parse documents, which makes end-to-end verification slow, costly, and network-dependent. This Skill shows how to verify CLI changes offline by seeding a local store with the exact artifacts parse would produce, then running the real CLI and inspecting generated outputs like view.html in a browser. ## Core Features & Use Cases - Offline Store Seeding: Write parse.json, parse.md, elements.json, and meta.json directly into a store directory, matching what parse.py::write_artifacts produces, so no API call is needed. - Deterministic Fixtures: Build markdown piecewise so every element's range is exact, reuse tests/parse_fixtures.py shapes, and draw a matching invoice PNG so bounding boxes visibly align. - Browser-Driven Verification: Serve the doc directory over HTTP (since the in-app browser refuses file://), deep-link to elements with #element=<id>, and inspect selection state via JavaScript. - Use Case: After modifying the view command, seed a store with ADE_HOME=<dir>, run uv run ade view, serve the output on http://127.0.0.1:8742/view.html, and confirm element highlighting and rebuild fingerprinting behave correctly. ## Quick Start Seed an offline ade store with parse artifacts, point the CLI at it using ADE_HOME, then serve and inspect the generated view.html in a browser to verify the changes.

Frequently Asked Questions about verify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test the ade CLI without an API key or network access?▼

Seed the store directly by writing the files `parse` would produce: `parse.json`, `parse.md`, `elements.json`, and `meta.json` with a matching `job_id`. Then point the CLI at the seeded directory using the `ADE_HOME` environment variable.

How do I open the generated view.html file in a browser?▼

The in-app browser refuses `file://` URLs, so serve the document directory instead with `python3 -m http.server 8742 --bind 127.0.0.1` inside `$ADE_HOME/docs/<doc-id>/`, then browse to `http://127.0.0.1:8742/view.html`.

Why does the seeded store get rejected by the CLI?▼

The generation gate in `refs.live_parse` rejects stores where `meta.json`'s `job_id` does not match the `metadata.job_id` inside `parse.json`. Ensure both IDs match and `meta.json` has `state: "parsed"`.

How do I force the view command to rebuild its output?▼

Rebuilds are fingerprint-gated, and the `--json` output reports `built: true|false`. Touching the source file or changing the `--dpi` flag forces a rebuild of the viewer.

How do I inspect element selection state in the view.html page?▼

Use JavaScript in the browser console: `document.querySelectorAll('.sel')` returns selected elements, and both panes share `data-id` attributes. You can also deep-link to a specific element by appending `#element=<id>` to the URL.