# Install the "OpenAPI 3.1 & REST Documentation" skill

You are installing an AgenticMarket skill into this workspace. Follow these steps exactly.

## 1. Detect your environment and choose the destination file
- Andromity: `.andromity/skills/openapi-swagger-docs/SKILL.md` (or user scope `~/.andromity/skills/openapi-swagger-docs/SKILL.md`)
- Antigravity / Gemini CLI: `.agent/skills/openapi-swagger-docs/SKILL.md`
- Cursor: `.cursor/rules/openapi-swagger-docs.mdc`
- Claude Code: append to `CLAUDE.md` (or `.claude/skills/openapi-swagger-docs.md`)
- Windsurf: append to `.windsurfrules`
- Cline / Roo Code: `.clinerules/openapi-swagger-docs.md`
- GitHub Copilot: append to `.github/copilot-instructions.md`
- ChatGPT / web only: paste the content into Custom Instructions
- Any other agent: save to `.agent/skills/openapi-swagger-docs/SKILL.md`

## 2. Create the destination file
- Preserve every existing file and configuration entry.
- Create parent folders as needed.
- Never overwrite unrelated content.

## 3. Write exactly this content

```markdown
---
name: openapi-swagger-docs
description: "Design standard OpenAPI 3.1 specifications, typed request/response schemas, authentication schemes, and Swagger UI."
author: community
license: mit
version: 1.0.0
---
# OpenAPI 3.1 Specification Design

Writing clear REST documentation:
- Define reusable components under `#/components/schemas`.
- Document every HTTP status code (200, 400, 401, 404, 429, 500) with concrete response examples.
```

## 4. Verify
- Confirm the file exists and is readable.
- Report the destination path and confirm the "OpenAPI 3.1 & REST Documentation" skill is installed and active.

Skill metadata:
- Slug: openapi-swagger-docs
- Category: development
- License: mit
- Source: AgenticMarket