Agent skill

Patent Search

by ZimoLiao in ZimoLiao/scholaraio

A skill your agent uses when the user wants USPTO patent discovery, patent metadata lookup, application lookup, or downloadable patent candidates before ingest.

MITAuto-check passedLegal & Compliance

Install Patent Search

skills CLI
$ npx skills add ZimoLiao/scholaraio --skill patent-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZimoLiao/scholaraio patent-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/patent-search .claude/skills/patent-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
patent-search
GitHub stars
577
Token cost
~892 tokens
SKILL.md length
162 words
Files
1
Skills in repo
43
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants USPTO patent discovery, patent metadata lookup, application lookup, or downloadable patent candidates before ingest.

  • Works in 4 steps: 如果不需 ODP 的额外功能,直接使用默认 PPUBS(不加 --source… → 如需 ODP,访问… → 完成视频验证后获取 API Key → …
  • The user wants USPTO patent discovery
  • SKILL.md covers 用法, 输出示例, 推荐工作流 and 故障排除, plus 1 more section
  • Needs USPTO_ODP_API_KEY

What it does

Patent Search is an agent skill from ZimoLiao/scholaraio. Use when the user wants USPTO patent discovery, patent metadata lookup, application lookup, or downloadable patent candidates before ingest.

Its SKILL.md is about 890 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Legal & Compliance, covering Intellectual property. The repository describes itself as: Scholar All-In-One: A research infrastructure for AI agents. The licence is MIT.

When your agent uses it

  • The user wants USPTO patent discovery
  • Patent metadata lookup
  • Application lookup
  • Downloadable patent candidates before ingest

Example prompts

  • “/patent-search”

Requirements

  • A credential in USPTO_ODP_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 如果不需 ODP 的额外功能,直接使用默认 PPUBS(不加 --source odp)
  2. 如需 ODP,访问 https://data.uspto.gov/apis/getting-started 注册账号
  3. 完成视频验证后获取 API Key
  4. 配置到 config.local.yaml 或环境变量

What it can do on your machine

Read from SKILL.md and the folder at commit 777628b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and yaml).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • data.uspto.gov

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • USPTO_ODP_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Patent Search loads about 892 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 162 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~892

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZimoLiao/scholaraio at commit 777628b, republished under its MIT licence (© ZimoLiao). 162 words, ~892 tokens.

