New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Flyio SDK Patterns

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

Build a typed local adapter for the Fly.io Machines REST API with scoped auth, state waits, limits, reconciliation, and contract tests.

MITAuto-check passedBackend & APIs

Install Flyio SDK Patterns

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill flyio-sdk-patterns -a claude-code

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace flyio-sdk-patterns --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/flyio-sdk-patterns .claude/skills/flyio-sdk-patterns && 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
flyio-sdk-patterns
GitHub stars
2.8k
Token cost
~1.2k tokens
SKILL.md length
505 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Build a typed local adapter for the Fly.io Machines REST API with scoped auth, state waits, limits, reconciliation, and contract tests.

  • Works in 6 steps: Freeze the contract → Define a thin transport → Model desired and observed state → …
  • Code must manage Machines
  • SKILL.md covers Overview, Prerequisites, Instructions and Authentication, plus 5 more sections
  • Needs FLY_API_TOKEN

What it does

Flyio SDK Patterns is an agent skill from jeremylongshore/tons-of-skills-marketplace. Build a typed local adapter for the Fly.io Machines REST API with scoped auth, state waits, limits, reconciliation, and contract tests. Use when code must manage Machines or volumes. Trigger with: "wrap Machines API", "build Fly API client", "type Fly Machine states".

Its SKILL.md is about 1.2k 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 the current Machines OpenAPI contract, a supported runtime, a scoped test identity, fixtures, and a non-production integration boundary.

It sits in Backend & APIs, covering Integration testing, Accounting and bookkeeping and REST APIs. 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

  • Code must manage Machines
  • With: wrap Machines API
  • Build Fly API client
  • Type Fly Machine states

Example prompts

  • “wrap Machines API”
  • “build Fly API client”
  • “type Fly Machine states”
  • “/flyio-sdk-patterns”

Requirements

  • A credential in FLY_API_TOKEN
  • Compatibility (from SKILL.md): Requires the current Machines OpenAPI contract, a supported runtime, a scoped test identity, fixtures, and a non-production integration boundary.
  • Pre-approved tools (allowed-tools): Read, Grep, Write, Edit

Workflow steps

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

  1. Freeze the contract
  2. Define a thin transport
  3. Model desired and observed state
  4. Use the provider wait operation
  5. Apply rate and conflict policy
  6. Test the adapter

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):

    • fly.io
    • docs.machines.dev

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FLY_API_TOKEN

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

  • Compatibility

    Requires the current Machines OpenAPI contract, a supported runtime, a scoped test identity, fixtures, and a non-production integration boundary.

    From compatibility in the SKILL.md frontmatter.

Context cost

Flyio SDK Patterns loads about 1.2k tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 72 tokens; SKILL.md has 505 words of instructions outside code blocks.

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

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). 505 words, ~1,228 tokens.

Download SKILL.mdSave it as .claude/skills/flyio-sdk-patterns/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
flyio-sdk-patterns
description
Build a typed local adapter for the Fly.io Machines REST API with scoped auth, state waits, limits, reconciliation, and contract tests. Use when code must manage Machines or volumes. Trigger with: "wrap Machines API", "build Fly API client", "type Fly Machine states".
allowed-tools
Read, Grep, Write, Edit
compatibility
Requires the current Machines OpenAPI contract, a supported runtime, a scoped test identity, fixtures, and a non-production integration boundary.
version
2.0.0
argument-hint
[language-app-and-operation-set]
model
inherit
effort
high
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, flyio, machines-api, typed-client, contract-testing

Typed Fly.io Machines API Adapter

Overview

Fly.io publishes a REST API and OpenAPI reference; this workflow does not claim a provider-maintained JavaScript SDK. Generate or handwrite only a thin local adapter, keep provider fields visible, and centralize authentication, timeouts, limits, state waits, and redaction.

Prerequisites

  • Chosen operations and current OpenAPI or endpoint documentation
  • Runtime and HTTP client policy, schema generator decision, and error model
  • Synthetic fixtures plus an authorized non-production app for contract verification

Instructions

Step 1: Freeze the contract

Record base URL, operation paths, request and response schemas, state enums, response codes, and retrieval fingerprint. Preserve unknown fields for forward compatibility.

Step 2: Define a thin transport

Centralize bearer auth, content type, request ID, timeout, retry eligibility, response parsing, and error redaction. Do not hide target app or Machine identifiers.

Step 3: Model desired and observed state

Represent Machine ID, instance version, configuration, lifecycle state, and target state separately. Require callers to reconcile before replay.

Step 4: Use the provider wait operation

After a mutation, wait for started, stopped, suspended, or destroyed with a bounded timeout and the required instance version where applicable.

Step 5: Apply rate and conflict policy

Serialize conflicting actions per identifier, use documented per-action limits, retry only eligible failures, and refresh after 409, 408, or ambiguous transport results.

Step 6: Test the adapter

Use fixture tests for every response and error class, then run an authorized read and one reversible non-production lifecycle operation with cleanup.

Authentication

Inject FLY_API_TOKEN from a secret manager and send it only as the bearer header to the documented Machines API host. Keep token scope outside the client configuration file and scrub headers and Machine config secrets from exceptions.

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

Tool Discipline

Use Read and Grep to inspect application configuration, deployment evidence, provider documentation, fixtures, logs, schemas, and existing tests before proposing a change. Use Write or Edit only for an approved plan, configuration, implementation, test, or redacted receipt. Do not create, deploy, scale, restart, stop, suspend, destroy, rotate, revoke, expose, or migrate live Fly.io resources without explicit operator approval.

