القائمة
Use when writing or editing .omg.md files - the human-first DSL for API specification that compiles to OpenAPI 3.1
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use 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
| 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 CLI