ToolJet Marketplace Plugin Builder
ToolJet/ToolJet
Turns an API description, such as an OpenAPI file or a Postman collection, into a connector plugin for ToolJet's marketplace and checks it with the repo's validator.
OpenAPI/Swagger expert for API specification design, validation, and code generation
Install Openapi Expert
$ npx skills add RightNow-AI/openfang --skill openapi-expert -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install RightNow-AI/openfang openapi-expert --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/RightNow-AI/openfang.git skills-src && mkdir -p .claude/skills && cp -r skills-src/crates/openfang-skills/bundled/openapi-expert .claude/skills/openapi-expert && rm -rf skills-srcUse ~/.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/
Install the "openapi-expert" agent skill from https://github.com/RightNow-AI/openfang/tree/main/crates/openfang-skills/bundled/openapi-expert into .claude/skills/openapi-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "openapi-expert", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/RightNow-AI/openfang/tree/main/crates/openfang-skills/bundled/openapi-expertType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add RightNow-AI/openfang --skill openapi-expert -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install RightNow-AI/openfang openapi-expert --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/RightNow-AI/openfang.git skills-src && mkdir -p .agents/skills && cp -r skills-src/crates/openfang-skills/bundled/openapi-expert .agents/skills/openapi-expert && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "openapi-expert" agent skill from https://github.com/RightNow-AI/openfang/tree/main/crates/openfang-skills/bundled/openapi-expert into .agents/skills/openapi-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "openapi-expert", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add RightNow-AI/openfang --skill openapi-expert -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install RightNow-AI/openfang openapi-expert --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/RightNow-AI/openfang.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/crates/openfang-skills/bundled/openapi-expert .cursor/skills/openapi-expert && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "openapi-expert" agent skill from https://github.com/RightNow-AI/openfang/tree/main/crates/openfang-skills/bundled/openapi-expert into .cursor/skills/openapi-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "openapi-expert", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/RightNow-AI/openfang.git --path crates/openfang-skills/bundled/openapi-expert--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add RightNow-AI/openfang --skill openapi-expert -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install RightNow-AI/openfang openapi-expert --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/RightNow-AI/openfang.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/crates/openfang-skills/bundled/openapi-expert .gemini/skills/openapi-expert && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "openapi-expert" agent skill from https://github.com/RightNow-AI/openfang/tree/main/crates/openfang-skills/bundled/openapi-expert into .gemini/skills/openapi-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "openapi-expert", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install RightNow-AI/openfang openapi-expertInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add RightNow-AI/openfang --skill openapi-expert -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/RightNow-AI/openfang.git skills-src && mkdir -p .github/skills && cp -r skills-src/crates/openfang-skills/bundled/openapi-expert .github/skills/openapi-expert && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "openapi-expert" agent skill from https://github.com/RightNow-AI/openfang/tree/main/crates/openfang-skills/bundled/openapi-expert into .github/skills/openapi-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "openapi-expert", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add RightNow-AI/openfang --skill openapi-expert -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install RightNow-AI/openfang openapi-expert --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/RightNow-AI/openfang.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/crates/openfang-skills/bundled/openapi-expert .opencode/skills/openapi-expert && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "openapi-expert" agent skill from https://github.com/RightNow-AI/openfang/tree/main/crates/openfang-skills/bundled/openapi-expert into .opencode/skills/openapi-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "openapi-expert", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
openapi-expert- GitHub stars
- 18k
- Token cost
- ~1k tokens
- SKILL.md length
- 527 words
- Files
- 1
- Skills in repo
- 68
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
OpenAPI/Swagger expert for API specification design, validation, and code generation
- Tasks that involve OpenAPI specifications
- SKILL.md covers Key Principles, Techniques, Common Patterns and Pitfalls to Avoid
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Openapi Expert is an agent skill from RightNow-AI/openfang. OpenAPI/Swagger expert for API specification design, validation, and code generation
Its SKILL.md is about 1k 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 Backend & APIs, covering OpenAPI specifications. It works with OpenAPI. The repository describes itself as: Open-source Agent Operating System. The licence is Apache-2.0.
When your agent uses it
- Tasks that involve OpenAPI specifications
Example prompts
- “/openapi-expert”
What it can do on your machine
Read from SKILL.md and the folder at commit acf2587. 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.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Openapi Expert loads about 1k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 527 words of instructions outside code blocks.
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 RightNow-AI/openfang at commit acf2587, republished under its Apache-2.0 licence (© RightNow-AI). 527 words, ~1,022 tokens.
Download SKILL.mdSave it as
.claude/skills/openapi-expert/SKILL.md (or your agent's skills folder).- name
- openapi-expert
- description
- OpenAPI/Swagger expert for API specification design, validation, and code generation
OpenAPI Expert
An API design architect with deep expertise in the OpenAPI Specification, RESTful API conventions, and the tooling ecosystem for validation, documentation, and code generation. This skill provides guidance for designing clear, consistent, and evolvable API contracts using OpenAPI 3.0 and 3.1, covering schema composition, security definitions, versioning strategies, and developer experience optimization.
Key Principles
- Design the API specification before writing implementation code; the spec serves as the contract between frontend, backend, mobile, and third-party consumers
- Use $ref extensively to define reusable schemas, parameters, and responses in the components section; duplication across paths leads to inconsistency and maintenance burden
- Version your API explicitly through URL path prefixes (/v1/, /v2/) or custom headers; never break existing consumers by changing response shapes without a version boundary
- Write meaningful descriptions for every path, parameter, schema property, and response; the spec doubles as your API documentation and should be understandable without reading source code
- Validate the spec in CI using linting tools to catch breaking changes, missing descriptions, inconsistent naming, and schema errors before they reach production
Techniques
- Structure the OpenAPI document with info (title, version, contact), servers (base URLs per environment), paths (endpoints), and components (schemas, securitySchemes, parameters, responses)
- Compose schemas using allOf for inheritance (base object + extension), oneOf for polymorphism (exactly one match), and anyOf for flexible unions (at least one match)
- Provide request and response examples at both the schema level and the media type level; tools like Swagger UI and Redoc render these prominently for developer reference
- Define security schemes (Bearer JWT, API key, OAuth2 flows) in components/securitySchemes and apply them globally or per-operation with the security field
- Distinguish path parameters (/users/{id}), query parameters (?page=2&limit=20), and header parameters for different use cases; path parameters identify resources, query parameters filter or paginate
- Implement consistent pagination with limit/offset or cursor-based patterns, documenting the pagination metadata schema (total, next_cursor, has_more) in a reusable component
- Generate server stubs and client SDKs using openapi-generator with language-specific templates; customize templates for your coding conventions
Show full SKILL.md (198 more words)Show less
Common Patterns
- Error Response Schema: Define a reusable error object with code (machine-readable string), message (human-readable), and details (array of field-level errors) applied consistently across all error responses
- Polymorphic Responses: Use discriminator with oneOf to model responses that can be different types (e.g., a notification that is either an EmailNotification or PushNotification) with a type field
- Pagination Envelope: Wrap list responses in a standard envelope with data (array of items), pagination (cursor or offset metadata), and optional meta (total count, timing)
- Webhook Definitions: Use the webhooks section (OpenAPI 3.1) to document callback payloads your API sends to consumers, specifying the event schema and expected acknowledgment
Pitfalls to Avoid
- Do not use additionalProperties: true by default; it makes schemas permissive and hides unexpected fields that may cause client parsing issues
- Do not define inline schemas for every request and response body; extract them to components/schemas with descriptive names for reuse and clarity
- Do not mix naming conventions (camelCase and snake_case) within the same API; pick one convention and enforce it with a linter rule
- Do not skip providing enum descriptions; raw enum values like "PENDING", "ACTIVE", "SUSPENDED" need documentation explaining what each state means and what transitions are valid
© RightNow-AI, Apache-2.0. 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 crates/openfang-skills/bundled/openapi-expert of RightNow-AI/openfang.
Open the folder on GitHubat commit acf2587
Compare with similar skills
Openapi Expert 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Openapi Expert this skillRightNow-AI/openfang | 18k | — | ~1k | Automated safety check: Pass | Apache-2.0 | |
| ToolJet Marketplace Plugin BuilderToolJet/ToolJet | 41k | — | ~2.1k | Automated safety check: Pass | AGPL-3.0 | |
| Step Partsearthtojake/text-to-cad | 18k | 1 repos | ~1.5k | Automated safety check: Pass | MIT | |
| API DesignerJeffallan/claude-skills | 12k | 2 repos | ~2k | Automated safety check: Pass | MIT | |
| OpenAPI to MCP Servermcp-use/mcp-use | 11k | — | ~5.2k | Automated safety check: Pass | Apache-2.0 | |
| Use Yaakmountain-loop/yaak | 19k | — | ~1.9k | Automated safety check: Pass | MIT |
Similar skills
Step Parts
earthtojake/text-to-cad
Find, evaluate, and download common purchasable CAD parts from step.parts, including named off-the-shelf actuators, servos, motors, electronics boards, connectors, screws, bolts, nuts, washers…
API Designer
Jeffallan/claude-skills
Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.
OpenAPI to MCP Server
mcp-use/mcp-use
Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.
Use Yaak
mountain-loop/yaak
A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…
Old Coder API Design
AmazingAng/old-coder
Reviews or designs an HTTP/JSON API's endpoints, auth, pagination, versioning and deprecations, guarding against inventing a bespoke interface or silently breaking consumers.
More from RightNow-AI/openfang
All 68 skills in this repoPlaywright Browser Automation Patterns
RightNow-AI/openfang
Reference of CSS selectors, step-by-step web workflows and error recovery tactics for an agent that browses, fills forms and compares prices on live sites.
Intelligence Collection Methodology
RightNow-AI/openfang
Reference knowledge for open-source intelligence collection: the collection cycle, source reliability tiers, search query patterns and entity extraction.
Lead Generation Research Guide
RightNow-AI/openfang
Reference knowledge for AI lead generation: building an ideal customer profile, researching prospects on the web, enriching lead records and finding email formats.
Video Clipping Reference
RightNow-AI/openfang
Command reference for cutting clips from online video: yt-dlp downloads, whisper transcription, SRT subtitle files and ffmpeg processing, with Windows, macOS and Linux differences.
Forecasting Expert Knowledge
RightNow-AI/openfang
Reference knowledge for AI forecasting: superforecasting principles, a signal taxonomy, confidence calibration rules and reasoning chains for making and tracking predictions.
Deep Research Methodology
RightNow-AI/openfang
Reference knowledge for AI deep research: a five-phase process, strategies by question type, CRAAP source scoring, cross-referencing, synthesis and citation formats.
Related
Works with
Categories
Questions about Openapi Expert
What does Openapi Expert do?
OpenAPI/Swagger expert for API specification design, validation, and code generation. Openapi Expert is an agent skill from RightNow-AI/openfang.
When should I use Openapi Expert?
Openapi Expert fits situations like: tasks that involve OpenAPI specifications.
How do I install Openapi Expert in Claude Code?
Run `npx skills add RightNow-AI/openfang --skill openapi-expert -a claude-code`. Or copy the skill folder (crates/openfang-skills/bundled/openapi-expert in RightNow-AI/openfang) into .claude/skills/openapi-expert in your project. Claude Code loads it when a task matches its description.
How do I install Openapi Expert in Codex?
Run `npx skills add RightNow-AI/openfang --skill openapi-expert -a codex`. Or copy the skill folder (crates/openfang-skills/bundled/openapi-expert in RightNow-AI/openfang) into .agents/skills/openapi-expert in your project. Codex loads it when a task matches its description.
Can I use Openapi Expert 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 RightNow-AI/openfang --skill openapi-expert -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openapi-expert, .gemini/skills/openapi-expert, .github/skills/openapi-expert and .opencode/skills/openapi-expert in your project.
What does Openapi Expert need to run?
SKILL.md names no scripts, command-line tools or credentials: Openapi Expert is instructions for the agent only.
Does Openapi Expert access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Openapi Expert 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 Openapi Expert use?
Openapi Expert is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Openapi Expert use?
About 1k tokens (SKILL.md is roughly 4.1k 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 Openapi Expert?
Skills that share tags, products or a category with Openapi Expert: ToolJet Marketplace Plugin Builder (ToolJet/ToolJet, 41k stars), Step Parts (earthtojake/text-to-cad, 18k stars), API Designer (Jeffallan/claude-skills, 12k stars) and OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Openapi Expert?
RightNow-AI (a GitHub organization) maintains it in RightNow-AI/openfang, which has 18,213 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on July 2, 2026.
Source: RightNow-AI/openfang on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.