Output

  • Contract fingerprint and supported-operation matrix
  • Typed adapter with transport, state, rate, conflict, and redaction policies
  • Fixture and non-production contract-test receipt with cleanup state

Return the target organization, app, environment, region set, Machine or database identifiers, source-contract fingerprint, evidence, unresolved risks, rollback state, and final decision without exposing tokens, secrets, connection strings, or customer data.

Examples

A TypeScript service wraps get, update, start, stop, and wait without inventing an official SDK. It records the active instance version, waits for the documented target states, serializes actions per Machine, and preserves unknown response properties.

Error Handling

FailureResponse
Response schema changesQuarantine the unknown shape, preserve raw redacted evidence, update fixtures and types, and re-run contract tests.
Wait returns 408Read current Machine and instance state; do not assume the preceding mutation failed.
Adapter receives 401Stop, verify the secret reference and token scope, and never print the bearer value.

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/flyio-sdk-patterns of jeremylongshore/tons-of-skills-marketplace.

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

Open the folder on GitHubat commit cfae287

Compare with similar skills

Flyio SDK Patterns 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.

Flyio SDK Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flyio SDK Patterns this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.2kAutomated safety check: PassMIT
Databricksrocky-data/rocky304—~2kAutomated safety check: PassApache-2.0
Hybrid Cloud Test Gengetsentry/sentry46k—~2.6kAutomated safety check: PassCustom licence
Binance Datatoollostleaf/binance-datatool148—~2.5kAutomated safety check: NotesBSD-3-Clause
Trust Wallet APItrustwallet/tw-agent-skills106—~424Automated safety check: PassMIT
Bankr SignalsaAAaqwq/AGI-Super-Team1052 repos~3.3kAutomated safety check: PassMIT

Similar skills

  • Databricks

    rocky-data/rocky

    Databricks REST API and SQL reference for Rocky's warehouse adapter.

    304 GitHub stars~2k tokensUpdated today
    Backend & APIsAuto-check passed

  • Hybrid Cloud Test Gen

    getsentry/sentry

    Official

    Generate hybrid cloud tests for the Sentry codebase. An agent skill from getsentry/sentry.

    46k GitHub stars~2.6k tokensUpdated today
    Backend & APIsAuto-check passed

  • Binance Datatool

    lostleaf/binance-datatool

    Manage Binance historical market data from data.binance.vision using the binance-datatool CLI.

    148 GitHub stars~2.5k tokensUpdated 5 mo ago
    Backend & APIsAuto-check: notes

  • Trust Wallet API

    trustwallet/tw-agent-skills

    Trust Wallet API for crypto data — token search, prices, trending tokens, swap quotes, market data, security checks, address validation, asset info, and coin status across 100+ blockchains.

    106 GitHub stars~424 tokensUpdated 4 mo ago
    Backend & APIsAuto-check passed

  • Bankr Signals

    aAAaqwq/AGI-Super-Team

    Transaction-verified trading signals on Base blockchain. An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub starsUsed in 2 repos~3.3k tokens
    Backend & APIsAuto-check passed

  • Route Tester

    blencorp/claude-code-kit

    Framework-agnostic HTTP API route testing patterns, authentication strategies, and integration testing best practices.

    106 GitHub stars~3k tokensUpdated 10 mo ago
    Backend & APIsAuto-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

Categories

Questions about Flyio SDK Patterns

What does Flyio SDK Patterns do?

Build a typed local adapter for the Fly.io Machines REST API with scoped auth, state waits, limits, reconciliation, and contract tests. Flyio SDK Patterns is an agent skill from jeremylongshore/tons-of-skills-marketplace.io Machines REST API with scoped auth, state waits, limits, reconciliation, and contract tests.

When should I use Flyio SDK Patterns?

Flyio SDK Patterns fits situations like: code must manage Machines; with: wrap Machines API; build Fly API client; type Fly Machine states.

How do I install Flyio SDK Patterns in Claude Code?

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

How do I install Flyio SDK Patterns in Codex?

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

Can I use Flyio SDK Patterns 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 flyio-sdk-patterns -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flyio-sdk-patterns, .gemini/skills/flyio-sdk-patterns, .github/skills/flyio-sdk-patterns and .opencode/skills/flyio-sdk-patterns in your project.

What does Flyio SDK Patterns need to run?

Going by SKILL.md and its folder, Flyio SDK Patterns needs credentials named FLY_API_TOKEN. Our summary lists: A credential in FLY_API_TOKEN. Its frontmatter pre-approves these tools: Read, Grep, Write, Edit. Compatibility (from SKILL.md): Requires the current Machines OpenAPI contract, a supported runtime, a scoped test identity, fixtures, and a non-production integration boundary..

Does Flyio SDK Patterns access the network?

SKILL.md names 2 domains. As links in the text: fly.io and docs.machines.dev. This is read from the text; nothing was executed.

Is Flyio SDK Patterns 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 Flyio SDK Patterns use?

Flyio SDK Patterns 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 Flyio SDK Patterns use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 500 tokens, read only when the agent opens those files.

What are the alternatives to Flyio SDK Patterns?

Skills that share tags, products or a category with Flyio SDK Patterns: Databricks (rocky-data/rocky, 304 stars), Hybrid Cloud Test Gen (getsentry/sentry, 46k stars), Binance Datatool (lostleaf/binance-datatool, 148 stars) and Trust Wallet API (trustwallet/tw-agent-skills, 106 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flyio SDK Patterns?

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.