Agent skill

Runway Reference Architecture

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Design a Runway integration that separates admission, provider execution, reconciliation, media storage, and governance.

MITAuto-check passedBusiness, Finance & HR

Install Runway Reference Architecture

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill runway-reference-architecture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace runway-reference-architecture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/runway-reference-architecture .claude/skills/runway-reference-architecture && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
runway-reference-architecture
GitHub stars
2.8k
Token cost
~1.3k tokens
SKILL.md length
541 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Design a Runway integration that separates admission, provider execution, reconciliation, media storage, and governance.

  • Works in 6 steps: Define trust zones → Make operation state authoritative → Separate control and data planes → …
  • Reviewing system boundaries
  • SKILL.md covers Overview, Prerequisites, Instructions and Authentication, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Runway Reference Architecture is an agent skill from jeremylongshore/tons-of-skills-marketplace. Design a Runway integration that separates admission, provider execution, reconciliation, media storage, and governance. Use when reviewing system boundaries. Trigger with: "Runway architecture", "design Runway service", "Runway production topology".

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/official-docs.md`). Compatibility notes: Requires server-side Runway Dev access, current first-party documentation, an approved credit budget, and controlled media storage.

It sits in Business, Finance & HR, covering File uploads and storage and Accounting and bookkeeping. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Reviewing system boundaries
  • With: Runway architecture
  • Design Runway service
  • Runway production topology

Example prompts

  • “Runway architecture”
  • “design Runway service”
  • “Runway production topology”
  • “/runway-reference-architecture”

Requirements

  • Compatibility (from SKILL.md): Requires server-side Runway Dev access, current first-party documentation, an approved credit budget, and controlled media storage.
  • Pre-approved tools (allowed-tools): Read, Grep, Write, Edit

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Define trust zones
  2. Make operation state authoritative
  3. Separate control and data planes
  4. Apply governance at admission
  5. Reconcile asynchronously
  6. Design for change

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Write
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.dev.runwayml.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires server-side Runway Dev access, current first-party documentation, an approved credit budget, and controlled media storage.

    From compatibility in the SKILL.md frontmatter.

Context cost

Runway Reference Architecture loads about 1.3k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 70 tokens; SKILL.md has 541 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 541 words, ~1,329 tokens.

Download SKILL.mdSave it as .claude/skills/runway-reference-architecture/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
runway-reference-architecture
description
Design a Runway integration that separates admission, provider execution, reconciliation, media storage, and governance. Use when reviewing system boundaries. Trigger with: "Runway architecture", "design Runway service", "Runway production topology".
allowed-tools
Read, Grep, Write, Edit
compatibility
Requires server-side Runway Dev access, current first-party documentation, an approved credit budget, and controlled media storage.
version
2.0.0
argument-hint
[system-and-scale]
model
inherit
effort
high
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, runway, architecture, governance, reliability

Runway Production Control-Plane Architecture

Overview

The stable architecture centers on an internal operation record rather than a provider request. It isolates credentials, models asynchronous task state, applies cost and concurrency admission, preserves media in owned storage, and makes provider/API drift reviewable.

Prerequisites

  • Workload, SLO, data-classification, and budget requirements
  • Current Runway API, model, limits, pricing, and output contracts
  • Owners for security, media rights, moderation, operations, and finance

Instructions

Step 1: Define trust zones

Place clients outside the provider credential boundary. Put the admission API, task worker, reconciler, secret access, and provider egress in a server zone; isolate raw media and final assets by classification.

Step 2: Make operation state authoritative

Persist operation ID, actor, approval, request fingerprint, model or router policy, provider task ID, state timeline, budget, and output object. Enforce legal state transitions and unique provider IDs.

Step 3: Separate control and data planes

The control plane validates, queues, retrieves, cancels, and emits internal events. The data plane stages input, performs ephemeral upload when needed, validates output, and copies assets to owned storage.

Step 4: Apply governance at admission

Check rights, moderation policy, tenant quotas, credit ceiling, model allowlist, duration and ratio schema, and retention before creating billable work.

Step 5: Reconcile asynchronously

Workers honor per-model concurrency; reconcilers observe THROTTLED and terminal states with bounded polling. Internal consumers receive idempotent events derived from persisted transitions.

Step 6: Design for change

Pin SDK and API contracts, fingerprint official docs, use model-aware fixtures, canary upgrades, and support both direct model and approved router policies without scattering identifiers.

Authentication

Only server-side workers and restricted operational readers access the organization-scoped key. Signed media URLs are short-lived capabilities; application clients receive controlled internal asset URLs instead.

Tool Discipline

Use Read and Grep to inspect application configuration, provider documentation, lockfiles, fixtures, schemas, tests, and redacted operational evidence before proposing a change. Use Write or Edit only for an approved implementation, configuration, test, runbook, or redacted receipt. Do not create, cancel, delete, retry, deploy, rotate, revoke, publish, or otherwise mutate production Runway resources without explicit operator approval.

Show full SKILL.md (201 more words)Show less

Output

  • Component, trust-zone, data-flow, and state-transition design
  • Capacity, budget, security, retention, and failure policies
  • Migration, canary, rollback, and operational evidence plan

Return the environment, organization alias, operation and task identifiers, API and SDK versions, model or router policy, source-contract fingerprint, task-state evidence, credit boundary, output disposition, unresolved risk, rollback state, and final decision without exposing API secrets, prompt or media contents, or temporary signed URLs.

Examples

A multi-tenant product stores one internal operation per request, admits against tenant and organization budgets, submits through a per-model worker, reconciles provider state, signs an internal event, and serves the copied asset through its own authorization layer.

Error Handling

FailureResponse
Architecture has no durable provider task IDAdd transactional task identity before accepting restart or retry safety.
Browser calls Runway directlyMove the credential and provider call behind a protected server boundary.
Provider URL is the product asset URLIntroduce owned storage and an internal access-control layer.

Validation

Walk happy path, client disconnect, worker crash, throttling, safety failure, provider outage, output-copy failure, cancellation, key rotation, SDK upgrade, and rollback. Every scenario must preserve operation identity and bounded side effects.

Resources

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/.curated/runway-reference-architecture of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/official-docs.md

Open the folder on GitHubat commit cfae287

Compare with similar skills

Runway Reference Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Runway Reference Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Runway Reference Architecture this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.3kAutomated safety check: PassMIT
Sync Upstreamnyaruka/phonenumbers1.6k—~2.8kAutomated safety check: PassMIT
Radiology Tablehuang-sir1/radiology-skills1.9k—~1.3kAutomated safety check: PassCustom licence
ERPClaw ERP Controlleravansaber/erpclaw116—~18kAutomated safety check: PassGPL-3.0
Odoo Agency Fleet Reviewerpipe-org/mcp-odoo421—~699Automated safety check: PassMIT
Beancount Closebex-co/beancount-io297—~1.4kAutomated safety check: PassMIT

Similar skills

  • Sync Upstream

    nyaruka/phonenumbers

    Sync this Go port with a new upstream google/libphonenumber release — regenerate the embedded metadata and reconcile the ported Java logic.

    1.6k GitHub stars~2.8k tokensUpdated 8 days ago
    Business, Finance & HRAuto-check passed
  • Radiology Table

    huang-sir1/radiology-skills

    Create/audit editable publication tables with source reconciliation; not figures or statistical inference.

    1.9k GitHub stars~1.3k tokensUpdated 20 days ago
    Business, Finance & HRAuto-check passed
  • ERPClaw ERP Controller

    avansaber/erpclaw

    Operates the ERPClaw self-hosted ERP in plain language: accounting, invoicing, inventory, purchasing, tax, HR, payroll and reports, treating the ERP as the single source of truth.

    116 GitHub stars~18k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Odoo Agency Fleet Review

    erpipe-org/mcp-odoo

    Review many client Odoo databases at once through odoo-mcp's cross-instance tools — fleet-wide accounting health, per-client aging, partial-failure triage — for agencies and partners managing 5–50…

    421 GitHub stars~699 tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Beancount Close

    bex-co/beancount-io

    Close an accounting period in a Beancount ledger by reconciling each active account through beancount-reconcile, checking assertions and recurring gaps, reviewing flags, then proposing a commit with…

    297 GitHub stars~1.4k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Forward Implementation First

    Vuk97/forward-implementation-first

    Keeps an agent building and validating real output instead of servicing its own bookkeeping.

    176 GitHub stars~1.8k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Runway Reference Architecture

What does Runway Reference Architecture do?

Design a Runway integration that separates admission, provider execution, reconciliation, media storage, and governance. Runway Reference Architecture is an agent skill from jeremylongshore/tons-of-skills-marketplace. Design a Runway integration that separates admission, provider execution, reconciliation, media storage, and governance.

When should I use Runway Reference Architecture?

Runway Reference Architecture fits situations like: reviewing system boundaries; with: Runway architecture; design Runway service; runway production topology.

How do I install Runway Reference Architecture in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill runway-reference-architecture -a claude-code`. Or copy the skill folder (skills/.curated/runway-reference-architecture in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/runway-reference-architecture in your project. Claude Code loads it when a task matches its description.

How do I install Runway Reference Architecture in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill runway-reference-architecture -a codex`. Or copy the skill folder (skills/.curated/runway-reference-architecture in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/runway-reference-architecture in your project. Codex loads it when a task matches its description.

Can I use Runway Reference Architecture in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill runway-reference-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/runway-reference-architecture, .gemini/skills/runway-reference-architecture, .github/skills/runway-reference-architecture and .opencode/skills/runway-reference-architecture in your project.

What does Runway Reference Architecture need to run?

SKILL.md names no scripts, command-line tools or credentials: Runway Reference Architecture is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Write, Edit. Compatibility (from SKILL.md): Requires server-side Runway Dev access, current first-party documentation, an approved credit budget, and controlled media storage..

Does Runway Reference Architecture access the network?

SKILL.md names 1 domain. As links in the text: docs.dev.runwayml.com. This is read from the text; nothing was executed.

Is Runway Reference Architecture safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Runway Reference Architecture use?

Runway Reference Architecture is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Runway Reference Architecture use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 961 tokens, read only when the agent opens those files.

What are the alternatives to Runway Reference Architecture?

Skills that share tags, products or a category with Runway Reference Architecture: Sync Upstream (nyaruka/phonenumbers, 1.6k stars), Radiology Table (huang-sir1/radiology-skills, 1.9k stars), ERPClaw ERP Controller (avansaber/erpclaw, 116 stars) and Odoo Agency Fleet Review (erpipe-org/mcp-odoo, 421 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Runway Reference Architecture?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.