API 문서 작성기 (스페인어판)

무엇을 해주나

• 엔드포인트 설명, 원시 스펙, Postman export를 받아 표준화된 레퍼런스 문서로 변환합니다.
• 요약/설명/인증 방식 → 요청(헤더·경로·쿼리 파라미터·바디 표) → 응답(필드 타입 표) → 에러 코드 표(해결 방법 포함) → 최소 2개 언어의 코드 예시(기본 cURL + Python) 순서로 출력합니다.
• 누락된 정보는 질문으로 막지 않고 (assumed, confirm) 표시 후 가정 목록을 문서 끝에 정리합니다.
• 0~40점 자체 채점 루브릭(파라미터 완전성, 에러 경로 커버리지, 예시 실행 가능성, 동작 솔직성)과 품질 체크리스트·안티패턴 목록으로 결과를 검수합니다.
• references/example-first-docs.md, templates/endpoint-entry.md 보조 파일을 함께 활용합니다.
• 주의: OpenAPI YAML 스펙 파일은 생성하지 않습니다(Markdown 또는 Confluence/Notion용 산문 출력).

이런 분께 추천

• API를 만들었지만 문서 작성에 시간을 쓰기 어려운 백엔드 개발자
• 개발자 포털·README·Notion 문서를 관리하는 테크니컬 라이터, DevRel
• 파트너사에 제공할 외부 API 레퍼런스를 정비해야 하는 팀
• 스페인어 환경에서 작업하는 팀(스페인어 번역본)

활용 예시

1. "이 엔드포인트를 문서화해줘: POST /v1/orders, Bearer 인증, body는 items/currency" → 파라미터 표, 200 응답 예시, 400/401/404/429/500 에러 표, cURL·Python 예시가 한 번에 생성됩니다.
2. Postman 컬렉션 JSON을 붙여넣고 "개발자용 문서로 변환"을 요청하면 엔드포인트별 레퍼런스 페이지 묶음이 나옵니다.
3. "우리 결제 API 개발자 가이드를 작성해줘" → 인증, 페이지네이션, 레이트 리밋 주의사항까지 포함된 가이드 초안을 받습니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/mohitagw15856/pm-claude-skills/HEAD/i18n/es/skills/api-docs-writer/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 mohitagw15856/pm-claude-skills 의 i18n/es/skills/api-docs-writer 폴더를 내 ~/.claude/skills/api-docs-writer/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.