spec-from-datasheet

Generate structured chip specification markdown from ESPHome docs and component datasheets.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/mohankumargupta/skills --skill spec-from-datasheet-mohankumargupta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-from-datasheet
Source: https://github.com/mohankumargupta/skills/tree/main/spec-from-datasheet
Command: npx skills add https://github.com/mohankumargupta/skills --skill spec-from-datasheet-mohankumargupta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pymupdf4llm, waybackpy, and includes scripts (resource) and assets (resource) components.

What problem does it solve? Writing an accurate hardware specification for a sensor or peripheral chip requires manually cross-referencing ESPHome component documentation and dense PDF datasheets, which is slow and error-prone. This Skill automates that pipeline: it locates the matching ESPHome component, downloads the official datasheet, converts the PDF to markdown, and fills a standardized chip spec template. ## Core Features & Use Cases - ESPHome Component Discovery: Clones the esphome.io docs and ESPHome source, then searches them to map a device name to its ESPHome component and source code. - Datasheet Retrieval & Conversion: Resolves datasheet URLs (including archived Analog Devices links via the Wayback Machine) and converts PDF datasheets to markdown using pdf2md with offline OCR. - Structured Spec Generation: Fills a rigorous chip spec template covering register maps, bit fields, I2C/SPI transport configuration, initialization sequences, and data conversion formulas with worked examples. - Use Case: Given a device like the ADS1115 ADC, produce a complete spec markdown file with its register map, I2C addressing, and raw-to-voltage conversion formulas ready for driver development or chip emulation. ## Quick Start Ask the agent to create a spec markdown from the datasheet for your device, for example: create a spec for the bme280 sensor.

Frequently Asked Questions about spec-from-datasheet

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

FAQPage Schema
How do I create a chip specification from a PDF datasheet?▼

Provide the device name and the skill locates the matching ESPHome component docs, downloads the official datasheet PDF, converts it to markdown with pdf2md OCR, and fills a standardized template covering register maps, transports, and conversion formulas.

How do I find the ESPHome component for a sensor device?▼

The skill clones the esphome.io component docs and ESPHome source, then searches them with ripgrep for the device name. If the device name differs from the component name, it searches the ESPHome source first and maps the result back to the docs.

What does the generated chip spec markdown contain?▼

The spec includes manufacturer, category, I2C/SPI transport configuration, pin functions, interrupt behavior, a full register map with bit fields, initialization sequence, and data conversion formulas with worked examples and explicit encoding notes.

What happens if a datasheet URL is no longer available?▼

For analog.com datasheets, the included analog.sh script queries the Wayback Machine CDX API and returns an archived snapshot URL of the datasheet, so dead links can still be downloaded.

Does the PDF to markdown conversion require internet access?▼

The conversion runs pdf2md with offline OCR using local pdfium and onnxruntime libraries plus a local OCR model directory, so extraction itself works offline once the datasheet PDF is downloaded.