Download SKILL.mdSave it as .claude/skills/patent-search/SKILL.md (or your agent's skills folder).
name
patent-search
description
Use when the user wants USPTO patent discovery, patent metadata lookup, application lookup, or downloadable patent candidates before ingest.

patent-search — USPTO 专利搜索

通过 USPTO Patent Public Search (PPUBS) 搜索美国专利,无需 API Key,无需注册账号。

同时保留 USPTO Open Data Portal (ODP) API 作为可选后端(需要 API Key),用于更结构化的申请号查询。

注意:本命令仅用于搜索发现,不会直接入库。 如需将专利纳入知识库,请后续通过 patent-fetch 或 --fetch 下载 PDF 后放入 configured patent inbox(fresh 默认 data/spool/inbox-patent/),再执行 scholaraio pipeline ingest 走正常的专利入库流程(含公开号去重)。

用法

关键词搜索(默认 PPUBS,无需 API Key)
bash
# 基本搜索
scholaraio patent-search "artificial intelligence"

# 指定结果数量
scholaraio patent-search "neural network" --count 20

# 分页
scholaraio patent-search "semiconductor" --count 10 --offset 10
搜索并自动下载 PDF
bash
# 搜索并自动下载所有结果中的专利 PDF 到 configured patent inbox
scholaraio patent-search "quantum computing" --count 5 --fetch
高级查询语法(PPUBS)

PPUBS 支持字段限定检索,基本语法为 ("term").field.:

bash
# 标题检索
scholaraio patent-search '("artificial intelligence").title.'

# 发明人检索
scholaraio patent-search '("Smith").inventor.'

# 公开号检索
scholaraio patent-search '("US20230123456A1").publ.'

# 布尔组合
scholaraio patent-search '("artificial intelligence").title. AND ("neural network").title.'
使用 ODP API(需要 API Key)

若已配置 ODP API Key,可通过 --source odp 切换到 ODP 后端:

bash
# ODP 关键词搜索
scholaraio patent-search "artificial intelligence" --source odp

# 按申请号查询详情(ODP 支持更完整的结构化元数据)
scholaraio patent-search --application 17123456 --source odp

ODP API Key 配置方式:

  • config.local.yaml:
    yaml
    patent:
      uspto_odp_api_key: "your-api-key"
  • 环境变量:
    bash
    export USPTO_ODP_API_KEY="your-api-key"

输出示例

找到 3 / 1542 条 USPTO 专利结果

[1] SYSTEMS AND METHODS FOR MACHINE LEARNING BASED IMAGE PROCESSING
    Publication: US20230123456A1
    Inventors: John Doe, Jane Smith
    Filing: 2021-05-15
    Published: 2023-04-20
    Type: US-PGPUB
    下载: scholaraio patent-fetch US20230123456A1

[2] NEURAL NETWORK ACCELERATOR WITH DYNAMIC SPARSITY
    Publication: US11678901B2
    Inventors: Alice Wong
    Assignees: Example Corp
    Filing: 2020-03-10
    Published: 2023-06-13
    Type: USPAT
    下载: scholaraio patent-fetch US11678901B2

推荐工作流

方式一:搜索后手动下载
bash
# 1. 搜索发现目标专利
scholaraio patent-search "quantum computing" --count 10

# 2. 根据输出提示,手动下载感兴趣的专利
scholaraio patent-fetch US20230123456A1
方式二:搜索并自动下载
bash
# 1. 搜索并自动下载前 5 条结果的 PDF
scholaraio patent-search "quantum computing" --count 5 --fetch

# 2. 走正常 pipeline 入库
scholaraio pipeline ingest

# 3. 本地检索
scholaraio search "quantum computing"

故障排除

缺少 API Key(仅影响 --source odp)

搜索失败: 缺少 USPTO ODP API Key。请在 config.local.yaml 中配置...

解决方案:

  1. 如果不需 ODP 的额外功能,直接使用默认 PPUBS(不加 --source odp)
  2. 如需 ODP,访问 https://data.uspto.gov/apis/getting-started 注册账号
  3. 完成视频验证后获取 API Key
  4. 配置到 config.local.yaml 或环境变量

未找到专利

未找到与 '...' 相关的专利
  • 尝试简化关键词
  • 检查 PPUBS 字段语法是否正确(引号、括号、点号)
  • 对精确申请号查询,使用 --source odp --application <号码>

PPUBS 会话过期/403

  • 客户端会自动刷新会话并重试,通常无需手动处理
  • 若频繁失败,可能是网络波动,稍后再试

patent-fetch 下载失败

  • 美国专利会优先尝试 USPTO PPUBS 官方导出;若失败再回退 Google Patents
  • 该专利可能尚未提供可导出的 PDF(如非常新的 WO 专利)
  • 尝试在浏览器中打开专利页面确认
  • 部分专利需要换源(如 EPO)

相关功能

  • scholaraio patent-fetch — 下载指定专利 PDF 到 configured patent inbox(fresh 默认 data/spool/inbox-patent/)
  • scholaraio arxiv — arXiv 论文搜索与下载
  • 宿主 Agent 原生网页搜索 — 开放网页补充发现
  • scholaraio pipeline ingest — 将 inbox-patent 中的 PDF 入库
  • scholaraio search / scholaraio vsearch — 本地知识库检索

© ZimoLiao, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/patent-search of ZimoLiao/scholaraio.

Open the folder on GitHubat commit 777628b

Compare with similar skills

Patent Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Patent Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Patent Search this skillZimoLiao/scholaraio577—~892Automated safety check: PassMIT
Paper to Chinese Patent DrafterYuan1z0825/nature-skills47k1 repos~1.1kAutomated safety check: PassApache-2.0
Paper To Cn Patentsnipp-zha/Paper-to-patent-Skill1071 repos~959Automated safety check: PassNone
Patent Examinegfodor/legal-skills393—~4.8kAutomated safety check: PassGPL-3.0
Patent Auditgfodor/legal-skills393—~2.9kAutomated safety check: PassGPL-3.0
Replica BrandJakeschincariol/replica-skill1.4k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Paper to Chinese Patent Drafter

    Yuan1z0825/nature-skills

    Drafts Chinese invention patent applications and technical disclosures from research papers or inventor materials, tying each claim feature to source evidence.

    47k GitHub starsUsed in 1 repo~1.1k tokens
    Legal & ComplianceAuto-check passed
  • Paper To Cn Patent

    snipp-zha/Paper-to-patent-Skill

    Convert scientific papers, theses, technical reports, source code, figures, or research manuscripts into evidence-grounded Chinese invention patent drafts.

    107 GitHub starsUsed in 1 repo~959 tokens
    Legal & ComplianceAuto-check passed
  • Patent Examine

    gfodor/legal-skills

    Iteratively examine and revise a draft U.S. An agent skill from gfodor/legal-skills.

    393 GitHub stars~4.8k tokensUpdated 1 mo ago
    Legal & ComplianceAuto-check passed
  • Patent Audit

    gfodor/legal-skills

    Audit a draft U.S. An agent skill from gfodor/legal-skills.

    393 GitHub stars~2.9k tokensUpdated 1 mo ago
    Legal & ComplianceAuto-check passed
  • Replica Brand

    Jakeschincariol/replica-skill

    Names and rebrands an app clone so it is the user's own: name candidates with the trademark, domain, store and handle checks to run, a new palette checked for contrast, a logo brief, a voice guide…

    1.4k GitHub stars~1.1k tokensUpdated 8 days ago
    Legal & ComplianceAuto-check passed
  • Patent Workaround

    gfodor/legal-skills

    Adversarially pressure-test a draft or pending U.S. An agent skill from gfodor/legal-skills.

    393 GitHub stars~5.7k tokensUpdated 1 mo ago
    Legal & ComplianceAuto-check passed

More from ZimoLiao/scholaraio

All 43 skills in this repo
  • Document

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to create or inspect DOCX, PPTX, or XLSX files, generate a downloadable Office deliverable, or verify its structure and layout warnings with scholaraio…

    577 GitHub stars~674 tokensUpdated 15 days ago
    Auto-check passed
  • Academic Writing

    ZimoLiao/scholaraio

    A skill your agent uses when the user needs help choosing or organizing an academic-writing workflow by deliverable, stage, or format, including review articles, guided reading, paper sections, PPT…

    577 GitHub stars~827 tokensUpdated 15 days ago
    Auto-check passed
  • Arxiv

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to browse arXiv preprints, search arXiv directly, fetch a PDF by arXiv ID or URL, or send a preprint into the ScholarAIO ingest pipeline.

    577 GitHub stars~799 tokensUpdated 15 days ago
    Auto-check passed
  • Bioinformatics

    ZimoLiao/scholaraio

    A skill your agent uses when working on bioinformatics workflows such as alignment, variant calling, phylogenetics, or protein-structure analysis, especially across BLAST, minimap2, samtools…

    577 GitHub stars~1.4k tokensUpdated 15 days ago
    Auto-check passed
  • Citation Check

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to verify citations in AI-generated or human-written text against the local knowledge base and catch hallucinated, wrong, or missing references.

    577 GitHub stars~454 tokensUpdated 15 days ago
    Auto-check passed
  • Draw

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants diagrams, flowcharts, architecture visuals, data relationships, timelines, concept maps, Mermaid, Graphviz, drawio, or polished paper figures generated…

    577 GitHub stars~1.3k tokensUpdated 15 days ago
    Auto-check: notes

Questions about Patent Search

What does Patent Search do?

A skill your agent uses when the user wants USPTO patent discovery, patent metadata lookup, application lookup, or downloadable patent candidates before ingest. Patent Search is an agent skill from ZimoLiao/scholaraio. Use when the user wants USPTO patent discovery, patent metadata lookup, application lookup, or downloadable patent candidates before ingest.

When should I use Patent Search?

Patent Search fits situations like: the user wants USPTO patent discovery; patent metadata lookup; application lookup; downloadable patent candidates before ingest.

How do I install Patent Search in Claude Code?

Run `npx skills add ZimoLiao/scholaraio --skill patent-search -a claude-code`. Or copy the skill folder (.claude/skills/patent-search in ZimoLiao/scholaraio) into .claude/skills/patent-search in your project. Claude Code loads it when a task matches its description.

How do I install Patent Search in Codex?

Run `npx skills add ZimoLiao/scholaraio --skill patent-search -a codex`. Or copy the skill folder (.claude/skills/patent-search in ZimoLiao/scholaraio) into .agents/skills/patent-search in your project. Codex loads it when a task matches its description.

Can I use Patent Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZimoLiao/scholaraio --skill patent-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/patent-search, .gemini/skills/patent-search, .github/skills/patent-search and .opencode/skills/patent-search in your project.

What does Patent Search need to run?

Going by SKILL.md and its folder, Patent Search needs credentials named USPTO_ODP_API_KEY. Our summary lists: A credential in USPTO_ODP_API_KEY.

Does Patent Search access the network?

SKILL.md names 1 domain. As links in the text: data.uspto.gov. This is read from the text; nothing was executed.

Is Patent Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Patent Search use?

Patent Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Patent Search use?

About 892 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Patent Search?

Skills that share tags, products or a category with Patent Search: Paper to Chinese Patent Drafter (Yuan1z0825/nature-skills, 47k stars), Paper To Cn Patent (snipp-zha/Paper-to-patent-Skill, 107 stars), Patent Examine (gfodor/legal-skills, 393 stars) and Patent Audit (gfodor/legal-skills, 393 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Patent Search?

ZimoLiao (a GitHub user) maintains it in ZimoLiao/scholaraio, which has 577 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on September 25, 2026.

Source: ZimoLiao/scholaraio on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.