Address PR review findings

- Replace <uuid> placeholder with actual UUID format in error template
  to prevent literal output
- Make version-propagation note future-proof by removing hardcoded v2.15
  reference and adding "check the actual file" guidance
- Consolidate CLAUDE.md skill directive into single paragraph

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: VedranZoricic

.claude/skills/generate-openapi-from-pr/ruby-to-openapi-mapping.md

@@ -404,7 +404,7 @@ Maps to:
         Resource not found:
           value:
             type: error.list
-            request_id: <uuid>
+            request_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
             errors:
             - code: not_found
               message: Resource Not Found

.claude/skills/generate-openapi-from-pr/version-propagation.md

@@ -77,7 +77,7 @@ intercom_version:
   - '2.14'
 ```
 
-Note: The v2.15 spec has `default: '2.14'` and does NOT include `'2.15'` in its own enum. This is an existing pattern — follow it.
+Note: Stable specs set `default` to the previous stable version and do NOT include their own version number in the enum. For example, v2.15 has `default: '2.14'` and does not list `'2.15'`. Always check the actual file to confirm the pattern before editing — it may evolve with future releases.
 
 ### info.version
 

CLAUDE.md

@@ -124,9 +124,7 @@ fern generate --group ts-sdk
 
 ## Skills
 
-- **generate-openapi-from-pr** — Takes an intercom monolith PR and generates OpenAPI spec changes. Provide a PR URL/number from `intercom/intercom` and the skill analyzes the diff (controllers, presenters, version changes, routes) to produce the corresponding YAML updates in the target spec file(s). See `.claude/skills/generate-openapi-from-pr/SKILL.md`.
-
-When a user provides an `intercom/intercom` PR URL or asks to generate OpenAPI docs from a PR, always use the `generate-openapi-from-pr` skill. Invoke it with: `/generate-openapi-from-pr <pr-url>`
+- **generate-openapi-from-pr** — Takes an intercom monolith PR and generates OpenAPI spec changes. Provide a PR URL/number from `intercom/intercom` and the skill analyzes the diff (controllers, presenters, version changes, routes) to produce the corresponding YAML updates in the target spec file(s). See `.claude/skills/generate-openapi-from-pr/SKILL.md`. This is the primary workflow for this repo — always use it when a user provides an intercom PR URL or asks to update the spec from a PR.
 
 ## Downstream Consumers