How does this skill improve my workflow?

It streamlines development by providing established patterns for API interaction. This helps you generate type-safe code from OpenAPI specs, create reusable SWR hooks, and correctly implement complex authentication flows like CSRF tokens and pagination.

What does the Platform API Integration skill do?

This skill guides Claude in discovering and integrating with Rubin Science Platform (RSP) APIs. It covers exploring OpenAPI specifications, implementing authentication for services like Gafaelfawr, and creating robust SWR-based data-fetching hooks.

When should I use this skill?

Use this skill when you need to find API documentation for RSP services, implement new API integrations, create TypeScript types from API schemas, or set up authentication and mock APIs for local development.

What key capabilities does this skill provide?

It provides capabilities for discovering APIs via OpenAPI, implementing authentication for Gafaelfawr (CSRF tokens) and Times Square (cookies), creating SWR hooks for data fetching, polling, and pagination, and generating TypeScript types from API schemas for improved safety.

Platform API Integration

Name: Platform API Integration
Author: lsst-sqre

bylsst-sqre

•

API Development

Integrates with Rubin Science Platform (RSP) APIs by leveraging OpenAPI specifications for authentication, notebook execution, and frontend development.

Provides a comprehensive guide for discovering, exploring, and integrating with Rubin Science Platform (RSP) APIs. This skill uses OpenAPI specifications as a single source of truth for understanding endpoints, request/response schemas, and authentication requirements for services like Gafaelfawr (auth) and Times Square (notebooks). It outlines standardized patterns for creating TypeScript types, implementing SWR-based data-fetching hooks, handling CSRF tokens, and establishing a robust local development workflow with mock APIs, making it essential for building frontend features that interact with the RSP backend.

Key Features

01Implementing authentication patterns for Gafaelfawr (CSRF tokens) and Times Square (cookies)

02Discovering and exploring APIs using OpenAPI specifications

03Creating robust, reusable SWR-based hooks for data fetching, polling, and pagination

04Generating TypeScript types directly from API schemas for improved type safety

052 GitHub stars

06Establishing a local development workflow using mock APIs and Next.js rewrites

Use Cases

01Developing a component to display and monitor the status of a rendered notebook from the Times Square API.

02Building a new UI to manage user authentication tokens via the Gafaelfawr API.

03Setting up a local development environment to work on frontend features without requiring a live backend connection.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lsst-sqre/squareone platform-api-integration

For use in Claude.ai and ChatGPT

Download Skill