Skip to content
Back to search

oh-my-patent

🏛️ The patent plugin for AI coding agents — turn technical ideas into patent disclosures with Claude Code, Codex, and OpenCode.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/illusionaireal--oh-my-patent/badge.svg)](/listings/illusionaireal--oh-my-patent)

HTML

<a href="/listings/illusionaireal--oh-my-patent"><img src="/api/listings/illusionaireal--oh-my-patent/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Build this preview from the checkout (Node.js >=22), then install the original Archimedes plugin into your patent workspace:

npm ci
npm run build
node dist/cli.js adapt install --tool codex --workspace-dir <workspace>

The default plugin mode retains all **14 agents, 6 skills, and 9 commands**. Use `--mode plugin` to select it explicitly. Open the workspace in your AI coding tool and use Archimedes or the host's plugin commands; see the [usage guide](docs/usage-en.md).

For the additional portable Skill mode, select one host and inspect its plan:

node dist/cli.js adapt install --mode skill --tool codex --workspace-dir <workspace> --dry-run
node dist/cli.js adapt install --mode skill --tool codex --workspace-dir <workspace>

Then select the `oh-my-patent` Skill and start with:

Use oh-my-patent to create a patent project about homomorphic encryption in privacy-preserving computing.

| Installation mode | Installed entry points | Selection | | --- | --- | --- | | Original plugin (default) | Archimedes + 14 agents, 6 skills, 9 commands | `adapt install [--mode plugin] --tool <host>` | | Additional Skill | One portable entry with bundled role resources and runtime | `adapt install --mode skill --tool <host>` |

