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.