github-api

Provide type-safe GitHub REST and GraphQL API interfaces for Effect v4 applications.

2|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/spencerbeggs/effected --skill github-api-spencerbeggs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-api
Source: https://github.com/spencerbeggs/effected/tree/main/plugin/skills/github-api
Command: npx skills add https://github.com/spencerbeggs/effected --skill github-api-spencerbeggs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill eliminates the fragility of raw GitHub API calls by providing a type-safe, resilient, and composable interface for Effect v4 applications, preventing runtime errors and simplifying complex resource management.

Core Features & Use Cases

  • Type-Safe API Routing: Interact with GitHub REST and GraphQL endpoints using generated types that validate parameters and responses at compile time.
  • Resilient Resource Services: Manage Git branches, tags, pull requests, and check runs with built-in retry policies, pagination, and error classification.
  • Use Case: Automate complex CI/CD workflows, such as creating linked branches, managing PR comments, or performing atomic upserts of Git tags, without worrying about manual API casting or inconsistent error handling.

Quick Start

Use the github-api skill to fetch the default branch of the repository configured in the current environment.

Frequently Asked Questions about github-api

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

FAQPage Schema
How do I automate GitHub API calls in TypeScript without runtime errors?▼

Automate GitHub API calls in TypeScript by using a type-safe interface that validates parameters and responses at compile time, eliminating the fragility of raw API requests and preventing runtime errors.

Does this GitHub integration support Effect v4 applications?▼

Yes, this GitHub integration is specifically designed for Effect v4 applications, providing a composable interface that handles schema-validated requests and centralized error classification within the Effect ecosystem.

What is the best way to manage complex GitHub repository operations like branches and pull requests?▼

The best way to manage complex repository operations like branches, tags, and pull requests is through resilient resource services that provide built-in retry policies, automated pagination, and consistent error handling.

How do I handle GitHub API pagination and error classification in a CI/CD workflow?▼

Handle GitHub API pagination and error classification in a CI/CD workflow by leveraging built-in automated pagination and centralized error classification, ensuring robust management of check runs and pull request comments.

Can I interact with both GitHub REST and GraphQL endpoints using a single type-safe interface?▼

Yes, you can interact with both GitHub REST and GraphQL endpoints using generated types that validate parameters and responses at compile time, ensuring robust integration across both API protocols.

Why should I use a schema-validated interface instead of raw GitHub API calls for DevOps automation?▼

Schema-validated interfaces prevent the fragility of raw GitHub API calls by validating requests and responses at compile time, simplifying complex resource management and ensuring consistent error handling for DevOps automation.