Skill installation preserves existing plugin files, customizations, workspace rules and MCP configuration. Each mode has its own uninstall command. Choose which entry you invoke; simultaneous host discovery and mixed use of both modes in one project remain unverified. Installing the Skill does not migrate existing project state. See [installation modes and optional migration](docs/skill.md). The candidate remains `0.4.0-alpha.0`. An independent **Publish standalone Skill** workflow packages `oh-my-patent-skill` for npm; see [publication instructions](docs/skill.md#independent-npm-skill-publication). No npm publication has run in this work.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 211 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # oh-my-patent
  2. [![npm version](https://img.shields.io/npm/v/oh-my-patent.svg)](https://www.npmjs.com/package/oh-my-patent)
  3. [![npm downloads](https://img.shields.io/npm/dm/oh-my-patent.svg)](https://www.npmjs.com/package/oh-my-patent)
  4. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
  5. [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
  6. [![中文](https://img.shields.io/badge/中文-切换-orange.svg)](./README.zh-CN.md)
  7. <p align="center">
  8. <picture>
  9. <source media="(prefers-color-scheme: dark)" srcset="./assets/brand/png/logo-on-dark.png">
  10. <img src="./assets/brand/png/logo-primary.png" width="720"
  11. alt="oh-my-patent — Archimedes raising a patent document with a WOW! expression">
  12. </picture>
  13. </p>
  14. **Meet Archimedes. Turn your “Eureka!” into a patent disclosure.**
  15. A patent workflow toolkit for **Claude Code, Codex, and OpenCode**, available as a
  16. plugin or a portable Agent Skill.
  17. Archimedes orchestrates specialist agents across research, ideation, drafting,
  18. review, and diagrams—with traceable, forkable decision paths.
  19. ## Quick start
  20. Choose **Plugin** for Archimedes with 14 agents, 6 skills and 9 commands, or
  21. **Skill** for one portable entry with bundled role resources and runtime.
  22. Node.js >=22 is required. Both modes support Claude Code, Codex and OpenCode.
  23. Run installation commands in your patent workspace.
  24. ### Plugin installation (default)
  25. ```bash
  26. npm install -g oh-my-patent
  27. oh-my-patent adapt install
  28. ```
  29. The first command installs the CLI globally for project management. The second
  30. installs the plugin configurations for Claude Code, Codex and OpenCode in the current
  31. workspace. To install only one host, optionally append `--tool claude-code`,
  32. `--tool codex` or `--tool opencode` to the second command.
  33. Open the workspace in your host and select Archimedes; see the
  34. [usage guide](docs/usage-en.md) for enabling its entry point.
  35. <details>
  36. <summary>Quick installation with npx</summary>
  37. Run the installer without first installing the CLI globally:
  38. ```bash
  39. npx oh-my-patent@latest adapt install
  40. ```
  41. This writes the same plugin configurations to the workspace. For later CLI commands,
  42. use `npx oh-my-patent@latest <command>` or install the CLI globally as above.
  43. </details>
  44. ### Skill installation
  45. Use the [Skills CLI](https://github.com/vercel-labs/skills) with Git and Node.js >=22.20:
  46. ```bash
  47. npx skills add illusionaireal/oh-my-patent
  48. ```
  49. The installer discovers the packaged `oh-my-patent` Skill and detects hosts.
  50. When prompted, select Claude Code, Codex or OpenCode, **Project** scope and **Copy**
  51. to install the complete Skill and runtime into the current workspace. Append
  52. `--skill oh-my-patent --copy` to select the Skill and copy method explicitly.
  53. Open the workspace in the selected host and select `oh-my-patent`.
  54. For use across projects, append `--global` for user-level installation.
  55. No global oh-my-patent CLI is required. This command follows the repository's
  56. default branch; npm `@latest` follows the latest published package.
  57. <details>
  58. <summary>Other Skill installation methods: ZIP, project CLI and npm archive</summary>
  59. **ZIP download — manual installation**
  60. Open [GitHub Releases](https://github.com/illusionaireal/oh-my-patent/releases),
  61. choose a published version and download its `oh-my-patent-skill-VERSION.zip` asset.
  62. Copy the complete `oh-my-patent` directory inside the archive to the Skill
  63. location for your host below. The runtime is included; no source build is needed.
  64. The Release also includes `SHA256SUMS` for checking downloaded archives.
  65. **oh-my-patent CLI — managed installation**
  66. Use this method for the project's installation backups and rollback commands.
  67. Replace `<host>` with the value for your selected host in the table:
  68. ```bash
  69. npx oh-my-patent@latest adapt install --mode skill --tool <host>
  70. ```
  71. | Host | Skills CLI `--agent` / project CLI `--tool` | Manual Skill location in the workspace |
  72. | --- | --- | --- |
  73. | Claude Code | `claude-code` | `.claude/skills/oh-my-patent` |
  74. | Codex | `codex` | `.agents/skills/oh-my-patent` |
  75. | OpenCode | `opencode` | `.agents/skills/oh-my-patent` |
  76. Skills CLI also accepts `--agent <host>` to select a host explicitly. The project
  77. CLI's Skill mode requires `--tool <host>`; plugin mode treats it as optional.
  78. **Standalone npm archive**
  79. Download the [standalone npm package](docs/skill.md#standalone-skill-package-installation)
  80. for packaging or manual deployment. Extract the archive and copy the complete
  81. `package` directory to your host's Skill location.
  82. Keep `SKILL.md`, `references/`, `assets/` and `scripts/` together. Use the same
  83. installation method for updates and removal; see the [installation guide](docs/skill.md).
  84. </details>
  85. Environment checks and host-specific manual commands: [sentinel guide](docs/sentinel.md).
  86. ### Retrieval and drawing readiness
  87. The sentinel checks the runtime and reports research and drawing readiness separately.
  88. Research needs an available retrieval source; academic-only retrieval requires explicit
  89. acceptance of its limits. A configured MCP server still needs an actual host-tool check.
  90. Existing evidence can support independent drafting or drawing while a retrieval gap is resolved.
  91. For each figure, the workflow reuses an available saved local choice, then tries the
  92. local preference, direct SVG or another available local renderer. Missing Mermaid
  93. does not block startup. If the host supports timed selection, no response within
  94. 30 seconds uses the current local default; otherwise the default is immediate.
  95. Hosts bound local rendering to 60 seconds; a recorded failure or timeout can switch
  96. once from a local renderer to available SVG. No available local option stops that figure.
  97. Defaults do not authorize remote calls or spending. Drafts can proceed without preview,
  98. but final required figures need preview, current review and human acceptance.
  99. ### Start a project
  100. Open the same workspace in your selected host. For plugin mode, select Archimedes;
  101. for Skill mode, select `oh-my-patent`. Describe your topic, for example:
  102. ```text
  103. Create a patent project about homomorphic encryption in privacy-preserving computing.
  104. ```
  105. Archimedes guides you through collecting material, developing ideas, drafting the
  106. disclosure and reviewing it. See [compatibility](docs/compatibility.md) for
  107. host-specific requirements, and the [installation guide](docs/skill.md) for source
  108. builds, version selection, updates and removal.
  109. ## What you can do
  110. | Capability | What it gives you |
  111. |---|---|
  112. | Coordinate specialist agents | Research, ideation, patentability assessment, drafting, review, and technical responses under one orchestrator |
  113. | Keep decisions traceable | Saved rounds, scores, innovation snapshots, and reasons in `.brainstorm/`; branch from a recorded node or restore an idea |
  114. | Resume recorded work | Workflow state in `.patent/state.json` and agent outputs in `references/` provide context for continuing a project |
  115. | Generate patent figures | Specifications and editable SVG, optional local rendering or approved host image tools, with provenance and current review |
  116. | Inspect progress | CLI queries, Markdown reports, a terminal UI, and environment checks |
  117. The project brings the disclosure, its supporting material, and its decision history
  118. together in one project directory. Rendering engines and retrieval services have
  119. their own setup requirements; see the [usage guide](./docs/usage-en.md).
  120. ## From idea to disclosure
  121. ![Archimedes workflow overview: prepare and research, develop and assess ideas, draft disclosure and figures, review and revise, finalize disclosure and figures; with research and drafting feedback loops](./docs/images/workflow-overview-brand-v1.png)
  122. *Overview of the ten stages, grouped by purpose. Arrows back to research and
  123. drafting show where further work may be needed.*
  124. | Step | Workflow stages |
  125. |---|---|
  126. | Prepare and research | `INIT` → `RESEARCH` |
  127. | Develop and assess ideas | `BRAINSTORM_R1` → `BRAINSTORM_R2` |
  128. | Write and illustrate | `DRAFT` → `DIAGRAM_DRAFT` |
  129. | Review and revise | `QA_LOOP` → `FINAL_REVIEW` |
  130. | Refresh figures and finish | `DIAGRAM_FINAL` → `DONE` |
  131. Review can return to earlier stages. The [workflow reference](./docs/workflow-diagram-en.md)
  132. shows the supported transitions and explains scoring decisions separately from stage changes.
  133. ## How the team works
  134. | Pattern | Purpose |
  135. |---|---|
  136. | Orchestration | Archimedes coordinates specialists and carries project context between stages |
  137. | Adversarial brainstorming | Candidate ideas receive examiner-style challenges before selection |
  138. | Parallel evaluation | Security, compliance, and patentability specialists assess different dimensions |
  139. | Review and response | Reviewers raise issues; the technical responder proposes document changes |
  140. | Decision recording | The path recorder preserves rounds for comparison, branching, and recovery |
  141. The [agent reference](./docs/agents-en.md) lists the 14 registered agents, 6 skills,
  142. 9 commands, and their roles. Actual dispatch uses the capabilities of the selected host.
  143. ## Documentation
  144. | Read next | Contents |
  145. |---|---|
  146. | [Installation modes](./docs/skill.md) | Plugin and Skill setup, updates, removal and migration |
  147. | [Release notes](./docs/releases/0.4.2.md) | Version changes and upgrade guidance |
  148. | [Usage and CLI](./docs/usage-en.md) | Installation, platform differences, all CLI domains, and uninstall behavior |
  149. | [Workflow](./docs/workflow-diagram-en.md) | Ten stages, review loops, and threshold behavior |
  150. | [Agents and collaboration](./docs/agents-en.md) | Registered IDs, skills, commands, and collaboration patterns |
  151. | [Architecture and development](./docs/architecture-en.md) | Four layers, repository layout, project files, and development commands |
  152. | [Documentation index](./docs/README-en.md) | Bilingual guides and design references |
  153. | [Brand guide](./assets/brand/README.md) | Archimedes artwork and usage rules |
  154. Contributions are welcome. Read [CONTRIBUTING.md](./CONTRIBUTING.md) or
  155. [report an issue](https://github.com/illusionaireal/oh-my-patent/issues).
  156. Licensed under [MIT](./LICENSE).
  157. *With thanks to the* [*LINUX DO Community*](https://linux.do/)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.