swamp-extension-model

Create custom Swamp TypeScript models with Zod schemas for external APIs and defined methods.

530|41|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/systeminit/swamp --skill swamp-extension-model
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swamp-extension-model
Source: https://github.com/systeminit/swamp/tree/main/.claude/skills/swamp-extension-model
Command: npx skills add https://github.com/systeminit/swamp --skill swamp-extension-model

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows users to create custom model types in TypeScript for Swamp, enabling integration with any API or service not covered by built-in models.

Core Features & Use Cases

  • Custom Integrations: Define new model types to interact with any external API or service.
  • Structured Data: Use Zod schemas to define inputs, outputs, and resource schemas for type safety.
  • Use Case: You need to manage resources in a proprietary internal system that has a REST API. You can create a custom Swamp model to interact with this API, defining its methods and data structures.

Quick Start

Create a new TypeScript model file named extensions/models/my_model.ts with the provided example code.

Frequently Asked Questions about swamp-extension-model

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom TypeScript model for an external API integration?

To create a custom TypeScript model for an API integration, define a new TypeScript file in your extensions directory and use Zod schemas to structure the inputs, outputs, and resource schemas for deterministic execution.

What is the best way to define structured data for custom integrations in TypeScript?

Defining structured data for custom integrations requires using Zod schemas to establish type safety, allowing you to validate inputs, outputs, and resource definitions before executing API calls.

Can I define global arguments and execution logic for deterministic tasks in TypeScript?

Yes, you can define global arguments, resources, files, and execution logic within a TypeScript model to ensure tasks execute deterministically across external systems.

Does Swamp support adding custom model types for proprietary REST APIs?

Swamp supports adding custom model types for proprietary REST APIs by enabling users to define custom TypeScript models that specify the methods and data structures needed to interact with external services.

When do I need to use Zod schemas for model development?

You need to use Zod schemas for model development when creating custom integrations that require strict type safety for inputs, outputs, and resource schemas to interact reliably with external APIs.