Menú
Use when writing or editing .omg.md files - the human-first DSL for API specification that compiles to OpenAPI 3.1
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | omg |
| description | Use when writing or editing .omg.md files - the human-first DSL for API specification that compiles to OpenAPI 3.1 |
---
method: GET
path: /accounts/{accountId}
operationId: get-account
tags: [Accounts]
---
# Get Account
Returns details of a specific account.
```omg.path
{ accountId: uuid }
{ id: uuid, name: string, balance: decimal }
## Core Concepts
- **`.omg.md` files** - Markdown with YAML frontmatter, one endpoint per file
- **Code blocks**: `omg.path`, `omg.query`, `omg.body`, `omg.response`, `omg.response.{code}`, `omg.returns`, `omg.type`
- **Types**: `string`, `integer`, `decimal`, `boolean`, `date`, `datetime`, `uuid`, `any`
- **Syntax**: `field?: type` (optional), `type[]` (array), `"a"|"b"` (enum), `@min(0)` (constraints)
- **Partials**: `@path/to/partial`, `{{> path/to/partial }}`, or a Markdown link to a `.omg.md` file (`[label](../partials/x.omg.md)`, resolved relative to the document and clickable in GitHub) for reuse
## CLI
```bash
node packages/omg-md-cli/dist/cli.js build api.omg.md -o output.yaml
node packages/omg-md-cli/dist/cli.js parse endpoint.omg.md
npm run build before using CLIUse when building CLI tools with Commander.js - commands, options, arguments, and help text for Node.js command-line applications
Use when parsing or generating Markdown following the CommonMark specification - AST structure, block/inline elements, and extensions
Use when creating GitHub Actions workflows for CI/CD - testing, building, publishing npm packages, and automating repository tasks
Use when working with JSON Schema for validation, OpenAPI schemas, type definitions, and data structure specification
Use when implementing Language Server Protocol features - diagnostics, completions, hover, go-to-definition, and editor integration
Use when managing npm workspaces monorepos - package dependencies, build ordering, cross-package development, and publishing workflows