Skip to content

Make use-runway-api self-contained and more helpful#14

Open
robinandeer wants to merge 1 commit intomainfrom
robin/improve-use-runway-api-discoverability
Open

Make use-runway-api self-contained and more helpful#14
robinandeer wants to merge 1 commit intomainfrom
robin/improve-use-runway-api-discoverability

Conversation

@robinandeer
Copy link
Copy Markdown
Collaborator

Goal

Acting on user feedback where the agent spent ~90s searching for runway-api.mjs before giving up. The script shipped at repo root (outside the skill folder), which npx skills add and similar installers don't copy. Also improving output presentation and adding missing request-body examples to rw-api-reference.

Changes

  • Script location: scripts/runway-api.mjsskills/use-runway-api/scripts/runway-api.mjs — follows the Anthropic skill convention of co-locating bundled resources with SKILL.md.
  • Path resolution: SKILL.md now uses <skill-dir> with an ordered fallback list (plugin caches, ~/.claude/skills/, ~/.agents/skills/, source checkout, $RUNWAY_SKILLS_DIR).
  • Output presentation: New "Presenting Generation Output" rules — lead with model + cost, embed images as Markdown, proactively offer local download, avoid raw signed URLs.
  • Request body reference: New section in rw-api-reference with minimal JSON bodies for every generation POST endpoint plus avatars / documents / realtime_sessions.
  • AUTH.md: Fixed env var names to match the runtime (RUNWAY_SKILLS_API_SECRET, _STAGE, _BASE_URL).
  • Plugins bumped to 2.1.0.

Known follow-up (not in this PR)

The rw-generate-* skills from #13 use bare scripts/generate_*.py relative paths, which will hit the same installation issue runway-api.mjs had. Happy to follow up.

- Co-locate runway-api.mjs with the skill (moved from scripts/ at repo root)
  so it installs cleanly via npx skills, Claude plugins, and Cursor plugins
- Document concrete skill-dir path resolution with ordered fallbacks;
  add RUNWAY_SKILLS_DIR as a hint
- Add opinionated "Presenting Generation Output" rules: lead with model + cost,
  embed images as Markdown, proactively offer local download, avoid raw
  signed URLs
- Add Request Body Reference to rw-api-reference covering every generation
  POST endpoint (text_to_image, etc.) plus avatars, documents, realtime_sessions
- Fix AUTH.md env var names to match the runtime (RUNWAY_SKILLS_API_SECRET,
  _STAGE, _BASE_URL)
- Bump plugins to 2.1.0
@robinandeer robinandeer requested a review from yining1023 April 16, 2026 19:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant